空间目标

如果您想在不使用 ThingMark 的情况下将模型放置在某个平面上，会用到“空间目标”小组件。例如，如果您想现场向潜在客户展示发电机的外观，可在创建 AR 体验时使用空间目标。

• 在移动设备上查看空间追踪体验时，摇动手势会中断追踪并返回到放置模式。如果失去追踪，请摇动设备以重新建立追踪。

• 要在 HoloLens 上中断追踪，请说出“Hey View, update tracking”(嘿 View，更新追踪) 或点击模型附近菜单上的“重置”按钮。

• 具有空间追踪视图的体验只能在受支持的 iOS 和安卓设备上显示。有关受支持的设备的详细信息，请参阅 Vuforia Developer Library 中的Ground Plane: Prerequisites章节。

Vuforia View 可能没有使用 Vuforia 的 Ground Plane 技术的最新版本。因此，您的设备可能尚不支持 Vuforia View。

• 在体验的放置阶段，序列可能会干扰幻像效果。目前，幻像渲染应用于在 TML 中显式声明的所有模型和模型项。应用于模型的任何序列都将覆盖序列中所有模型项的渲染模式。如果序列中的模型项在 TML 中没有对应的模型项，则它不会呈现为幻像。对于带有序列的模型，最佳做法是等到放置完成后再设置模型的序列，并在丢失追踪时取消设置序列。在您点击屏幕离开放置模式之后，“追踪已获得”事件将被触发。当您摇动设备时，“追踪已丢失”事件将被触发。使用这两个事件可设置或删除任何模型中的序列。

• 必须在 Vuforia View 设置中启用了 ThingView 渲染器之后，才可观看采用了空间追踪的体验。

• 根据您的设备而定，空间追踪的内容可能会有所不同。

• 在 ARKit 设备上进行模型放置时，可能需要移动设备才能初始化追踪。

• 非 ARKit 设备与 ARKit 设备相比，3D 对象的稳定性可能会降低。

• 避免将 3D 对象放在单色表面、高度透明或反光的物体上 (例如，全白的桌子)。而应将单个或多个 3D 对象放置在有凸起、特征明显且带有纹理的表面上。

属性	JavaScript	类型	说明
X 坐标	x	number	空间目标在 X 轴上的位置。
Z 坐标	z	number	空间目标在 Z 轴上的位置。
已追踪	istracked	boolean	当照相机识别到目标时启用。
启用平移手势	enabletranslategesture	boolean	在体验中启用平移手势，并允许将场景四处移动。
启用旋转手势	enablerotategesture	boolean	在体验中启用旋转手势，并允许使用两根手指旋转场景。
启用缩放手势	enablescalegesture	boolean	在体验中启用缩放手势，并允许更改场景的大小。

服务	JavaScript	说明
重置手势更改	resetGesture	用手势移动 (移动、旋转和缩放) 元素后，将场景重置为其原始大小和位置。

事件	JavaScript	说明
追踪已获得	trackingacquired	当照相机识别到表面时，将触发此事件。增强信息包含目标（ID）和任何关联的元数据。
追踪已丢失	trackinglost	当照相机无法识别表面时，将触发此事件。增强信息包含目标（ID）和任何关联的元数据。

使用时的必要步骤

显示效果

1. 将“空间目标”小组件拖放到工作区。

2. 将想要显示的小组件拖放到体验中。在本示例中，我们加入了一个“模型”小组件。

3. 在“项目”窗格中的“配置” > “体验”下面，从“ThingMark 关联”下拉菜单中选择“无”。

4. 体验发布后，其将出现在您的体验库中。打开体验，将照相机朝着水平表面，然后点击屏幕放置模型。