Unity XR SDK 공급자 설정 가이드
이 문서는 Unity의 XR SDK에서 공급자를 설정하는 방법에 대해 설명합니다. 아래에는 해당 내용의 이해를 돕기 위한 간단한 해설과 예제가 포함되어 있습니다.
UnitySubsystemsManifest.json
UnitySubsystemsManifest.json 파일은 플러그인 로드 전에 쿼리할 수 있는 공급자에 대한 메타데이터를 포함하고 있습니다. 이 파일은 XR 디스플레이 및 입력 보조 시스템을 정의하는데 사용됩니다.
JSON 예시
아래는 UnitySubsystemsManifest.json의 예시입니다.
{ "name": "PluginName", "version": "1.0.0", "libraryName": "UnityXRDisplayExample",
"displays": [
{
"id": "Display0",
"supportedMirrorBlitReservedModes" : ["leftEye","rightEye", "sideBySide"]
}
],
"inputs": [
{
"id": "MockHMD Head Tracking Stationary"
},
{
"id": "MockHMD Head Tracking Simulated"
}
]
}
메타데이터 설명
| 항목 | 설명 |
|---|---|
| name | 공급자의 이름. 네이티브 플러그인의 RegisterLifecycleHandler의 첫 번째 매개변수와 일치해야 합니다. |
| version | 현재는 사용되지 않지만 향후 UI에 표시될 수 있습니다. |
| libraryName | 공급자의 네이티브 플러그인 바이너리 이름과 일치해야 합니다. |
| displays | 디스플레이 보조 시스템 공급자의 컬렉션입니다. |
| id | 디스플레이 플러그인 설정에 대한 식별자입니다. |
| inputs | 입력 보조 시스템 공급자의 컬렉션입니다. |
공급자 생성 및 활성화
Unity에서 XR 공급자를 생성하고 활성화하려면 메타데이터를 포함한 JSON 파일을 정의한 후, 이를 기반으로 Unity의 서브시스템을 등록해야 합니다. 이 과정에서 각 디스플레이와 입력 장치에 대한 RegisterLifecycleHandler 호출을 통해 기능 연결을 구성할 수 있습니다.
활용 예제
- VR 게임 개발: 다양한 VR 헤드셋을 지원하는 게임을 개발할 때, 메타데이터를 통해 각 헤드셋의 디스플레이와 입력 장치 설정을 정의할 수 있습니다.
- 증강 현실 애플리케이션: AR 기능을 추가하기 위해 필요한 XR 컴포넌트를 정의하고, 사용자 경험을 개선하기 위해 맞춤형 메타데이터를 적용합니다.
- 테스팅: XR 장치의 기능을 테스트하는 패키지를 만들고, 이를 통해 개발자가 다양한 디스플레이 및 입력 장치의 작동을 검증할 수 있도록 합니다.
이 가이드를 통해 Unity XR SDK에서 공급자를 설정하고 활용하는 방법에 대한 기본적인 이해를 돕기를 바랍니다. 추가적인 질문이 있으시면 커뮤니티 포럼에 문의해 주세요.