WebXR导出

你可以在这里查看实时演示。

或者XR交互工具包演示在这里。

使用Unity引擎开发和导出WebXR体验。

WebXR导出同时支持增强现实和虚拟现实WebXR API沉浸式会话。

它将WebXR JavaScript API集成到Unity WebGL中，让你可以在熟悉的编辑器中使用C#开发体验。

⭐点赞以表示兴趣⭐

❤赞助以支持开发❤

<hr>

💾 下载

更好的选择：从OpenUPM导入WebXR导出和WebXR交互包。

• WebXR导出
• WebXR交互

或者从git导入包，更多信息请查看WebXR导出和WebXR交互。

📄 文档

关于如何入门和使用WebXR导出的更多信息，你可以查看文档文件夹。

🧩 兼容性

重要提示关于此Git仓库 - 本仓库使用符号链接。确保在克隆时启用符号链接。

git config core.symlinks true

或者只是将其作为Unity包（UPM）使用，更多信息在这里。

📝 Unity编辑器版本

• 2020.3.11f1及以上。
• 2021.1.4f1及以上。
• 2022.1及以上。
• 2023.1及以上。

🗺️ 浏览器兼容性

以下是WebXR导出演示已测试的浏览器和平台列表。

Windows上的Google Chrome。

Windows上的Microsoft Edge。

Meta Quest（1、2、Pro等）上的Quest浏览器。

Meta Quest（1、2、Pro等）上的Wolvic。

Hololens 2上的Microsoft Edge。

Android上的Google Chrome（支持AR和VR会话）。

Android上的Samsung Internet浏览器（支持AR和VR会话）。

iOS上的Mozilla WebXR Viewer。

VIVE Focus Plus上的Firefox Reality。

VIVE Focus 3上的Wolvic。

Magic Leap 2上的Helio。

PICO 4和PICO 4E上的PICO浏览器。

PICO 4和PICO 4E上的Wolvic。

🐞 存在问题/缺陷

Magic Leap One上的Helio（存在与眼睛视图相关的bug）。

Apple Vision Pro上的Safari（需要在系统设置中启用标志。手部捏合时没有selected事件）。

🛤️ 路线图

WebXR导出版本0.20.0及以上包含Unity XR SDK支持。 接下来是AR Foundation支持。目前有不使用AR Foundation的透视/透视和命中测试支持。 版本0.20.0还取消了对内置渲染管线的支持，需要进一步调查是否可能重新添加。

⚙️ WebXR API支持

WebXR设备API - 支持Unity显示和输入XR子系统

WebXR游戏手柄模块（包括支持设备上的触觉执行器）- 支持Unity新输入系统

WebXR增强现实模块

WebXR命中测试模块（目前仅限于观察者空间命中测试源）- 不使用AR Foundation命中测试

WebXR手部输入 - 支持Unity XR Hands包

WebXR输入配置文件使用WebXR输入配置文件加载器 - 支持XR交互工具包

更多功能

观众相机

WebXR混合现实捕捉

📊 WebXR / WebVR填充

如果用户没有支持的头戴设备、浏览器或设备，内容仍然可以通过使用WebXR填充来工作。

📱 移动设备支持

这个资产通过利用Unity的WebGL平台支持来工作，因此也有相同的限制。因此，移动设备支持有限，可能无法工作。我们确实确保了它的轻量化，以便移动设备能够处理它，并且在进行一些优化后，它能够在高端移动设备上运行。参见Unity的WebGL浏览器兼容性。

📜 版本历史和说明

你可以查看 WebXR Export 和 WebXR Interactions 的更新日志以了解版本历史。

🤝 贡献

我们鼓励你提出问题、报告问题、贡献代码、提出功能请求、分享你的作品或提出问题。但请记住，这是一个实验性项目。

🔗 有用的链接和信息

许多 WebXR 升级和 API 使用得以实现，要感谢以下资源：

WebVR 到 WebXR 迁移指南

WebXR 设备 API 说明

WebXR 输入配置查看器

WebXR 示例

WebXR Polyfill

沉浸式网络工作组/社区组

Rufus31415 的 SimpleWebXR

WebXR Discord

🎞️ 致谢

特别感谢 needle.tools 帮助将其制作成适当的软件包。

感谢 Brandon Jones (@toji)，他撰写了 WebVR 到 WebXR 迁移指南 并提供了大量示例，这些对将代码从 WebVR 转换为 WebXR 很有帮助。

Mozilla 的 Unity WebVR Export 致谢：

这个项目受到了 @gtk2k、Chris Miller (@chrmi) 和 Anthony Palma 早期使用 Unity 构建 WebVR 探索的深远影响。

同时，感谢 Arturo Paracuellos (@arturitu) 创建了这些示例中用于控制器的 3D 手模型。

⚖️ 许可证

由于基础项目使用 Apache License, Version 2.0，我们将继续使用它。

WebXR Export 许可证：

版权所有 2020 Oren Weizman

根据 Apache License, Version 2.0（"许可证"）获得许可； 除非遵守许可证，否则你不得使用此文件。 你可以在以下位置获取许可证副本：

http://www.apache.org/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则根据许可证分发的软件是基于"按原样"分发的， 不附带任何明示或暗示的担保或条件。 有关许可证下的特定语言管理权限和限制，请参阅许可证。

<hr>

这是一个基于 Mozilla 的 Unity WebXR Exporter（当时是 WebVR exporter）的项目。

Unity WebVR Exporter 许可证：

版权所有 2017 - 2018 Mozilla Corporation

根据 Apache License, Version 2.0（"许可证"）获得许可； 除非遵守许可证，否则你不得使用此文件。 你可以在以下位置获取许可证副本：

http://www.apache.org/licenses/LICENSE-2.0

除非适用法律要求或书面同意，否则根据许可证分发的软件是基于"按原样"分发的， 不附带任何明示或暗示的担保或条件。 有关许可证下的特定语言管理权限和限制，请参阅许可证。