跳转至

GFLogSink

API Reference / Standard / 类索引

  • 路径:addons/gf/standard/utilities/logging/gf_log_sink.gd
  • 模块:Standard
  • 继承:RefCounted
  • API:public
  • 类别:协议与扩展点 (protocol)
  • 首次版本:3.17.0

日志输出 sink 基类。 项目可以继承该类,把 GFLogUtility 的结构化日志条目写入 JSONL、 远端采集、编辑器面板或其他自定义目标。Sink 不拥有日志工具生命周期, 只响应 init/write/flush/shutdown 钩子。

成员概览

类型 名称 签名
方法 init func init(_owner: Object) -> void:
方法 write func write(_entry: Dictionary) -> void:
方法 flush func flush() -> void:
方法 shutdown func shutdown() -> void:

方法

init

  • API:public
func init(_owner: Object) -> void:

初始化 sink。

参数:

名称 说明
_owner 持有该 sink 的日志工具。

write

  • API:public
func write(_entry: Dictionary) -> void:

写入一条结构化日志。

参数:

名称 说明
_entry 日志条目字典。

结构:

  • _entry: Dictionary log entry produced by GFLogUtility.

flush

  • API:public
func flush() -> void:

刷新尚未写出的缓冲。

shutdown

  • API:public
func shutdown() -> void:

关闭 sink 并释放内部资源。