文档

互动(逻辑节点)

逻辑决定了您的 AR 体验如何做出反应。在“节点”面板中,把事件(发生的事)连接到动作(要做的事)即可,无需编写代码。

工作原理

每个节点都是一张卡片。在两个节点的圆点之间拖出一条连线,把事件节点的输出连接到动作节点的输入。事件触发后,相连的动作就会运行——您还可以把多个动作依次串联起来。

把事件连到动作:这里点击对象就会播放动画。

右键单击画布(或使用节点面板)即可添加节点。节点按颜色区分——事件为琥珀色,动作为天蓝色。

要同时操作多个节点,可按住 Shift 并在画布空白处拖动进行框选,或按住 Shift 点击(按住 Ctrl/Cmd 点击同样有效)将节点加入选择。选中的节点可以一起拖动,按 Delete 键即可将其删除——右键菜单中也有相同的“删除”选项。

事件

事件触发时机
场景开始时场景首次出现时(找到目标,或通过“跳转到场景”进入该场景)。
点击时用户点击您所选的对象(可以是 3D 对象,也可以是屏幕上的 UI 叠加层元素)。
碰撞时您所选的两个对象相互接触——详见下方的碰撞。
手部触碰时 / 手部触碰结束时手或手指开始或停止触碰您所选的可交互对象——详见手部交互与物理。
抓取时 / 松开时您所选的可交互对象被拿起或松开。

动作

动作作用
跳转到场景切换到另一个场景,可选择过渡效果(淡入淡出、缩放弹出、上滑、旋转)并设置时长。
播放声音以滑块设定的音量播放已导入的音频(可选择循环播放)。开始时输出会立即运行;声音结束后会在声音播放到结尾时运行(循环时不会运行;如果先停止声音、重新播放同一音频或切换场景,它也不会运行)。
停止声音停止正在播放的声音——所选音频的每一个正在播放的实例都会停止并倒回开头。
播放视频以设定的音量(0 为静音)和速度开始播放所选的视频对象,可选择是否循环。开始时会立即运行;视频结束后会在视频播放到结尾时运行(循环时不会运行;如果先停止视频、在同一对象上重新播放或切换场景,它也不会运行)。在点按前阻止声音的浏览器中会静音播放。
停止视频停止所选的视频对象,并将其倒回开头。
播放动画在对象上播放一个动画片段(关键帧片段或模型自带的动画)。开始时输出会立即运行。动画结束后会在片段播放到结尾时运行:循环片段永远不会触发;如果先发生了停止动画、对同一对象的另一个播放动画或切换场景,它也不会运行。
停止动画停止正在播放的动画,并让它定格在当前位置。
显示对象 / 隐藏对象显示或隐藏某个对象。
淡入淡出在你设定的秒数内淡入或淡出对象。淡入会显示对象并将其提升到它自己的不透明度(检查器中的不透明度)。淡出会让它完全透明,然后将其隐藏,之后就无法再点按它。连接到其输出的内容会在淡入淡出完成后运行。同一对象上较新的淡入淡出会从当前状态接着进行。
延迟等待指定的秒数后,再运行链条中的下一个动作。
设置物理 / 设置可交互为启用碰撞的对象打开或关闭重力,或打开或关闭触碰和抓取。
设置可推动允许或禁止张开的手推动启用了碰撞和物理的对象。
推动对象推一下启用物理的对象。
重置对象把对象放回场景开始时的位置,并让它静止。

说明

声音和视频不会在所属场景结束后继续播放:当 AR 体验通过跳转到场景切换到另一个场景时,所有仍在播放的内容(包括循环播放的声音)都会自动停止。

一个完整示例

要让对象在被点击时出现、播放声音、稍作等待,然后跳转到下一个场景:

  1. 添加一个点击时节点,并选择对象。
  2. 将它依次连接到显示对象 → 播放声音 → 延迟(2 秒)→ 跳转到场景。

变量、算术与逻辑

再加上三类节点,您就能搭建更智能的行为——记录得分、做运算或作出判断。节点面板把它们归入可折叠的标题下,暂时用不到时可以收起。

变量是 AR 体验在运行时可以记住并修改的命名值,比如得分、计数器或开/关状态。请在左侧的变量面板中创建变量:为每个变量设置名称、类型(数字、文本或真/假)和初始值。变量可以是仅限本场景的(每次所属场景开始时重置),也可以是全局的(在整个使用过程中跨场景共享)。

这些类别会用到两种连线:

  • 流程连线(与之前相同)决定接下来运行什么。
  • 值连线把数字、文本或真/假值从一个节点的输出传递到另一个节点的输入——下方以蓝色显示。
数据连线(蓝色)把数据送入节点;这里每点击一次,得分就加 1。
类别节点
变量设置变量(把值存入变量)和获取变量(读取变量的当前值)。
运算符值(固定值)、算术(加/减/乘/除/取余)、比较(等于、小于、大于等条件 → 真/假)以及与/或/非。
逻辑如果(运行“真”分支或“假”分支)、条件循环(条件成立时反复执行)以及计数循环(从起始值数到结束值)。

要在屏幕上显示变量,请在 UI 叠加层中添加一个文本元素,并设置其显示变量(实时)选项——该文本会显示变量的值,并在值变化的瞬间更新,非常适合做实时得分。

说明

变量的修改,以及“如果”“条件循环”“计数循环”的判断,都会在逻辑运行时立即发生。延迟只会推迟它之后的动作,不会推迟变量的设置或条件的检查。循环还设有安全上限,因此 AR 体验不会卡死。

碰撞:两个对象接触时

当两个对象相互碰到时,会触发碰撞时事件。

  1. 选中每个对象,在属性面板中打开碰撞——两个对象都必须开启。
  2. 添加一个碰撞时节点,并选择对象 A 和对象 B。
  3. 把它连接到想要发生的任何动作,比如播放声音、改变得分或切换场景。
两个可碰撞对象的碰撞框接触时,“碰撞时”只触发一次。

当两个对象的碰撞框首次重叠时,它会触发一次;只有在两者分开至少四分之一秒后再次接触,才会再次触发。所以一直把它们挨在一起,或者一个对象碰到另一个时短暂弹起或晃动,都不会重复触发。A 和 B 的顺序无关紧要。碰撞仅适用于 3D 场景对象,不适用于屏幕上的 UI 叠加层元素。

一旦您修改了对象的边界(改为网格以外的任何类型),对象的碰撞框就会跟随边界;否则跟随对象的绘制外形。打开了地面的平面始终算作实体,因此碰撞时节点也可以选择它。

说明

如果您删除了某个节点所指向的对象或场景,AR Works 会清除该引用,并在节点上显示警告标记,这样一眼就能看出该节点需要重新指定,而不是悄无声息地什么也不做。

提示

使用预览可立即测试您的逻辑——直接在浏览器中点击对象即可。