自研APP接入

运行环境

Requirements

---

接入方式对比

接入方式	优势	劣势
WebAR SDK	+ 能够支持更全面的系统版本 iOS 11+、Android 7+	+ 需要一定开发接入成本
系统 WebView	+ 开发接入成本较低	+ 需支持 iOS 14.3+ + 需 Android 5.0+，且系统 WebView 支持
浏览器组件	+ 开发接入成本低 + 支持 iOS 13+	/

---

注意事项

无论何种方式接入，WebView组件的 UserAgent 属性，不能改为非标准内容。

Kivicube 会使用行业标准方式，从 UserAgent 获取浏览器基础信息。 因此，一旦 UA 不标准，就会导致运行出现非预期效果，比如移动端访问被误判为 PC 端。

标准 UA 格式参考： User-Agent - HTTP | MDN

建议的 UA 处理方法： 在默认 UA 基础上，仅在末尾增加自己的关键词或标识信息。

示例：微信 WebView UA

• 微信完整 UA：Mozilla/5.0 (Linux; Android 15; wv) AppleWebKit/537.36 (KHTML, like Gecko)

  Version/4.0 Chrome/134.0.6998.136 Mobile Safari/537.36 XWEB/1340109 MMWEBSDK/20250201 MMWEBID/9925 MicroMessenger/8.0.58.2841(0x28003A3E)

  WeChat/arm64 Weixin NetType/WIFI Language/zh_CN ABI/arm64

• WebView 原始 UA：Mozilla/5.0 (Linux; Android 15; wv) AppleWebKit/537.36 (KHTML, like Gecko)Version/4.0 Chrome/134.0.6998.136 Mobile Safari/537.36

• 微信增加的信息：XWEB/1340109 MMWEBSDK/20250201 MMWEBID/9925 MicroMessenger/8.0.58.2841(0x28003A3E) WeChat/arm64 Weixin NetType/WIFI Language/zh_CN ABI/arm64

---

接入方式

WebAR SDK 方式接入

Android：https://github.com/kivisense/android-webar-sdk

iOS：https://github.com/kivisense/ios-webar-sdk

系统 WebView 方式接入

Coming Soon

开发者也可以接入第三方浏览器内核，如 腾讯 X5 内核

浏览器组件方式接入

iOS: SFSafariViewController

Android：Chrome Custom Tabs

---

自定义网页开发

使用 Kivicube Web 版 AR 插件进行自定义开发

Web版AR插件快速接入