路线查找器

使用时的必要步骤

1. 将“模型”小组件拖放到工作区。

2. 在“资源”字段中，选择现有的 CAD 文件、添加新资源，或者输入您想要显示的文件的 URL。

3. 根据需要，将模型放置在工作区中。

4. 将“路线查找器”小组件拖放到工作区中。

5. 请确保为“路线查找器”小组件设置了以下属性：

◦ “事件半径 (米)”- 在本例中，此属性设置为 0.5

◦ “路线查找器显示边界 (米)”- 在本例中，此属性设置为 1

◦ “自动前进”- 确保选中此复选框

启用“自动前进”将禁用“已离开”事件的使用。

◦ “已启用”- 请确保选中此复选框

6. 将“添加航点”图标 (

) 拖放到模型上的某个位置。

7. 放置航点后，可通过更改“友好名称”来更新标签。

8. 添加任何其他航点。

9. 在模型上具备所有航点后，如果需要，可以在项目树中对其重新排序。它们在项目树中出现的顺序决定了用户将被导向到航点的顺序。

10. 发布体验，然后在 Vuforia View 中查看。您将看到第一个航点出现。

属性名称

JavaScript 属性

说明

点状条带的颜色

ribbonColor

选择航点的点状条带的颜色：

• 橙色（默认值）

• 红色

• 绿色

• 蓝色

• 黄色

• 黑色

• 白色

• 洋红色

• 翠蓝色

请选择与模型或周围环境反差明显的颜色。

事件半径 (米)

eventRadius

默认情况下，此属性设置为 0.5。

当用户进入航点的事件半径时，即到达/离开该航点，并触发“已到达”或“已离开”事件。特定航点的“事件半径 (米)”可覆盖此属性。

路线查找器显示边界 (米)

wayfinderDisplayBoundary

默认情况下，此属性设置为 2。

若输入大于 0 的值，则十字线和功能区将被隐藏。要避免此行为，请将“路线查找器显示边界 (米)”设置为 0。特定航点的“路线查找器显示边界 (米)”属性可覆盖此属性。

自动前进

autoAdvance

此属性默认选中。若启用，则当用户进入航点的截止半径时，路线查找器将自动向前导航至下一个航点。

循环

looping

在最后一个航点显示后，使用户返回到数组中的第一个航点。

显示点带

showRibbon

此属性默认选中。若启用，“路线查找器”功能区将在设计和运行时显示。

显示航点

showWaypoints

此属性默认选中。若启用，航点将在设计和运行时显示。

显示标签

showLabels

此属性默认选中。若启用，标签将在设计和运行时显示。

标签居上

labelsOnTop

此属性默认不选中。若启用，标签将显示在其他对象之上，不会被遮蔽。

“已启用”

此属性将在运行时打开或关闭“路线查找器”。这包括可见性、事件日志记录、事件触发和服务。

显示瞄准线

showReticle

此属性默认不选中。若启用，将在运行时在屏幕中心显示瞄准线。

航点数据

waypointsData

索引为零的航点数组。

选定的航点索引

selectedWaypointIndex

当前选定航点的索引。

选定的航点数据

selectedWaypointData

当前选定航点的对象。

服务名称	JavaScript 服务	说明
下一个	next	导航至下一个航点。
上一个	previous	导航回到上一个航点。

事件名称	JavaScript 事件	说明
已到达	arrived	当用户到达航点截止半径时触发。
已离开	departed	当用户离开航点截止半径时触发。