# 概述

本文适合有初步了解的开发者阅读，入门请参见[**指南**](/miniprogram/dev/framework/xr-frame/index.md)。

> ⚠️ `xr-frame`在基础库`v2.32.0`开始基本稳定，发布为正式版，但仍有一些功能还在开发，请见限制和展望。

**xr-frame**是一套小程序官方提供的XR/3D应用解决方案，基于混合方案实现，性能逼近原生、效果好、易用、强扩展、渐进式、遵循小程序开发标准：

```xml
<xr-scene>
  <xr-assets>
    <!-- 加载一个GLTF模型 -->
    <xr-asset-load type="gltf" asset-id="gltf-model" src="..." />
  </xr-assets>
  <xr-env env-data="..." />

  <xr-node>
    <!-- 将一个GLTF模型渲染在AR场景中 -->
    <xr-ar-tracker ...>
      <xr-gltf model="gltf-model" ...></xr-gltf>
    </xr-ar-tracker>
    <xr-camera is-ar-camera ...></xr-camera>
  </xr-node>

  <xr-node>
    <!-- 场景光照 -->
    <xr-light type="ambient" ... />
    <xr-light type="directional" ... />
  </xr-node>
</xr-scene>
```

## 特性

比起目前的`Canvas`组件，**xr-frame**有以下显著的优势：

### 🍰 高度整合，上手简单
提供`xml`的方式来描述3D场景，并集成了AR、物理、动画、粒子、后处理等等系统，上手简单，符合小程序开发规范。

### 🌈 渲染效果好
内置完整的PBR效果、环境光照、阴影，原生支持glTF资源，提供的[xr-frame-toolkit](https://github.com/wechat-miniprogram/xr-frame-toolkit)可以快速通过全景图生成环境数据。

### ⚡️ 高性能
混合方案，渲染性能逼近原生，[xr-frame-toolkit](https://github.com/wechat-miniprogram/xr-frame-toolkit)可以对外部glTF文件进行优化，来提高加载性能，还有完善的缓存机制保证二次进入的加载性能。

### 🧱 易扩展
扩展性强，从资源到组件元素，皆可以由高阶用户自己定制，未来还可以暴露内部的渲染管线定制能力。

## 示例

上面的例子只是一部分简略代码，我们提供了丰富的示例并开源在[xr-frame-demo](https://github.com/dtysky/xr-frame-demo)，可以直接扫码体验：

![demo](https://res8.wxqcloud.qq.com.cn/wxdoc/490c9fab-4aee-499d-bdfc-221fe3150173.png)

以下是部分示例需要用到的扫描资源：

![](https://res8.wxqcloud.qq.com.cn/wxdoc/45c0a72f-8de3-4cbd-aec4-b6bdf0691715.jpeg)

典型案例 -> 扫描图片视频

![](https://res8.wxqcloud.qq.com.cn/wxdoc/436773e0-ca89-4ff3-b15e-5d7e87fbcfc5.jpeg)

典型案例 -> 扫描透视模型

![](https://res8.wxqcloud.qq.com.cn/wxdoc/66b22d55-0477-4907-b8cc-2896f5532e16.jpeg)

典型案例 -> 扫描微信球

![](https://res8.wxqcloud.qq.com.cn/wxdoc/75fb6cc8-361e-4799-b484-b6cff5ba0aaa.jpeg)

AR案例 -> 2DMarker

![](https://res8.wxqcloud.qq.com.cn/wxdoc/670bd299-096f-4e2f-82c7-5137313b8eee.jpeg)

AR案例 -> OSD Marker

## 限制和展望

限制：

1. 最低要求客户端iOS**8.0.29**、安卓**8.0.30**及以上，推荐稳定版在iOS**8.0.36**、安卓**8.0.35**及以上。
2. 基础库最低**2.27.1**及以上，推荐**2.32.0**及以上。
3. 开发工具需要最新版本，建议[Nightly版本](/miniprogram/dev/devtools/nightly_backup.md)。
4. 小程序**全局同一时刻只能存在一个**`xr-frame`组件，否则可能会发生异常。
5. 同一个`xr-frame`组件只能存在一个`xr-scene`，并且必须为顶层。
6. 目前不支持和小程序传统标签比如`<view>`混写。
7. 目前不支持`wxml`自动补全，真机调试需要特别注意，见[真机调试文档](../tools/debug#真机调试)。

同时未来还会追加更多的能力，在未来的规划中，我们还会着重致力于：

1. **XR-FRAME**内置特色的UI组件，让开发者可以在**XR-FRAME**组件中写UI，来实现一套酷炫的UI系统。
2. AR/VR能力持续增强，支持眼睛设备。
3. 交互手段进一步强化，物理碰撞、触发等功能（已完成，待发布）。
4. 工具能力强化，包括标签属性自动补全等。

想要进一步了解整个框架的架构，请看[架构](/miniprogram/dev/reference/xr-frame/component/core/index)一节。