XCEngine/docs/api/XCEngine/Scripting/ScriptEngine/OnRuntimeStop.md

ScriptEngine::OnRuntimeStop

命名空间: XCEngine::Scripting

类型: method

头文件: XCEngine/Scripting/ScriptEngine.h

签名

void OnRuntimeStop();

当前实现流程

• 如果订阅了场景创建事件，会先退订并处理退订队列。
• 若当前并未运行：
  • 清空 m_runtimeScene
  • 清空跟踪状态和顺序表
  • 返回
• 若正在运行：
  • 遍历所有跟踪脚本，调用 StopTrackingScript(..., true)
  • 清空状态表与顺序表
  • 把 m_runtimeRunning 置为 false
  • 清空 m_runtimeScene
  • 最后调用 m_runtime->OnRuntimeStop(stoppedScene)

当前真实语义

StopTrackingScript() 会在实例存在时按 OnDisable -> OnDestroy -> DestroyScriptInstance 清理，因此这不是简单停更，而是完整结束脚本运行态。

相关文档

• OnRuntimeStart
• OnScriptComponentDestroyed