使用小组件 > 3D > 图像目标
  
图像目标
这个小组件有什么功能?
“图像目标”小组件用于将图像作为追踪方法。
何时会用到这个小组件?
图像目标有多种用途。例如,当您希望在产品使用环境中使用图像进行市场营销活动或可视化产品时,可以使用“图像目标”
* 
图像目标应当在适度明亮和扩散照明下使用。图像的表面应均匀亮起。
这个小组件中是否有专用的属性、服务、事件或操作?
若要查看小组件常用的属性、服务和事件的列表,请参阅小组件的通用属性、服务和事件
下表列出了该小组件的专用属性。
属性
JavaScript
类型
说明
图像
url
string
用于目标的图像资源的路径。
* 
此属性在运行时不可编辑。
使用的图像必须满足以下条件:
8 位或 24 位 PNG 或 JPG 文件
文件大小低于 2 MB
JPG 必须是 RGB 或灰度(无 CMYK)
任何一侧的像素数不超过 2024
比例不超过 3:1(任何一侧的长度不超过其他侧的 3 倍,即使图像不是矩形)
标记宽度
width
number
图像宽度。
该字段的值以米为单位。
X 坐标
x
number
“图像目标”在 X 轴上的位置。
Y 坐标
y
number
“图像目标”在 Y 轴上的位置。
Z 坐标
z
number
“图像目标”在 Z 轴上的位置。
X 旋转
rx
number
“图像目标”绕 X 轴的旋转。
Y 旋转
ry
number
“图像目标”绕 Y 轴的旋转。
Z 旋转
rz
number
“图像目标”绕 Z 轴的旋转。
已追踪
src
boolean
当照相机识别到目标时启用。
显示追踪指示符
src
boolean
如果选中此复选框,则会显示目标的绿色追踪轮廓,指示追踪正在进行中。
静止 (仅限“眼镜”项目)
src
boolean
如果目标处于稳定环境中,并且用户不会移动,请选中此复选框。选中此复选框可提高追踪性能。
事件
JavaScript
说明
追踪已获得
trackingacquired
当追踪建立时触发此事件。传递的参数是小组件 ID。
追踪已丢失
trackinglost
当追踪丢失时触发此事件。传递的参数是小组件 ID。
小组件的显示效果
以下是小组件的显示效果示例!
使用时的必要步骤
显示效果
1. “图像目标”小组件拖放到工作区中。
2. 单击“图像”字段旁边的 + 图标上载新的图像,或者从下拉菜单中选择一个。
3. “项目”窗格中的“配置” > “体验”下面,从“ThingMark 关联”下拉菜单中选择“无”