# 自研H5接入

## 运行环境

{% content-ref url="/pages/V7G4uKVUp6TmGSfartxU" %}
[Requirements](/overview/requirements.md)
{% endcontent-ref %}

***

## 接入方式

<table data-header-hidden><thead><tr><th width="143.11163330078125"></th><th></th></tr></thead><tbody><tr><td><strong>Kivicube版本</strong></td><td><strong>接入方式</strong></td></tr><tr><td><strong>基础版/个人版</strong></td><td><strong>支持基础 iframe 嵌入、Kivicube Web 版 AR 插件接入</strong> + <strong>带 Splash 与水印</strong> + Kivicube Web 版 AR 插件接入：支持属性与事件，带【高级 API 水印】 + 支持自定义域名（有水印与授权弹窗的域名显示）</td></tr><tr><td><strong>高级版</strong></td><td><strong>支持基础 iframe 嵌入、Kivicube Web 版 AR 插件接入</strong> + <strong>带 Splash 与水印</strong> + Kivicube Web 版 AR 插件接入：支持属性与事件，带【高级 API 水印】 + 支持自定义域名（有水印与授权弹窗的域名显示）</td></tr><tr><td><strong>企业版</strong></td><td><strong>支持基础 iframe 嵌入、Kivicube Web 版 AR 插件接入</strong> + <strong>不带 Splash 与水印</strong> + Kivicube Web 版 AR 插件接入：支持属性与事件，带【高级 API 水印】，<strong>购买 Web 版 AR 插件授权即可去除【高级 API 水印】</strong> + 支持自定义域名（有水印与授权弹窗的域名显示，支持购买域名授权产品去除）</td></tr></tbody></table>

***

## Web版AR插件快速接入 <a href="#web-ban-ar-cha-jian-kuai-su-jie-ru" id="web-ban-ar-cha-jian-kuai-su-jie-ru"></a>

{% content-ref url="/pages/aTDRb9wLh7u5TMUKUyJh" %}
[Web版AR插件快速接入](/dev/web-dev-1/web-ar-plugin-quick-start.md)
{% endcontent-ref %}

***

### iFrame 嵌入 <a href="#iframe-qian-ru" id="iframe-qian-ru"></a>

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

#### 场景嵌入 <a href="#chang-jing-qian-ru" id="chang-jing-qian-ru"></a>

* 非企业版用户可以采用此形式将 Kivicube 链接快速接入到自己的 H5 中
* 如果需要使用更多自定义的功能，请使用 **Kivicube Web 版 AR 插件**

```html
<iframe
  src="https://www.kivicube.com/scenes/lU0kh9MnQBxa15Op5tcl3SJV53FWcSk6"
  allow="camera;"
  frameborder="0"
  width="300px"
  height="500px">
</iframe>
```

{% hint style="warning" %}
使用 iframe 标签的网页（自研 H5 所在页面）必须运行在 https 协议上，或者使用 <http://localhost> 访问。否则 iframe 中的网页因无法打开摄像头，会出现类似“仅支持 iOS11 及以上系统”的提示。不建议在开发环境（如 192.168.x.x 内网地址）中接入测试，除非你已正确配置 https 并能在手机上访问。建议直接部署到线上环境（必须确保支持 https 访问）进行测试。
{% endhint %}

***

## 合辑嵌入

* 非企业版用户可以采用此形式将 Kivicube 链接快速接入到自己的 H5 中
* 如果需要使用更多自定义的功能，请使用 Kivicube Web 版 AR 插件

```
<iframe
  src="您的合辑链接"
  allow="camera;"
  frameborder="0"
  width="300px"
  height="500px">
</iframe>
```

{% hint style="warning" %}
使用 iframe 标签的网页（自研 H5 所在页面）必须运行在 https 协议上，或者使用 <http://localhost> 访问。否则 iframe 中的网页因无法打开摄像头，会出现类似“仅支持 iOS11 及以上系统”的提示。不建议在开发环境（如 192.168.x.x 内网地址）中接入测试，除非你已正确配置 https 并能在手机上访问。建议直接部署到线上环境（必须确保支持 https 访问）进行测试。
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-en.kivicube.com/dev/web-dev-1/web-dev.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.