vrLogService

vrLogService

(继承 vrBaseService

提供对日志记录功能的访问权限的服务。

使用 setLogEnabled、setLogLevel 或 setLogType 函数临时更改日志记录行为时,请确保执行相应的还原调用。建议使用类似以下示例的 try 语句:

logEnabled = vrLogService.isLogEnabled()
vrLogService.setLogEnabled(False)
try:
    findNode("Name")
finally:
    vrLogService.setLogEnabled(logEnabled)

摘要

函数:

函数

vrLogService.error(message, context={})

添加新的错误日志消息。

错误消息通常以红色显示。

参数:
  • message (string) - 应添加到日志中的错误。
  • context (string) - 可选上下文字符串。将显示在消息前面的方括号中,例如 [Scenegraph] Node locked。

vrLogService.getLogType()
返回值:当前活动日志类型。
返回值类型:vrLogTypes.LogType

vrLogService.info(message, context={})

添加新的信息日志消息。

参数:
  • message (string) - 应添加到日志中的信息。
  • context (string) - 可选上下文字符串。将显示在消息前面的方括号中,例如 [Scenegraph] Node locked。

vrLogService.isLogEnabled()
返回值:如果启用日志记录,则为 True,否则为 False。
返回值类型:bool

vrLogService.setLogEnabled(value)

启用或禁用日志记录。

参数:value (bool) - 如果为 True,则启用日志记录。值为 False 将禁用日志记录。

vrLogService.setLogLevel(level)

设置日志级别。

日志级别定义在终端和日志文件中显示的日志消息类型。当前有三种不同类型的日志级别:“错误”、“警告”和“信息”。每个级别将输出指定类型以及更高严重性类型的消息。例如,日志级别“警告”也将输出错误。

参数:level (vrLogTypes.Level) - 用于输出的日志级别。

vrLogService.setLogType(type)

设置日志消息类型。

参数:type (vrLogTypes.LogType) - 应处于活动状态的消息类型。这也可以是类型的组合。

vrLogService.warning(message, context={})

添加新的警告日志消息。

警告消息通常以黄色显示。

参数:
  • message (string) - 应添加到日志的警告。
  • context (string) - 可选上下文字符串。将显示在消息前面的方括号中,例如 [Scenegraph] Node locked。