Jetpack XR SDK에는 Android XR 기기를 위한 몰입형 및 증강 환경을 빌드하는 데 필요한 모든 도구와 라이브러리가 포함되어 있습니다.
완전 몰입형 환경 구축
XR 헤드셋, 유선 XR 글라스와 같은 전용 고화질 기기를 타겟팅합니다. Kotlin 및 Compose와 같은 Modern Android Development 개발자 도구와 Java 및 뷰와 같은 이전 세대 도구를 사용합니다. UI를 공간화하고, 3D 모델을 로드 및 렌더링하고, 실제 세계를 의미론적으로 이해할 수 있습니다.
Android에 이미 모바일 또는 대형 화면 앱이 있는 경우 Jetpack XR SDK는 기존 레이아웃을 공간화하고 3D 모델과 몰입형 환경으로 환경을 개선하여 앱을 새로운 차원으로 끌어올립니다. 기존 Android 앱을 공간화하는 방법에 관한 권장사항은 품질 가이드라인을 참고하세요.
증강된 유용한 환경 구축
가볍고 세련된 오디오 글라스와 디스플레이 글라스를 타겟팅합니다. Kotlin 및 Jetpack Compose Glimmer와 같은 Modern Android Development 개발자 도구를 사용합니다. 휴대전화에서 안경으로 투사된 앱 환경을 지원하는 API를 사용합니다.
Jetpack 라이브러리 사용
Jetpack XR SDK 라이브러리는 풍부하고 몰입도 높은 환경, 가볍고 증강된 환경, 그 사이의 모든 환경을 빌드할 수 있는 포괄적인 도구 모음을 제공합니다. 다음 라이브러리는 Jetpack XR SDK의 일부입니다.
- XR용 Jetpack Compose: Android XR의 공간 기능을 활용하는 공간 UI 레이아웃을 선언적으로 빌드합니다.
- XR용 Material Design: XR에 맞게 조정되는 Material 구성요소와 레이아웃으로 빌드합니다.
- Jetpack SceneCore: 3D 콘텐츠로 Android XR 장면 그래프를 빌드하고 조작합니다.
- Jetpack XR용 ARCore: 인식 기능을 통해 디지털 콘텐츠를 현실 세계로 가져옵니다.
- Jetpack Compose Glimmer: 디스플레이 안경에 최적화된 증강 Android XR 환경을 빌드하기 위한 UI 도구 키트입니다.
- Jetpack Projected: 휴대전화에서 오디오 글라스 또는 디스플레이 글라스로 투사된 앱 환경을 지원하는 API입니다.
개발자 프리뷰 중 API 개발
Jetpack XR SDK 라이브러리는 Android XR 개발자 프리뷰의 일부이며 이러한 API는 아직 개발 중입니다. 알려진 문제는 라이브러리 출시 노트를 참고하세요.
- XR용 Jetpack Compose 출시 노트
- Jetpack XR용 ARCore 출시 노트
- Jetpack SceneCore 출시 노트
- XR 런타임 출시 노트
- Jetpack Compose Glimmer 출시 노트
- Jetpack 예상 출시 노트
이 목록에 없는 문제가 발생하면 버그를 신고하거나 의견을 제출하세요.
XR용 Jetpack Compose
XR용 Jetpack Compose를 사용하면 행 및 열과 같은 공간화된 구성요소를 사용하여 익숙한 선언적 Compose 모델로 공간 UI 및 레이아웃을 빌드할 수 있습니다.
이 라이브러리는 기존 2D Compose 또는 뷰 기반 UI를 공간 레이아웃에 배치할 수 있는 공간 패널 및 Orbiter와 같은 하위 공간 컴포저블도 제공합니다. 다른 하위 공간 컴포저블은 다른 유형의 공간 사용 사례를 처리합니다. 예를 들어 SceneCoreEntity를 사용하면 UI를 기준으로 3D 모델과 같은 항목을 배치할 수 있습니다.
기존 Android 앱을 공간화하는지 또는 처음부터 새 XR 앱을 만드는지에 관계없이 XR용 Jetpack Compose를 사용할 수 있습니다.
자세한 내용은 공간 UI 개발자 가이드 및 라이브러리 및 API 참고 문서를 참고하세요.
XR용 Material Design
Material Design은 XR에 맞게 조정되는 구성요소와 레이아웃을 제공합니다. 적응형 레이아웃으로 빌드하는 경우 XR용 Material Design 구현에 관해 자세히 알아보기
Jetpack SceneCore
Jetpack SceneCore 라이브러리를 사용하면 항목으로 정의된 3D 콘텐츠를 서로 상대적으로, 그리고 환경에 상대적으로 배치하고 정렬할 수 있습니다. SceneCore를 사용하면 다음을 할 수 있습니다.
- 공간 환경 설정
PanelEntity인스턴스 만들기- 3D 모델 배치 및 애니메이션 적용
- 서라운드 오디오 소스 지정
- 항목을 이동 및 크기 조절이 가능하고 실제 세계에 고정할 수 있도록 만드는 구성요소를 항목에 추가
Jetpack SceneCore 라이브러리는 뷰를 사용하여 빌드된 애플리케이션의 공간화도 지원합니다. 자세한 내용은 뷰 작업 가이드를 참고하세요.
자세한 내용은 API 참조를 확인하세요.
Jetpack XR용 ARCore
기존 ARCore 라이브러리에서 영감을 받은 Jetpack XR용 ARCore 라이브러리는 디지털 콘텐츠를 실제 세계와 혼합하는 기능을 제공합니다. 이 라이브러리에는 모션 추적, 영구 앵커, Hit Test, 시맨틱 라벨 지정 (예: 바닥, 벽, 탁자)을 통한 평면 식별이 포함됩니다. 이 라이브러리는 OpenXR에서 제공하는 기본 인식 스택을 활용하여 다양한 기기와의 호환성을 보장하고 앱의 미래를 대비하는 데 도움이 됩니다.
자세한 내용은 Jetpack XR용 ARCore 사용을 참고하세요.
Jetpack Compose Glimmer
Jetpack Compose Glimmer는 디스플레이 안경에 최적화된 증강 Android XR 환경을 빌드하기 위한 UI 도구 키트입니다. 하루 종일 착용하는 기기를 위해 아름답고 미니멀하며 편안한 UI를 빌드하세요.
- 한눈에 알아볼 수 있고 가독성이 높도록 설계: 휴대전화와 달리 기본 캔버스는 광학 시스루 디스플레이로, 투명합니다. Jetpack Compose Glimmer는 안경 전용 테마 설정, 간소화된 색상 팔레트, 서체를 제공하여 콘텐츠를 읽기 쉽고 빠르게 처리하며 방해받지 않도록 합니다.
- 웨어러블 전용 상호작용에 최적화: 사용자가 안경을 사용하는 방식에 맞게 상호작용 모델을 최적화했습니다. Jetpack Compose Glimmer 구성요소는 방해가 되는 물결 효과 대신 최적화된 윤곽선과 같은 명확한 포커스 상태를 제공하며, 탭, 프레임 스와이프, 음성과 같은 일반적인 물리적 입력을 처리하도록 빌드되었습니다.
- 익숙한 선언적 UI 패턴 사용: Jetpack Compose Glimmer는 전적으로 Jetpack Compose를 기반으로 빌드되므로 Android의 선언적 UI 빌드에 관해 이미 알고 있는 모든 것을 사용할 수 있습니다. Google은 Text, Icon, Button과 같은 핵심적인 사전 빌드된 컴포저블 함수와 TitleChip과 같은 특수 구성요소를 모두 스마트 안경 환경에 최적화하여 제공합니다.
Jetpack Projected
오디오 글라스 및 디스플레이 글라스용으로 빌드하면 앱이 앱의 XR 환경을 투사하는 Android 휴대전화와 같은 호스트 기기에서 실행됩니다. Jetpack Projected를 사용하면 호스트 기기에 XR 프로젝션 기능이 있는 경우 이러한 Android 호스트 기기가 오디오 또는 디스플레이 안경과 통신할 수 있습니다.
- 프로젝션된 기기 하드웨어 액세스: 프로젝션된 기기 (오디오 글라스 또는 디스플레이 글라스)에 연결된 기기 컨텍스트입니다. 이 투사된 컨텍스트는 카메라와 같은 투사된 기기 하드웨어에 대한 액세스를 제공합니다. 오디오 또는 디스플레이 안경에 표시하기 위해 특별히 만든 전용 활동은 이미 투사된 컨텍스트로 작동합니다. 앱의 다른 부분(예: 전화 활동 또는 서비스)에서 안경의 하드웨어에 액세스해야 하는 경우 투사된 컨텍스트를 가져올 수 있습니다.
- 권한 요청 간소화: 오디오 글라스와 디스플레이 글라스는 표준 Android 권한 모델을 따르며, 앱이 카메라와 같은 기기 하드웨어에 액세스하기 전에 런타임에 요청해야 하는 글라스 전용 권한이 있습니다. 권한 도우미는 휴대전화와 안경 인터페이스 모두에서 이러한 권한 요청 메커니즘을 간소화하여 일관된 요청 환경을 제공합니다.
- 기기 및 디스플레이 기능 확인: 프로젝션된 기기에 디스플레이가 있는지, 시각적 요소를 표시하는 디스플레이의 상태가 어떤지 확인합니다. 기기의 기능에 따라 앱을 조정합니다. 예를 들어 기기에 디스플레이가 없거나 디스플레이가 꺼져 있는 경우 더 많은 오디오 컨텍스트를 제공할 수 있습니다.
- 앱 카메라 작업 액세스: 앱이 사용자 카메라 작업에 액세스할 수 있습니다(예: 동영상 스트리밍 앱에서 카메라를 켜거나 끄기).
Android XR 에뮬레이터로 XR 앱 환경 테스트하기
Android XR 에뮬레이터는 XR 앱 개발을 위해 설계된 Android Emulator의 특수 버전입니다. 이를 통해 익숙한 Android 스튜디오 환경에서 XR 앱을 테스트하고 디버그할 수 있습니다. XR 헤드셋 및 유선 XR 글라스와 같은 몰입형 기기부터 오디오 및 디스플레이 글라스와 같은 지능형 글라스에 이르기까지 모든 유형의 Android XR 기기에 대한 가상 기기를 만듭니다.
앱을 실행하고 디버그할 준비가 되면 다음 가이드를 참고하여 시작하세요.
OpenXR™ 및 OpenXR 로고는 The Khronos Group Inc. 소유의 상표이며 중국, 유럽 연합, 일본, 영국에서 상표로 등록되어 있습니다.