AR XR Builder

---

name: kivicube-web-plugin-ar-xr-builder description: Use when building, embedding, customizing, or troubleshooting AR/XR experiences with the Kivicube Web Plugin, including WebAR/Web3D H5 pages, landing pages, event pages, product showcases, sceneId or collectionId setup, Vue/React wrappers, SceneApi runtime control, camera, autoplay, permissions, CORS, and compatibility. Also match Chinese requests such as 开发AR体验、XR体验、WebAR活动页、H5落地页、营销页、3D展示页、接入Kivicube Web插件、扫码识别、云识别、拍照分享。

---

Kivicube Web Plugin AR/XR Builder

Kivicube Web Plugin is an iframe-based integration layer for published scenes and collections used to build AR and XR experiences. The host page owns the iframe, page UI, and event listeners; Kivicube owns the inner experience and exposes a public runtime bridge through iframe-plugin.js. Use this skill from an external integrator's point of view: public script URL, public events, public open props, framework wrappers, and public SceneApi.

Common trigger phrases this skill should match well:

build a WebAR H5 activity page or AR marketing page

embed a Kivicube scene in a Vue 3 or React site

create a branded AR landing page or event page

build a Web3D product showcase or model viewer

customize loading, scan, camera, or photo UI for Kivicube

fix camera permission, autoplay, CORS, or compatibility issues in Kivicube Web

Architecture Model

Host page HTML/CSS/JS
  -> load https://www.kivicube.com/lib/iframe-plugin.js
  -> open a scene or collection into an 

Then branch by need:

Installation, script URL, HTTPS, props, permissions, and deployment: references/integration.md

Lifecycle, event choreography, host-owned UI, and cleanup: references/patterns.md

Object lookup, transforms, creation, hierarchy, and destruction: references/scene_objects_reference.md

Images, panorama, video, GIF, glTF, and animation control: references/media_animation_reference.md

Rendering, lights, env map, camera, touch forwarding, photo, and cloud-skip: references/rendering_camera_reference.md

Copyable end-to-end examples, including Vue 3 and React: references/examples.md

Stable usage guidance and rollout advice: references/best_practices.md

Symptom-driven debugging: references/troubleshooting.md

API Scope

Treat the public Kivicube Web plugin surface as the source of truth:

open or destroy a scene or collection through the global plugin object

listen on the iframe for lifecycle, loading, recognition, URL, and error events

read event.detail.api on scene pages and call async SceneApi methods

keep answers limited to the stable Web plugin surface summarized in this skill and its references