使用小组件 > 3D > 模型目标
  
模型目标
* 
有关模型目标的最佳做法和故障排除的信息,请参阅以下主题:
这个小组件有什么功能?
“模型目标”小组件可使用 3D 模型来追踪体验中的物理对象。
* 
为了正确跟踪模型目标,Vuforia Studio 中模型的比例大小必须与物理对象的实际大小相匹配。如果导入的 3D 模型与对象的物理尺寸不匹配,请使用“模型”小组件上的“比例”属性对其进行调整。
何时会用到这个小组件?
在运行时,模型目标可用于通过将其与 3D 表示进行比较来识别物理对象,并显示 3D 增强,而不需要借助产品上的任何物理标记。
这个小组件中是否有专用的属性、服务、事件或操作?
若要查看小组件常用的属性、服务和事件的列表,请参阅小组件的通用属性、服务和事件
如果正在运行 Vuforia StudioExperience Service 9.13.0 或更高版本,下表列出了特定于此小组件的只读属性、服务和事件。有关 JavaScript 属性和 API 的信息,请参阅Model Target Web API
* 
如果您不确定 Experience Service 的版本,请与管理员联系。
属性名称
说明
配置模型目标
用于配置模型目标。有关详细信息,请参阅配置模型目标
模型目标类型
配置模型目标后,模型目标的类型将显示在此处。
“标准”- 适合必须从单个角度识别的对象
“高级”- 适合可从任何角度(360 度)识别的对象
* 
高级模型目标仅适用于已申请为 Experience Service 启用高级模型目标的 PTC 客户。如果您是 PTC 云客户,并且希望创建申请,请提交支持问题,从“产品”字段中选择 Vuforia Studio,然后从“是否要通过 PTC Cloud Services 提交问题?”下拉菜单中选择“是 - 请求在 PTC Cloud 环境上的活动(刷新、构建、访问、升级等)或信息”。如果您是本地部署客户,请参阅申请高级模型目标生成
有关标准和高级模型目标的详细信息,请参阅标准和高级模型目标
优化追踪 -
配置模型目标后,选定的优化类型将显示在此处。
将显示“默认值”“特征不明显物体”
外观
配置模型目标后,选定的外观类型将显示在此处。
几何简化
配置模型目标后,模型是否进行了简化将显示在此处。
已追踪
当照相机识别到目标时启用。
模型小组件 ID
相关模型的 ID。
事件
JavaScript
说明
追踪已获得
trackingacquired
跟踪启动时触发此事件。
追踪已丢失
trackinglost
当追踪丢失时触发此事件。
如果正在运行 Vuforia StudioExperience Service 9.12.0 或更低版本,下表列出了特定于此小组件的属性、服务和事件。
* 
如果您不确定 Experience Service 的版本,请与管理员联系。
属性名称
JavaScript
类型
说明
初始追踪位置
detectionPosition
json
允许您设置模型的初始追踪位置。
模型目标类型
modelTargetType
string
配置模型目标后,模型目标的类型将显示在此处。
“标准”- 适合必须从单个角度识别的对象
“高级”- 适合可从任何角度(360 度)识别的对象
* 
高级模型目标仅适用于已申请为 Experience Service 启用高级模型目标的 PTC 客户。
如果您是 PTC 云客户,并且希望创建申请,请提交支持问题,从“产品”字段中选择 Vuforia Studio,然后从“是否要通过 PTC Cloud Services 提交问题?”下拉菜单中选择“是 - 请求在 PTC Cloud 环境上的活动(刷新、构建、访问、升级等)或信息”
如果您是本地部署客户,请参阅申请高级模型目标生成
有关标准和高级模型目标的详细信息,请参阅标准和高级模型目标
物体是静态
* 
此属性在 3D 眼镜项目中不可用。
staticModeStr
boolean
如果体验中实际物体静止不动,请选中此复选框。例如,汽车和大型机械。
当此设置和“物体具有闪亮表面”设置均启用时,将会增强对具有反射表面的较大物体的追踪,并采用 AI 追踪技术,这可以大大提高追踪质量和稳定性(只要物体不移动)。
物体具有闪亮表面
carModeStr
boolean
当体验中的物理模型为汽车外部或类似的高反射大型物体时,请选中此复选框。启用此属性可优化追踪性能,减少某些情况下导致 CPU 负载过大的偏离。
已追踪
istracked
boolean
当照相机识别到目标时启用。
模型小组件 ID
model
string
相关模型的 ID。
事件
JavaScript
说明
追踪已获得
trackingacquired
当追踪建立时触发此事件。传递的参数是小组件 ID。
追踪已丢失
trackinglost
当追踪丢失时触发此事件。传递的参数是小组件 ID。