文档
互动(逻辑节点)
逻辑决定了您的 AR 体验如何做出反应。在“节点”面板中,把事件(发生的事)连接到动作(要做的事)即可,无需编写代码。
工作原理
每个节点都是一张卡片。在两个节点的圆点之间拖出一条连线,把事件节点的输出连接到动作节点的输入。事件触发后,相连的动作就会运行——您还可以把多个动作依次串联起来。
右键单击画布(或使用节点面板)即可添加节点。节点按颜色区分——事件为琥珀色,动作为天蓝色。
要同时操作多个节点,可按住 Shift 并在画布空白处拖动进行框选,或按住 Shift 点击(按住 Ctrl/Cmd 点击同样有效)将节点加入选择。选中的节点可以一起拖动,按 Delete 键即可将其删除——右键菜单中也有相同的“删除”选项。
事件
| 事件 | 触发时机 |
|---|---|
| 场景开始时 | 场景首次出现时(找到目标,或通过“跳转到场景”进入该场景)。 |
| 点击时 | 用户点击您所选的对象(可以是 3D 对象,也可以是屏幕上的 UI 叠加层元素)。 |
| 碰撞时 | 您所选的两个对象相互接触——详见下方的碰撞。 |
| 手部触碰时 / 手部触碰结束时 | 手或手指开始或停止触碰您所选的可交互对象——详见手部交互与物理。 |
| 抓取时 / 松开时 | 您所选的可交互对象被拿起或松开。 |
动作
| 动作 | 作用 |
|---|---|
| 跳转到场景 | 切换到另一个场景,可选择过渡效果(淡入淡出、缩放弹出、上滑、旋转)并设置时长。 |
| 播放声音 | 以滑块设定的音量播放已导入的音频(可选择循环播放)。开始时输出会立即运行;声音结束后会在声音播放到结尾时运行(循环时不会运行;如果先停止声音、重新播放同一音频或切换场景,它也不会运行)。 |
| 停止声音 | 停止正在播放的声音——所选音频的每一个正在播放的实例都会停止并倒回开头。 |
| 播放视频 | 以设定的音量(0 为静音)和速度开始播放所选的视频对象,可选择是否循环。开始时会立即运行;视频结束后会在视频播放到结尾时运行(循环时不会运行;如果先停止视频、在同一对象上重新播放或切换场景,它也不会运行)。在点按前阻止声音的浏览器中会静音播放。 |
| 停止视频 | 停止所选的视频对象,并将其倒回开头。 |
| 播放动画 | 在对象上播放一个动画片段(关键帧片段或模型自带的动画)。开始时输出会立即运行。动画结束后会在片段播放到结尾时运行:循环片段永远不会触发;如果先发生了停止动画、对同一对象的另一个播放动画或切换场景,它也不会运行。 |
| 停止动画 | 停止正在播放的动画,并让它定格在当前位置。 |
| 显示对象 / 隐藏对象 | 显示或隐藏某个对象。 |
| 淡入淡出 | 在你设定的秒数内淡入或淡出对象。淡入会显示对象并将其提升到它自己的不透明度(检查器中的不透明度)。淡出会让它完全透明,然后将其隐藏,之后就无法再点按它。连接到其输出的内容会在淡入淡出完成后运行。同一对象上较新的淡入淡出会从当前状态接着进行。 |
| 延迟 | 等待指定的秒数后,再运行链条中的下一个动作。 |
| 设置物理 / 设置可交互 | 为启用碰撞的对象打开或关闭重力,或打开或关闭触碰和抓取。 |
| 设置可推动 | 允许或禁止张开的手推动启用了碰撞和物理的对象。 |
| 推动对象 | 推一下启用物理的对象。 |
| 重置对象 | 把对象放回场景开始时的位置,并让它静止。 |
说明
一个完整示例
要让对象在被点击时出现、播放声音、稍作等待,然后跳转到下一个场景:
- 添加一个点击时节点,并选择对象。
- 将它依次连接到显示对象 → 播放声音 → 延迟(2 秒)→ 跳转到场景。
变量、算术与逻辑
再加上三类节点,您就能搭建更智能的行为——记录得分、做运算或作出判断。节点面板把它们归入可折叠的标题下,暂时用不到时可以收起。
变量是 AR 体验在运行时可以记住并修改的命名值,比如得分、计数器或开/关状态。请在左侧的变量面板中创建变量:为每个变量设置名称、类型(数字、文本或真/假)和初始值。变量可以是仅限本场景的(每次所属场景开始时重置),也可以是全局的(在整个使用过程中跨场景共享)。
这些类别会用到两种连线:
- 流程连线(与之前相同)决定接下来运行什么。
- 值连线把数字、文本或真/假值从一个节点的输出传递到另一个节点的输入——下方以蓝色显示。
| 类别 | 节点 |
|---|---|
| 变量 | 设置变量(把值存入变量)和获取变量(读取变量的当前值)。 |
| 运算符 | 值(固定值)、算术(加/减/乘/除/取余)、比较(等于、小于、大于等条件 → 真/假)以及与/或/非。 |
| 逻辑 | 如果(运行“真”分支或“假”分支)、条件循环(条件成立时反复执行)以及计数循环(从起始值数到结束值)。 |
要在屏幕上显示变量,请在 UI 叠加层中添加一个文本元素,并设置其显示变量(实时)选项——该文本会显示变量的值,并在值变化的瞬间更新,非常适合做实时得分。
说明
碰撞:两个对象接触时
当两个对象相互碰到时,会触发碰撞时事件。
- 选中每个对象,在属性面板中打开碰撞——两个对象都必须开启。
- 添加一个碰撞时节点,并选择对象 A 和对象 B。
- 把它连接到想要发生的任何动作,比如播放声音、改变得分或切换场景。
当两个对象的碰撞框首次重叠时,它会触发一次;只有在两者分开至少四分之一秒后再次接触,才会再次触发。所以一直把它们挨在一起,或者一个对象碰到另一个时短暂弹起或晃动,都不会重复触发。A 和 B 的顺序无关紧要。碰撞仅适用于 3D 场景对象,不适用于屏幕上的 UI 叠加层元素。
一旦您修改了对象的边界(改为网格以外的任何类型),对象的碰撞框就会跟随边界;否则跟随对象的绘制外形。打开了地面的平面始终算作实体,因此碰撞时节点也可以选择它。
说明
提示