外观
事件与接口节点
事件节点是 Graph 的起点。它们监听场景状态、用户操作或界面消息，并在条件满足时启动后续动作。
On Scene Loaded
场景准备完成后触发一次，适合初始化相机、显示对象、播放动画或设置初始界面。
| 端口 | 方向 | 说明 |
|---|---|---|
onLoaded | 输出 | 场景加载完成事件 |
如果流程必须等模型和场景准备好后才能执行，应从这个节点开始。
On Object Click
当用户操作指定对象时触发。
输入
| 输入 | 说明 |
|---|---|
uuid | 目标对象识别码 |
enable | 是否启用监听 |
输出
| 输出 | 说明 |
|---|---|
clicked | 事件触发 |
uuid | 被操作对象的识别码 |
point | 3D 命中位置 |
screen | 屏幕坐标 |
button | 鼠标按键编号 |
mod | Ctrl、Shift 等辅助键状态 |
属性
- event：
click、pointerdown、pointerup或dblclick； - button：限制鼠标按键，
-1表示不限制； - debounce：防止短时间内重复触发。
Emit Interface Event
主动发送一个命名事件，用于连接 UI 组件、项目流程或其他 Graph。
| 端口 | 方向 | 说明 |
|---|---|---|
trigger | 输入 | 发送事件 |
eventName | 输入 | 事件名称 |
scopeUuid | 输入 | 可选的项目或对象范围 |
payload | 输入 | 随事件发送的数据 |
done | 输出 | 发送完成 |
message | 输出 | 已发送的事件内容 |
事件名称建议使用清晰、稳定的业务命名，例如 device:selected 或 panel:open。
On Interface Event
监听指定命名事件。
| 端口 | 方向 | 说明 |
|---|---|---|
eventName | 输入 | 要监听的事件名称 |
scopeUuid | 输入 | 可选的范围限制 |
enable | 输入 | 是否启用监听 |
received | 输出 | 收到事件 |
payload | 输出 | 事件数据 |
eventName | 输出 | 实际事件名称 |
scopeUuid | 输出 | 实际事件范围 |
message | 输出 | 完整事件内容 |
发送端和接收端的事件名称必须完全一致。需要区分不同对象时，再使用范围识别码。
常见连接
text
On Object Click.clicked
→ Emit Interface Event.trigger
→ 其他 Graph 的 On Interface Event.received
→ Set Camera View.trigger接口事件适合解耦
当一个 UI 按钮或对象点击需要驱动多个独立流程时，使用命名接口事件比把所有节点连接在一条长链中更容易维护。