模型

由于模型文件均捆绑在每个体验中，且可能包含机密信息，因此建议您确保这些捆绑文件不会泄露应予以保护的知识产权信息。

属性名称

JavaScript

类型

说明

资源

src

resource url

用于模型的资源的路径。有关受支持格式的详细信息，请参阅支持的 CAD 文件格式。

比例

scale

string

模型的比例。

X 坐标

x

number

模型在 X 轴上的位置。

Y 坐标

y

number

模型在 Y 轴上的位置。

Z 坐标

z

number

模型在 Z 轴上的位置。

X 旋转

rx

number

模型绕着 X 轴旋转的角度。

Y 旋转

ry

number

模型绕着 Y 轴旋转的角度。

Z 旋转

rz

number

模型绕着 Z 轴旋转的角度。

遮蔽

occlude

boolean

如果设置为“true”，则小组件的几何体会消失，但同时在 3D 场景中也会遮蔽任何其他增强。

因此，背景或照相机的数据反馈会出现被遮蔽的小组件应该显示的位置上。此功能可用于隐藏周围的 3D 几何体来强调某些增强。

始终置顶

decal

boolean

更改模型的显示，使其始终位于顶部。

若选中此复选框，则模型永远不会被其他增强信息所隐藏。

不透明度 (1 不透明 - 0 透明)

opacity

number

介于 0 和 1 之间的数字，用于控制对象的透明度级别。0 = 完全透明，1 = 完全不透明。如果设置为半透明 (例如，不透明度设置为 <1)，则可控制将模型绘制为透明外壳 (默认)，还是完全透明。

当前步骤

currentStep

number

活动序列的当前步骤 (如果已为模型指定了任何步骤)。

正在播放

playing

boolean

正在播放序列时为 true。

序列列表

sequenceList

info table

信息表，提供模型的可用序列列表。信息表包含 name 和 filename 列。绑定到小组件 (例如:“重复器”、“列表”或“选择”小组件) 时，可以轻松地更改具有多个序列的模型的序列。

序列

sequence

resource url

启用的动画序列的路径。如果在“资源”属性中选择了 .pvz 文件，则此下拉列表将被可用的 .pvi 文件自动填充。两个序列不得同时运行。

支持由 Creo Illustrate 8.1 及更低版本创建的序列。

“在设计时应用序列”

showSequenceInCanvas

boolean

影响模型在设计时在 Vuforia Studio 的外观。在选中此复选框并选择一个序列后，该序列的初始步骤直接在设计视图中应用。若未选中此复选框，则模型将以其默认状态显示。

步骤

steps

number

启用的序列中的步骤总数。

服务名称	JavaScript	说明
下一步	forward	移动到序列中的下一个步骤。
播放	play	从当前位置播放序列。
全部播放	playAll	从当前位置播放序列，不在步骤之间停止。
重置	reset	将视图中的所有模型重置为第一步。
倒回	rewind	将序列回退一个步骤。
停止	stop	将序列停止在当前位置。

事件

JavaScript

说明

播放已开始

playstarted

当序列中的步骤开始播放时，将触发此事件。

播放已停止

playstopped

当序列中的步骤停止播放时，将触发此事件。传递数据对象参数，提供有关步骤的信息。

模型已加载

modelLoaded

当模型完全加载时，将触发此事件。

确认已请求

acknowledgeRequested

当在序列期间请求确认时，将触发此事件。

使用 JS 表达式框为确认创建自定义交互。

要覆盖所有其他可见性设置并隐藏与其相关的模型和所有项，请将小组件的以下任意一个属性绑定到模型，然后在“选择绑定目标”窗口中选择“强制隐藏”：

2D 小组件	属性
复选框	值
切换	值
切换按钮	• 已按下 • 未按下

这也会覆盖所选序列所设置的任何可见性。

使用时的必要步骤	显示效果
1. 将“模型”小组件拖放到工作区。 2. 在“资源”字段中，选择现有的 CAD 文件、添加新资源，或者输入您想要显示的文件的 URL。 3. 根据需要，将模型放置在工作区中。