Kivicube文档

简体中文

English

主题

图像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 场景通常会搭配：

适合什么内容 ​

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

接入建议 ​

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