XR

PlayCanvas 可通过 WebXR API 或外部集成，为不同设备创建增强现实（AR）和虚拟现实（VR）应用。

能力

WebXR 通过扩展不断发展，各平台持续实现新旧模块。PlayCanvas 将其集成到引擎，方便使用并与现有系统配合。

可查看已支持模块列表。

平台

WebXR 正逐步普及到主流平台，最新支持情况可查看 caniuse.com。

也可通过 WebXR Polyfill 补充支持。

移动端 Android 支持 VR 和 AR 会话。

头戴设备如 Meta Quest 支持 VR 和 AR；按原文所述，Apple Vision Pro 在 Safari 设置启用后支持 VR 会话。

桌面端 Chrome 和 Edge 通过 SteamVR、OpenXR 等原生 API 连接设备，覆盖多数 PC VR，也可通过 Steam Link 使用 Meta Quest。

没有 XR 设备时测试 WebXR

无需硬件也能开始开发，可安装 Chrome 的 Immersive Web Emulator，通过开发者工具模拟头显和控制器。

危险

不要使用 WebXR API Emulator，它与 PlayCanvas 不兼容，启用会导致应用抛出异常。

WebXR 入门

先检查支持与可用性，再通过用户交互启动会话：

button.element.on('click', () => {
    // check if XR is supported and VR is available
    if (app.xr.supported && app.xr.isAvailable(pc.XRTYPE_VR)) {
        // start VR session providing a camera component
        app.xr.start(entity.camera, pc.XRTYPE_VR, pc.XRSPACE_LOCALFLOOR);
    }
});