对应源文件: Log.lua
Log
作用域这里的 Log 指日志,如图所示:
在控制台输出的信息几乎是不可见的,但是日志中的信息是可见的,所以需要在日志输出信息。
在开发者工具中调整
至图示状态来启用日志,新地图创建时该按钮可能出于启用状态但日志并未开启,为了保证日志启用可以点击该按钮两次来刷新状态。
在玩法模式下按来打开日志窗口。
按清空日志。
Log
作用域包含以下静态函数:
以下函数都会返回一个 {boolean}
类型的变量, true
表示调用 API 成功,否则 false
表示调用 API 失败。
log(...)
在日志输出
...
。...
:{all}
输出的内容
使用"global"
作为标签。
格式化方式与 lua 基本函数print(...)
相同(使用tostring()
)。
等价于Log.logtag("global", ...);
。
logtag(tag, ...)
在日志以
tag
为标签输出...
。tag
:{string}
输出标签,如果不是string
类型那么函数行为会令人困惑。...
:{all}
输出内容,格式化方式与log()
相同。
warn(message)
在日志以
"warning"
为标签输出输出警告信息message
。message
:{string}
输出的警告信息。
与脚本内置的warn()
(通过Env.index("warn")
访问该函数) 函数不同的是,该函数会以黄色高亮显示警告。
error(message)
在日志以
"error"
为标签输出输出错误信息message
。message
:{string}
输出的错误信息。
与 lua 基本函数error()
不同的是,该函数不会抛出错误。
该函数会以红色高亮显示警告。
clear()
清空日志,效果和在控制台点击
按钮一样。
注意,该函数调用的 API 是不稳定的,如果在清空后没有通过一些方式刷新日志,则信息似乎仍然会存在。
这些函数都比较简单,就不举实例了,可自行测试效果。