跳转到内容

DANGER

如果将自研H5最后放到微信小程序中,则还需要加入业务域名:www.kivicube.com,企业用户拥有此权益

运行环境

../../learn/ar-env

接入方式

Kivicube版本接入方式
基础版/个人版支持基础iframe嵌入、Kivicube Web版AR插件接入
+ 带Spash与水印
+ Kivicube Web版AR插件接入:支持属性与事件,带【高级API水印】
+ Web唤起小程序:请参考微信官方说明
+ 支持自定义域名(有水印与授权弹窗的域名显示)
高级版支持基础iframe嵌入、Kivicube Web版AR插件接入
+ 不带Spash与水印
+ Kivicube Web版AR插件接入:支持属性与事件,带【高级API水印】
+ Web唤起小程序:请参考微信官方说明
+ 支持自定义域名(有水印与授权弹窗的域名显示)
企业版支持基础iframe嵌入、Kivicube Web版AR插件接入
+ 不带Spash与水印
+ Kivicube Web版AR插件接入:支持属性与事件,带【高级API水印】,购买Web版AR插件授权即可去除【高级API水印】
+ Web唤起小程序:请参考微信官方说明
+ 支持自定义域名(有水印与授权弹窗的域名显示,支持购买域名授权产品去除)

Web版AR插件快速接入

./web-ar-plugin-quick-start

iFrame嵌入

INFO

  • 基础版、个人版、高级版用户接入后会有【开发者试用】水印
  • 企业版用户没有【开发者试用】水印

场景嵌入

INFO

  • 非企业版用户可以采用此形式将Kivicube链接快速接入到自己的H5中,如果需要使用更多自定义的功能,请使用Kivicube Web版AR插件
html
<iframe
      src="https://www.kivicube.com/scenes/lU0kh9MnQBxa15Op5tcl3SJV53FWcSk6"
      allow="camera;"
      frameborder="0"
      width="300px"
      height="500px"
></iframe>

WARNING

注意:****使用iframe标签的网页(自研H5所在页面),必须运行在https协议上,或者使用http://localhost访问。否则iframe之中的网页因无法打开摄像头,而会出现类似“仅支持iOS11及以上系统”的相关提示。

不建议在开发环境(使用了192.168.x.x类似的内网地址)中接入测试,除非你知道如何在开发环境中配置好https协议,并让手机正常访问,否则都建议部署到线上环境(也必须确保支持https访问)进行测试。

INFO

注意:由于iframe不支持陀螺仪权限,所以如果是陀螺仪的场景,便不能通过iframe嵌入

详细请参考:https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Feature-Policy/gyroscope

陀螺仪的场景包含如下三类情况:

  1. 制作“云识别/陀螺仪”场景,并勾选高级设置中的“陀螺仪”

  1. 制作“图像AR”场景,并勾选高级设置中的“陀螺仪”

合辑嵌入

INFO

  • 非企业版用户可以采用此形式将Kivicube链接快速接入到自己的H5中,如果需要使用更多自定义的功能,请使用Kivicube Web版AR插件
html
<iframe
      src="您的合辑链接"
      allow="camera;"
      frameborder="0"
      width="300px"
      height="500px"
></iframe>

WARNING

注意:****使用iframe标签的网页(自研H5所在页面),必须运行在https协议上,或者使用http://localhost访问。否则iframe之中的网页因无法打开摄像头,而会出现类似“仅支持iOS11及以上系统”的相关提示。

不建议在开发环境(使用了192.168.x.x类似的内网地址)中接入测试,除非你知道如何在开发环境中配置好https协议,并让手机正常访问,否则都建议部署到线上环境(也必须确保支持https访问)进行测试。

INFO

注意:由于iframe不支持陀螺仪权限,所以如果是含有陀螺仪的合辑,便不能通过iframe嵌入

详细请参考:https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Feature-Policy/gyroscope

陀螺仪的合辑包含如下三类情况:

  1. 合辑类型是“云识别/陀螺仪”,合辑中制作“云识别/陀螺仪”场景,并勾选高级设置中的“陀螺仪”

  1. 合辑类型是“图像AR”,合辑中制作“图像AR”场景,并勾选高级设置中的“陀螺仪”

身体AR场景嵌入