图像AR

图像 AR 对应 image2d-tracking 类型。

体验流程

典型流程如下：

1. 打开场景
2. 下载素材
3. 加载场景
4. 展示扫描引导
5. 相机识别到目标图后触发 tracked
6. 丢失目标图时触发 lostTrack

关键事件

图像 AR 场景最常用的几个事件是：

• ready
• downloadAssetProgress
• loadSceneEnd
• sceneStart
• tracked
• lostTrack

扫描 UI

你可以通过属性 hideScan 隐藏默认扫描 UI，然后在宿主层自己渲染引导。

如果场景中配置了自定义扫描图、扫描文案或下载识别图入口，Kivicube 默认UI会自动处理；宿主层完全自定义时，需要自行提供对应引导和实现。

陀螺仪模式

图像 AR 场景中还支持陀螺仪相关能力：

• 如果场景开启了陀螺仪，丢失追踪后可进入陀螺仪相关体验逻辑
• iOS 上这会额外涉及动作与方向权限

因此对 iframe 接入来说，仍然建议优先关闭陀螺仪功能。

自定义交互

图像 AR 场景通常会搭配：

• 自定义点击
• 拍照和预览
• 图片/全景图
• glTF模型

适合什么内容

• 识别海报、包装、画册、卡片
• 识别后出现 3D 模型、视频、动图等内容
• 品牌营销和展览导览

接入建议

1. 识别图尽量清晰、特征点丰富。
2. 宿主层最好提供明确的“请扫描目标图”提示。
3. 对 tracked / lostTrack 做可视化反馈，用户体验会明显更稳。