Unity Engine을 사용하여 WebXR 경험을 개발하고 내보내세요.

WebXR Export는 증강 현실(Augmented Reality)과 가상 현실(Virtual Reality) WebXR API 몰입형 세션을 모두 지원합니다.

C#을 사용하여 익숙한 에디터에서 경험을 개발할 수 있도록 WebXR JavaScript API를 Unity WebGL에 통합합니다.

❤개발 지원은 Sponsor로❤

Demo

<hr>

💾 다운로드 (Downloads)

더 나은 옵션: OpenUPM에서 WebXR Export 및 WebXR Interactions 패키지를 가져오세요.

또는 git에서 패키지를 가져올 수 있습니다. 자세한 내용은 WebXR Export 및 WebXR Interactions을 참조하세요.

📄 문서 (Documentation)

WebXR Export를 시작하고 사용하는 방법에 대한 더 많은 정보는 Documentation 폴더에서 확인할 수 있습니다.

🧩 호환성 (Compatibility)

중요 공지 사항 - 이 Git 저장소는 Symlinks를 사용합니다. 클론할 때 Symlinks가 활성화되어 있는지 확인하세요.

`git config core.symlinks true``

또는 Unity Package (UPM)으로 사용하는 것이 더 좋습니다. 자세한 내용은 여기를 참조하세요.

📝 Unity 에디터 버전

2020.3.11f1 이상.
2021.1.4f1 이상.
2022.1 이상.
2023.1 이상.
6000.0.23f1 이상.

🗺️ 브라우저 호환성 (Browser Compatibility)

이 목록은 WebXR Export 데모가 테스트된 브라우저 및 플랫폼입니다.

Windows용 Google Chrome.

Windows용 Microsoft Edge.

Meta Quest의 Quest Browser (1, 2, Pro 등).

Meta Quest의 Wolvic.

Apple Vision Pro용 Safari.

Hololens 2용 Microsoft Edge.

Android용 Google Chrome (AR 및 VR 세션 모두 지원).

Android용 Samsung Internet Browser (AR 및 VR 세션 모두 지원).

iOS용 Mozilla WebXR Viewer.

VIVE Focus Plus용 Firefox Reality.

VIVE Focus 3용 Wolvic.

Magic Leap 2용 Helio.

PICO 4 및 PICO 4E용 PICO Browser.

PICO 4 및 PICO 4E용 Wolvic.

Snap Spectacles의 기본 브라우저 (Default Browser).

🐞 버그/문제점

Magic Leap One용 Helio (아이 뷰와 관련된 버그가 있음).

Spectacles의 기본 브라우저는 Hit-Test에 대한 지원이 제한적임 (Snap WebXR 문서 확인).

🛤️ 로드맵

WebXR Export 버전 0.20.0 이상에는 Unity XR SDK 지원이 포함됩니다.
그 다음으로는 AR Foundation 지원이 예정되어 있습니다. 현재는 AR Foundation을 사용하지 않는 패스스루(passthrough)/시쓰루(seethrough) 및 Hit-Test 지원만 존재합니다.
버전 0.20.0에서는 Built-in Render Pipeline에 대한 지원도 제외되었는데, 이를 다시 추가하는 것이 가능한지 더 많은 조사가 필요합니다.

⚙️ WebXR API 지원

WebXR Device API - Unity Display 및 Input XR Subsystems 지원

WebXR Gamepads Module (지원되는 장치에서 hapticActuators 포함) - Unity New Input System 지원

WebXR Augmented Reality Module

WebXR Hit Test Module (현재 뷰어 공간의 Hit Test 소스에 한정) - AR Foundation hit test 미사용

WebXR Hand Input - Unity XR Hands 패키지 지원

[WebXR Input Profiles]는 [WebXR Input Profiles Loader]를 사용하여 지원하며, XR Interaction Toolkit을 지원합니다.

Hands

추가 기능 (More features)

Spectator Camera

WebXR Mixed Reality Capture

📊 Polyfilled WebXR / WebVR

사용자가 지원하는 헤드셋, 브라우저 또는 장치를 가지고 있지 않더라도 [WebXR Polyfill]을 사용하여 콘텐츠가 작동할 수 있습니다.

📱 모바일 지원 (Mobile support)

이 에셋은 Unity의 WebGL 플랫폼 지원을 활용하여 작동하므로 동일한 제한 사항을 공유합니다. 이 때문에 모바일 지원은 제한적이며 작동하지 않을 수도 있습니다. 가볍게 만들도록 노력했기 때문에 모바일 장치에서도 처리할 수 있으며, 일부 최적화를 통해 고성능 모바일 장치에서 실행될 수 있습니다. Unity의 WebGL 브라우저 호환성을 참조하십시오.

📜 버전 기록 및 참고 사항 (Version History and Notes)

버전 기록은 [WebXR Export]의 변경 로그(Packages/webxr/CHANGELOG.md)와 [WebXR Interactions]의 변경 로그(Packages/webxr-interactions/CHANGELOG.md)에서 확인할 수 있습니다.

🤝 기여 (Contributing)

이슈를 열거나, 문제를 보고하거나, 코드로 기여하거나, 기능 요청을 하거나, 작업물을 공유하거나, 질문하는 것을 권장합니다. 하지만 이것은 실험적인 프로젝트임을 기억하십시오.

🔗 유용한 링크 및 정보 (Useful links and info)

WebXR 업그레이드와 API 사용의 상당 부분은 다음 리소스들 덕분에 가능해졌습니다.

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)

이 프로젝트를 제대로 된 패키지로 만드는 데 도움을 준 needle.tools에 특별히 감사드립니다.

WebVR to WebXR Migration Guide를 작성하고 WebVR에서 WebXR로 코드를 변환하는 데 도움이 된 수많은 샘플을 제공해 준 Brandon Jones (@toji)에게 감사드립니다.

Mozilla의 Unity WebVR Export 크레딧:

이 프로젝트는 @gtk2k, Chris Miller (@chrmi), 그리고 Anthony Palma가 Unity를 사용하여 WebVR용으로 빌드하는 초기 탐색에서 많은 영향을 받았습니다.

또한, 이 예제에서 컨트롤러에 사용되는 3D 손 모델을 생성해 준 Arturo Paracuellos (@arturitu)에게도 감사합니다.

⚖️ 라이선스 (License)

기반 프로젝트가 Apache License, Version 2.0을 사용했으므로, 저희도 이를 계속 따를 것입니다.

WebXR Export 라이선스:

Apache License, Version 2.0(

Unity WebVR Exporter 라이선스:

Apache License, Version 2.0("라이선스")에 따라 라이선스가 부여되었습니다. 본 파일을 라이선스를 준수하지 않고는 사용할 수 없습니다.
본 라이선스의 사본은 다음에서 얻을 수 있습니다:

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

적용 가능한 법률에 의해 요구되거나 서면으로 합의되지 않는 한, 본 라이선스 하에 배포되는 소프트웨어는 어떠한 종류의 보증이나 조건 없이("있는 그대로") 배포됩니다. 명시적이든 묵시적이든 관계없습니다.
라이선스 하의 권한 및 제한 사항을 규정하는 특정 언어는 라이선스를 참조하십시오.

WebXR Export

요약

핵심 포인트