使用小组件 > 3D > 产品
产品
* 
此小组件仅适用于 Vuforia StudioExperience Service 10.0.0 及更高版本。
这个小组件有什么功能?
“产品”小组件可用于检索可复用资产,例如模型和模型目标,而无需编写任何代码。它会自动提取之前使用产品 API 在 Experience Service 上传和生成的产品特定数据,以便轻松地将动态内容集成到您的体验中。有关详情,请参阅Vuforia Studio 产品 API
何时会用到这个小组件?
在任何体验中使用“产品”小组件,以动态加载来自 Experience Service 的模型和模型目标。只需将“产品”小组件连接到“模型”小组件和“动态目标”小组件,即可确保在运行时无缝加载检索到的资产,无需编写脚本。
使用此小组件时,体验将遵循已定义的逻辑:
如果模型已被简化,则体验会自动检索“中”质量版本。
如果有多个模型目标可用,则体验会按照以下顺序优先加载最高的可用质量:高级、本地高级和标准。当同一质量层中存在多个版本时,将自动选择最新版本。
有关分步演练,请查看用例:动态加载和比较资产
这个小组件中是否有专用的属性、服务、事件或操作?
若要查看小组件常用的属性、服务和事件的列表,请参阅小组件的通用属性、服务和事件
* 
如果您不确定 Experience Service 的版本,请与管理员联系。
属性名称
JavaScript
类型
说明
产品 ID
productID
string
产品的产品 ID。
版本
version
string
指定产品的版本。一个产品可以有多个版本。如果未提供任何版本,则默认使用最新的可用版本。
* 
“最新”是指最近创建的版本,而不一定是具有最高版本号的版本。
模型
modelUri
string
产品的模型资源 URL。(.pvz 文件)
目标
targetUri
string
产品的目标资源 URL。(.dat 文件)
* 
“产品”小组件用于根据产品 ID 和可选版本加载和显示产品数据。如果同时提供了产品 ID 和版本,小组件将加载产品的特定版本。如果仅提供产品 ID 并将版本留空,则小组件将自动加载产品的最新版本。
事件
JavaScript
说明
产品已加载
productLoaded
成功检索到产品相关 URL 后触发。要检测模型何时完全加载,请使用“模型目标”小组件的 modelLoaded 事件。
产品失败
productFailed
产品加载失败时触发。
* 
如果找不到您提供的产品 ID 或产品 Id-版本组合,将触发 Product Failed 事件。此事件不会在用户界面中自动显示错误消息。作为体验作者,您负责处理此事件,并为体验创建任何必要的错误通知或后退行为。这样,您可以完全控制如何将缺失的产品数据传达给您的用户。
示例用例
请参阅以下用例:
这对您有帮助吗?