Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

EngineDebugger¶

继承： Object

暴露内部调试器。

描述¶

EngineDebugger 处理编辑器与正在运行的游戏之间的通信。它会在运行游戏时激活，可以通过它收发消息，还负责管理性能分析器。

bool	has_capture ( StringName name )
bool	has_profiler ( StringName name )
bool	is_active ( )
bool	is_profiling ( StringName name )
void	profiler_add_frame_data ( StringName name, Array data )
void	profiler_enable ( StringName name, bool enable, Array arguments=[] )
void	register_message_capture ( StringName name, Callable callable )
void	register_profiler ( StringName name, EngineProfiler profiler )
void	send_message ( String message, Array data )
void	unregister_message_capture ( StringName name )
void	unregister_profiler ( StringName name )

bool has_capture ( StringName name )

如果存在具有给定名称的捕获，则返回 true，否则返回 false。

bool has_profiler ( StringName name )

如果存在具有给定名称的分析器，则返回 true，否则返回 false。

bool is_active ( )

如果调试器处于活动状态，则返回 true，否则返回 false。

bool is_profiling ( StringName name )

如果存在具有给定名称的分析器，并且该分析器处于活动状态，则返回 true，否则返回 false。

void profiler_add_frame_data ( StringName name, Array data )

使用给定的 name 和 data 调用分析器中的 add 可调用体。

void profiler_enable ( StringName name, bool enable, Array arguments=[] )

使用给定的 name 和 arguments 调用分析器中的 toggle 可调用体。会根据 enable 参数启用/禁用同一分析器。

void register_message_capture ( StringName name, Callable callable )

使用给定的名称 name 注册消息捕获。如果 name 为“my_message”则会为“my_message:”开头的消息调用给定的可调用体。

Callable 必须接受消息字符串和数据数组参数。如果消息和数据有效，则可调用体必须返回 true，否则返回 false。

void register_profiler ( StringName name, EngineProfiler profiler )

使用给定的名称 name 注册分析器。详情见 EngineProfiler。

void send_message ( String message, Array data )

发送消息，内容为给定的 message 和 data 数组。

void unregister_message_capture ( StringName name )

将具有给定名称 name 的消息捕获解除注册。

void unregister_profiler ( StringName name )

将具有给定名称 name 的分析器解除注册。