Skip to content

De-Panther/unity-webxr-export

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

You can check the live demo here.

Or the XR Interaction Toolkit demo here.

Develop and export WebXR experiences using the Unity Engine.

WebXR Export supports both Augmented Reality and Virtual Reality WebXR API immersive sessions.

It integrates the WebXR JavaScript API to Unity WebGL and lets you develop experiences in the familiar editor using C#.

⭐Star to show interest⭐

❀Sponsor to support the development❀

Demo


πŸ’Ύ Downloads

Better option: Import WebXR Export and WebXR Interactions packages from OpenUPM.

Or import the packages from git, more info at WebXR Export and WebXR Interactions.

πŸ“„ Documentation

For more info on getting started and how to use WebXR Export, you can check the Documentation folder.

🧩 Compatibility

Important notice regarding this Git repository - This repository use Symlinks. make sure that Symlinks are enabled when you clone.

git config core.symlinks true

Or just use this as a Unity Package (UPM), more info here

πŸ“ Unity Editor version

  • 2020.3.11f1 and up.
  • 2021.1.4f1 and up.
  • 2022.1 and up.
  • 2023.1 and up.
  • 6000.0.23f1 and up.

πŸ—ΊοΈ Browser Compatibility

This is a list of browsers and platforms that the WebXR Export demo was tested on.

Google Chrome on Windows.

Microsoft Edge on Windows.

Quest Browser on Meta Quests (1, 2, Pro, etc...).

Wolvic on Meta Quests (1, 2, Pro, etc...).

Microsoft Edge on Hololens 2.

Google Chrome on Android (Supports both AR and VR sessions).

Samsung Internet Browser on Android (Supports both AR and VR sessions).

Mozilla WebXR Viewer on iOS.

Firefox Reality on VIVE Focus Plus.

Wolvic on VIVE Focus 3.

Helio on Magic Leap 2.

PICO Browser on PICO 4 and PICO 4E.

Wolvic on PICO 4 and PICO 4E.

🐞 Has bugs/issues

Helio on Magic Leap One (Has a bug related to eye views).

Safari on Apple Vision Pro (Needs to enable flags in system settings. No selected event on hand pinch).

πŸ›€οΈ Roadmap

WebXR Export version 0.20.0 and up includes Unity XR SDK support. Following that, AR Foundation support is next. Currently there's passthrough/seethrough and Hit-Test support not using AR Foundation. Version 0.20.0 also dropped the support for Built-in Render Pipeline, which needs more investigation if it's possible to add back.

βš™οΈ WebXR APIs support

WebXR Device API - Supports Unity Display and Input XR Subsystems

WebXR Gamepads Module (Including hapticActuators on supported devices) - Supports Unity New Input System

WebXR Augmented Reality Module

WebXR Hit Test Module (Currently limited to viewer space Hit Test source) - Not using AR Foundation hit test

WebXR Hand Input - Supports Unity XR Hands package

WebXR Input Profiles using WebXR Input Profiles Loader - Supports XR Interaction Toolkit

Hands

More features

Spectator Camera

WebXR Mixed Reality Capture

πŸ“Š Polyfilled WebXR / WebVR

If the user does not have supported headset, browser or device, the content will still work through the use of the WebXR Polyfill.

πŸ“± Mobile support

This asset works by utilizing Unity's WebGL platform support and therefore shares the same limitations. Because of this, mobile support is limited and may not work. We did made sure to make it light, so mobile devices would be able to handle it, and it is able to run on high end mobile devices with some optimizations. See Unity's WebGL browser compatibility.

πŸ“œ Version History and Notes

You can check the changelogs of WebXR Export and WebXR Interactions for version history.

🀝 Contributing

You're encouraged to open an issue, report a problem, contribute with code, open a feature request, share your work or ask a question. But remember that it's an experimental project.

πŸ”— Useful links and info

Much of the WebXR upgrades and API usage made possible thanks to these resources.

WebVR to WebXR Migration Guide

WebXR Device API Explained

WebXR Input Profile Viewer

WebXR Samples

WebXR Polyfill

The Immersive Web Working Group/Community Group

SimpleWebXR by Rufus31415

WebXR Discord

🎞️ Credits

Special thanks to needle.tools for the help in making this a proper package.

Thanks to Brandon Jones (@toji) who wrote WebVR to WebXR Migration Guide and lots of samples that helped in converting the code from WebVR to WebXR.

Mozilla's Unity WebVR Export credits:

This project was heavily influenced by early explorations in using Unity to build for WebVR by @gtk2k, Chris Miller (@chrmi) and Anthony Palma.

Also, thanks to Arturo Paracuellos (@arturitu) for creating the 3D-hand models used for controllers in these examples.

βš–οΈ License

As the base project used the Apache License, Version 2.0, we will continue with it.

WebXR Export License:

Copyright 2020 Oren Weizman

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

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

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.


This is a project based on Mozilla's Unity WebXR Exporter (from when it was WebVR exporter).

Unity WebVR Exporter License:

Copyright 2017 - 2018 Mozilla Corporation

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

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

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.