运行环境

../learn/ar-env

接入方式对比

接入方式	优势	劣势
系统Webview	+ 开发接入成本较低	+ 需支持iOS 14.3+ + 需Android 5.0+，且系统WebView支持
浏览器组件	+ 开发接入成本低 + 支持iOS 13+	+ 国内Android不支持浏览器组件
App唤起微信小程序	+ 开发接入成本低	+ 会脱离App体验AR

注意事项

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

Kivicube会使用行业标准方式，从UserAgent获取关于浏览器的基础信息。因此，一旦UA不标准，就会导致运行出现非预期效果。比如本来是移动端访问，但Kivicube误认为当前在PC端浏览器。

标准UA的格式，请参考：

User-Agent - HTTP | MDN

建议的UA处理方法：可在原本默认的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

接入方式

系统WebView方式接入

iOS

参考示例：https://github.com/kivisense/kivicube-ios-sample

Android

参考示例：https://github.com/kivisense/kivicube-android-sample

浏览器组件方式接入

iOS: SFSafariViewController

Android: Chrome Custom Tabs

App唤起微信小程序方式接入

请参考微信官方说明

自定义网页开发

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

:::

./web/web-ar-plugin-quick-start