对应源文件: 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 是不稳定的,如果在清空后没有通过一些方式刷新日志,则信息似乎仍然会存在。
这些函数都比较简单,就不举实例了,可自行测试效果。