지원되는 OpenXR 확장 프로그램으로 빌드

적용 가능한 XR 기기

이 가이드에서는 이러한 유형의 XR 기기를 위한 환경을 구축하는 방법을 설명합니다.

XR 기기 유형 알아보기 →

XR 헤드셋

유선 XR 글라스

XR 기기 유형 알아보기 →

Android XR은 OpenXR 1.1 사양과 긴 서드 파티 공급업체 확장 프로그램을 통해 OpenXR을 지원합니다. 이러한 확장 프로그램을 사용하면 XR 개발 시 익숙한 환경을 제공받을 수 있습니다. 이러한 기능 중 일부에는 Android 런타임 권한이 필요합니다. OpenXR API에서 직접 빌드하려는 경우 jetpack-xr-natives 저장소에서 필요한 헤더 파일을 찾을 수 있습니다.

참고: 공간 API 버전 열은 확장 지원이 도입된 공간 API의 출시 버전을 나타냅니다. 기능 지원 OpenXR 확장 프로그램 (예: XR_ANDROID_enumerate_system_extension_properties)을 사용하여 대상 기기에서 기능을 사용할 수 있는지 확인하는 것이 좋습니다.

Android XR 공급업체 확장 프로그램

확장 프로그램 이름	설명	Spatial API 버전
XR_ANDROID_anchor_sharing_export	XR_ANDROID_trackables, XR_EXT_spatial_anchor, XR_ANDROID_spatial_anchor_space를 통해 애플리케이션에서 생성된 앵커는 특정 세션에 연결되므로 다른 애플리케이션에는 표시되지 않습니다. 이 확장 프로그램을 사용하면 애플리케이션이 실행 중인 다른 애플리케이션과 앵커를 공유할 수 있습니다.	v1
XR_ANDROID_body_tracking	IK를 사용하여 머리와 손의 위치를 기반으로 신체 위치를 결정합니다. 권한: Body Tracking	v2
XR_ANDROID_composition_layer_passthrough_mesh	여러 환경 혼합 모드를 지원하는 기기 권한: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_depth_texture	이 확장 프로그램을 사용하면 애플리케이션이 헤드셋 주변의 실제 환경의 깊이 지도를 요청하고 생성 시 지원되는 깊이 해상도를 쿼리할 수 있습니다. 권한: SCENE_UNDERSTANDING_FINE	v1
XR_ANDROID_device_anchor_persistence	이 확장 프로그램을 사용하면 애플리케이션이 지속될 수 있습니다. 권한: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_enumerate_system_extension_properties	이 확장 프로그램을 사용하면 애플리케이션이 현재 시스템 구성에서 지원되는 확장 프로그램을 확인할 수 있습니다.	v3
XR_ANDROID_eye_tracking	이 확장 프로그램을 사용하면 애플리케이션이 사용자의 눈 위치와 방향, 눈 추적 상태를 획득할 수 있습니다. 권한: EYE_TRACKING_FINE	v1
XR_ANDROID_face_tracking	이 확장 프로그램을 사용하면 애플리케이션이 블렌드 셰이프의 가중치를 가져와 XR 환경에서 얼굴 표정을 렌더링할 수 있습니다. 권한: FACE_TRACKING	v1
XR_ANDROID_face_tracking_data_source	이 확장 프로그램을 사용하면 애플리케이션이 여러 데이터 소스에서 얼굴 추적 데이터를 가져올 수 있습니다. 권한: FACE_TRACKING, RECORD_AUDIO	v3
XR_ANDROID_hand_mesh	이 확장 프로그램을 사용하면 동적 손 메쉬로 표현되는 손 추적 입력을 사용할 수 있습니다. 권한: HAND_TRACKING	v1
XR_ANDROID_light_estimation	이 확장 프로그램을 사용하면 애플리케이션이 헤드셋 주변의 실제 환경 조명을 나타내는 데이터를 요청할 수 있습니다. 권한: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_light_estimation_cubemap	이 확장 프로그램은 기본 XR_ANDROID_light_estimation 확장 프로그램을 기반으로 합니다. 권한: SCENE_UNDERSTANDING_FINE	v3
XR_ANDROID_mouse_interaction	이 확장 프로그램은 마우스 입력을 가져오는 XrPath를 제공하고 마우스 기기와 트랙패드 기기를 모두 포함하는 사용자 마우스 프로필에 일반적으로 사용되는 동작 포즈를 하나 정의합니다.	v1
XR_ANDROID_passthrough_camera_state	패스스루 카메라가 시작되는 데 시간이 걸릴 수 있으며 즉시 사용할 수 없을 수도 있습니다.	v1
XR_ANDROID_performance_metrics	이 확장 프로그램은 현재 XR 기기의 다양한 성능 측정항목 카운터를 열거하고 쿼리하는 API를 제공합니다.	v1
XR_ANDROID_raycast	이 확장 프로그램을 사용하면 애플리케이션이 환경의 추적 가능 항목에 대해 광선 투사를 실행할 수 있습니다. 권한: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_recommended_resolution	이 확장 프로그램을 사용하면 권장 해상도가 변경될 때 런타임이 애플리케이션에 알릴 수 있습니다.	v1
XR_ANDROID_recommended_settings	사용자의 기본 환경은 혼합 모드와 입력 모달리티의 조합을 사용하여 다양한 상태에 있을 수 있습니다.	v1
XR_ANDROID_scene_meshing	이 확장 프로그램은 사용자 환경의 실제 객체를 대략적으로 나타내는 메시를 제공하기 위한 것입니다.	v1
XR_ANDROID_spatial_anchor_space	XR_EXT_spatial_anchor 확장 프로그램에 정의된 xrCreateSpatialAnchorEXT 함수를 사용하면 애플리케이션이 XrSpatialEntityEXT 핸들로 공간 앵커를 만들어 이를 나타낼 수 있습니다. 반면 이 확장 프로그램은 대신 XrSpace 핸들로 표현되는 공간 앵커를 만듭니다. 권한: SCENE_UNDERSTANDING_COARSE	v3
XR_ANDROID_spatial_annotation_tracking	이 확장 프로그램은 XR_EXT_spatial_entity 확장 프로그램이 장면에서 다양한 주석을 추적할 수 있도록 주석 추적 기능을 제공합니다. 이를 통해 애플리케이션은 런타임 참조로 정의된 실제 또는 가상 객체에 오버레이를 배치할 수 있습니다. 권한: SCENE_UNDERSTANDING_FINE	v3
XR_ANDROID_spatial_component_subsumed_by	이 확장 프로그램은 XR_EXT_spatial_entity를 기반으로 하며 XR_SPATIAL_CAPABILITY_PLANE_TRACKING_EXT가 현재 항목을 포함하는 XrSpatialEntityIdEXT를 노출하는 새로운 구성요소를 제공합니다. 권한: SCENE_UNDERSTANDING_COARSE	v3
XR_ANDROID_spatial_discovery_raycast	이 확장 프로그램은 XR_EXT_spatial_entity를 기반으로 빌드되며 기존 공간 기능에 대한 광선 추적 기능을 제공합니다. 권한: SCENE_UNDERSTANDING_FINE	v3
XR_ANDROID_spatial_entity_bound_anchor	이 확장 프로그램을 사용하면 애플리케이션이 공간 항목에 앵커를 만들고 연결할 수 있습니다. 권한: SCENE_UNDERSTANDING_COARSE	v3
XR_ANDROID_spatial_object_tracking	이 확장 프로그램은 XR_EXT_spatial_entity를 기반으로 하며 애플리케이션의 입력 데이터 세트가 필요 없이 사전 정의된 실제 객체 집합을 추적하는 공간 기능을 정의합니다. 권한: SCENE_UNDERSTANDING_COARSE	v3
XR_ANDROID_trackables	이 확장 프로그램을 사용하면 애플리케이션이 실제 환경의 추적 가능 항목에 액세스할 수 있습니다. 권한: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_trackables_image	이 확장 프로그램을 사용하면 입력 참조 이미지 세트로 지정된 평면 이미지를 추적할 수 있습니다. 권한: SCENE_UNDERSTANDING_COARSE	v3
XR_ANDROID_trackables_marker	이 확장 프로그램은 실제 마커 추적을 사용 설정합니다. 권한: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_trackables_object	이 확장 프로그램은 실제 객체 추적을 지원합니다. 권한: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_trackables_qr_code	이 확장 프로그램을 사용하면 실제 QR 코드 추적 및 QR 코드 데이터 디코딩이 가능합니다. 권한: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_unbounded_reference_space	이 확장 프로그램을 사용하면 애플리케이션이 XR_REFERENCE_SPACE_TYPE_UNBOUNDED_ANDROID 참조 공간을 만들 수 있습니다.	v1

서드 파티 확장 프로그램

확장 프로그램 이름	설명	Spatial API 버전
XR_MND_headless	일부 애플리케이션은 디스플레이에 이미지 콘텐츠를 표시하지 않고 XR 상호작용 기기에 액세스해야 할 수 있습니다.	v1
XR_KHR_binding_modification	이 확장 프로그램은 xrSuggestInteractionProfileBindings에 전달된 XrInteractionProfileSuggestedBinding::next 체인에 포함하여 기본 바인딩 동작을 수정하는 추가 정보를 지정할 수 있는 선택적 구조를 추가합니다.	v1
XR_EXT_debug_utils	OpenXR 인터페이스의 특성상 개발자와 애플리케이션이 사용할 수 있는 오류 정보가 거의 없습니다.	v1
XR_EXT_hand_tracking	이 확장 프로그램을 사용하면 애플리케이션이 핸드 트래킹 입력의 개별 조인트를 찾을 수 있습니다. 권한: HAND_TRACKING	v1
XR_EXT_performance_settings	이 확장 프로그램은 애플리케이션이 런타임에 성능 힌트를 제공하고 런타임이 성능 관련 알림을 애플리케이션에 다시 전송하는 API를 정의합니다. 이를 통해 양쪽 모두 필요한 CPU 및 GPU 성능, 열 지속 가능성, 세션 전반에 걸친 일관된 우수한 사용자 환경 간에 적절한 절충안을 선택할 수 있습니다.	v1
XR_FB_display_refresh_rate	디스플레이 화면 재생 빈도를 동적으로 조정할 수 있는 플랫폼	v1
XR_FB_swapchain_update_state	이 확장 프로그램을 사용하면 애플리케이션이 스왑체인과 연결된 특정 변경 가능한 상태를 수정하고 쿼리할 수 있습니다.	v1
XR_FB_foveation	XR 맥락에서의 포비에이션은 눈의 초점 또는 중심와 근처의 이미지 영역이 주변 영역보다 높은 해상도로 표시되도록 하는 렌더링 기법입니다.	v1
XR_FB_foveation_configuration	Facebook HMD에서 개발자는 광학 속성 및 성능을 위해 런타임에서 생성된 시선 추적 프로필을 만들 수 있습니다.	v1
XR_FB_foveation_vulkan	Vulkan 그래픽 API에서는 시선 추적 패턴을 적용하기 위해 이미지를 스왑체인에 적용해야 합니다.	v1
XR_FB_space_warp	이 확장 프로그램은 애플리케이션에서 스페이스 워프 기술을 사용 설정하는 지원을 제공합니다.	v1
XR_KHR_opengl_es_enable	이 확장 프로그램은 렌더링을 위해 OpenGL ES API를 사용하는 애플리케이션을 지원하는 런타임에서 제공해야 합니다.	v1
XR_KHR_android_create_instance	애플리케이션이 Android 시스템에서 XrInstance 객체를 생성할 때	v1
XR_KHR_android_surface_swapchain	XR의 일반적인 활동은 이미지 스트림을 보는 것입니다.	v1
XR_KHR_android_thread_settings	XR이 편안하려면 애플리케이션이 프레임을 빠르고 일관되게 제공해야 합니다.	v1
XR_KHR_composition_layer_color_scale_bias	색상 스케일과 바이어스는 컴포지션 중에 레이어 색상에 적용되며, 이는 미리 곱한 알파 표현으로 변환된 후입니다.	v1
XR_KHR_composition_layer_cube	이 확장 프로그램은 큐브맵에서 직접 샘플링할 수 있는 추가 레이어 유형을 추가합니다.	v1
XR_KHR_composition_layer_cylinder	이 확장 프로그램은 XR 런타임이 스왑체인에서 비롯된 텍스처를 실린더 섹션 내부에 매핑해야 하는 추가 레이어 유형을 추가합니다. 시청자에게 곡선형 텔레비전 디스플레이가 보이는 방식과 매우 유사하다고 생각하면 됩니다.	v1
XR_KHR_composition_layer_depth	이 확장 프로그램은 애플리케이션이 투영 레이어에서 컬러 이미지와 함께 깊이 이미지를 제출할 수 있도록 하는 추가 레이어 유형을 정의합니다.	v1
XR_KHR_composition_layer_equirect	이 확장 프로그램은 XR 런타임이 스왑체인에서 비롯된 등각 투영법으로 코딩된 이미지를 구의 내부에 매핑해야 하는 추가 레이어 유형을 추가합니다.	v1
XR_KHR_composition_layer_equirect2	이 확장 프로그램은 XR 런타임이 스왑체인에서 비롯된 equirectangular 코딩 이미지를 구의 내부에 매핑해야 하는 추가 레이어 유형을 추가합니다. 이 확장 프로그램은 XR_KHR_composition_layer_cylinder의 공식과 더 일치하는 다른 매개변수화를 사용하지만 기능적으로 XR_KHR_composition_layer_equirect와 동일합니다.	v1
XR_KHR_convert_timespec_time	이 확장 프로그램은 timespec 단조 시간과 XrTime 간에 변환하는 두 가지 함수를 제공합니다.	v1
XR_KHR_vulkan_enable	이 확장 프로그램은 OpenXR 런타임에서 Vulkan 그래픽 API를 사용할 수 있도록 지원합니다.	v1
XR_KHR_vulkan_enable2	이 확장 프로그램을 사용하면 OpenXR 런타임에서 Vulkan 그래픽 API를 사용할 수 있습니다.	v1
XR_KHR_loader_init	일부 플랫폼에서는 로드가 발생하기 전에 플랫폼별 매개변수로 로더를 초기화해야 합니다.	v1
XR_KHR_loader_init_android	Android에서 일부 로더 구현에서는 애플리케이션이 초기화 시 추가 정보를 제공해야 합니다.	v1
XR_KHR_swapchain_usage_input_attachment_bit	이 확장 프로그램을 사용하면 애플리케이션이 스왑체인 이미지가 입력 첨부파일로 사용될 수 있는 방식으로 생성되어야 한다고 지정할 수 있습니다. 이 부분은 작성 시점에 Vulkan 스왑체인에만 영향을 미칩니다.	v1
XR_EXT_dpad_binding	이 확장 프로그램을 사용하면 애플리케이션이 바인딩을 제안할 추가 구성요소 경로를 정의하여 트랙패드나 엄지 스틱을 D패드인 것처럼 하나 이상의 디지털 작업에 바인딩할 수 있습니다.	v1
XR_EXT_uuid	이 확장 프로그램은 RFC 4122를 따르는 범용 고유 식별자를 정의합니다.	v1
XR_FB_composition_layer_depth_test	이 확장 프로그램은 깊이 테스트를 거친 레이어 구성을 지원합니다.	v1
XR_EXT_eye_gaze_interaction	이 확장 프로그램은 시선 추적기에서 시선 입력을 가져와 시선 상호작용을 지원하는 XrPath를 제공합니다. 권한: EYE_TRACKING_FINE	v1
XR_EXT_hand_interaction	이 확장 프로그램은 핸드 트래킹 기기와 모션 컨트롤러 기기를 모두 포함한 모든 사용자 손 상호작용 프로필에 대해 흔히 사용되는 네 가지 동작 포즈를 정의합니다.	v1
XR_KHR_visibility_mask	이 확장 프로그램은 애플리케이션에 뷰별 그리기 마스크를 제공하는 것을 지원합니다.	v1
XR_META_foveation_eye_tracked	시선 추적 포비에이트 렌더링은 사용자의 시선 주변에 더 낮은 픽셀 밀도를 렌더링합니다. 권한: EYE_TRACKING_FINE	v1
XR_FB_hand_tracking_aim	XR_EXT_hand_tracking 확장 프로그램은 추적된 손의 현재 구성을 나타내는 손 관절 포즈 목록을 제공합니다. 이 확장 프로그램은 시스템에서 사용하는 동작 인식 레이어를 추가합니다. 권한: HAND_TRACKING	v1
XR_EXT_palm_pose	이 확장 프로그램은 상호작용 프로필을 위한 새로운 '표준 포즈 식별자'를 정의하며, 이름은 'palm_ext'입니다.	v1
XR_VARJO_foveated_rendering	Varjo 헤드셋은 디스플레이의 중앙 영역에 매우 높은 픽셀 밀도 디스플레이를 제공합니다. 권한: EYE_TRACKING_FINE	v1
XR_VARJO_quad_views	이 확장 프로그램은 런타임이 4개의 뷰포트를 지원함을 나타내기 위해 xrEnumerateViewConfigurations에서 반환할 수 있는 새 뷰 구성 유형 XR_VIEW_CONFIGURATION_TYPE_PRIMARY_QUAD_VARJO을 XrViewConfigurationType에 추가합니다.	v1
XR_META_vulkan_swapchain_create_info	이 확장 프로그램을 사용하면 Vulkan 기반 애플리케이션이 xrCreateSwapchain을 호출할 때 XrVulkanSwapchainCreateInfoMETA 구조체를 XrSwapchainCreateInfo에 연결하여 추가 VkImageCreateFlags 또는 VkImageUsageFlags를 전달할 수 있습니다.	v1
XR_FB_hand_tracking_mesh	XR_EXT_hand_tracking 확장 프로그램은 손 관절 포즈 목록을 제공하지만 스킨된 손 메시를 렌더링하는 메커니즘은 제공하지 않습니다. 권한: HAND_TRACKING	v1
XR_FB_composition_layer_image_layout	이 확장 프로그램은 새로운 컴포지션 레이어 유형을 정의하지 않습니다.	v1
XR_KHR_maintenance1	XR_KHR_maintenance1에서는 원래 OpenXR 1.0 출시에서 의도적으로 누락되거나 간과된 사소한 기능 모음을 추가합니다.	v1
XR_FB_composition_layer_settings	이 확장 프로그램을 사용하면 애플리케이션이 컴포지션 레이어에서 선명화 또는 슈퍼 샘플링과 같은 처리 옵션의 사용을 요청할 수 있습니다.	v1
XR_KHR_locate_spaces	이 확장 프로그램은 xrLocateSpacesKHR 함수를 도입합니다.	v1
XR_EXT_local_floor	핵심 OpenXR 사양에는 XrReferenceSpaceType에 두 가지 월드 고정 참조 공간 XrSpace 유형이 포함되어 있습니다.	v1
XR_EXT_spatial_marker_tracking	이 확장 프로그램은 XR_EXT_spatial_entity를 기반으로 하며 애플리케이션이 환경에서 마커를 감지하고 추적할 수 있도록 지원합니다. 권한: SCENE_UNDERSTANDING_COARSE	v1
XR_EXT_spatial_persistence	이 확장 프로그램을 사용하면 애플리케이션이 애플리케이션 세션 전반에서 공간 항목을 검색하고 상호 연관시킬 수 있습니다. 권한: SCENE_UNDERSTANDING_COARSE	v1
XR_EXT_spatial_anchor	이 확장 프로그램은 XR_EXT_spatial_entity를 기반으로 하며 애플리케이션이 공간 앵커를 만들 수 있도록 지원합니다. 권한: SCENE_UNDERSTANDING_COARSE	v1
XR_EXT_spatial_plane_tracking	이 확장 프로그램은 XR_EXT_spatial_entity를 기반으로 하며 공간 엔티티 프레임워크의 평면 추적 공간 기능을 정의합니다.	v1
XR_EXT_spatial_entity	이 확장 프로그램은 OpenXR에서 장면 이해와 공간 추론을 위한 개념과 기반을 도입합니다.	v1
XR_EXT_future	XR 시스템에는 장기 실행되고 일반 프레임 루프 내에서 합리적으로 완료되지 않는 특정 작업이 있습니다.	v1
XR_FB_color_space	XR 기기는 개발에 사용되는 많은 모니터와 다른 색상 공간을 사용할 수 있습니다.	v1
XR_EXT_composition_layer_inverted_alpha	이 확장 프로그램은 컴포지션 레이어에 적용될 때 레이어의 스왑체인 이미지에서 알파 값의 해석을 반전시키는 플래그를 제공합니다.	v1
XR_EXT_frame_synthesis	이 확장 프로그램은 추가 애플리케이션 제공 데이터를 기반으로 애플리케이션에서 프레임 합성 기능을 사용 설정할 수 있도록 지원합니다.	v3
XR_QCOM_trackables_image_operations	추적 가능 항목에 Qualcomm 이미지 추적 작업을 제공합니다.	v3
XR_QCOM_trackables_qr_code_operations	추적 대상의 Qualcomm QR 코드 추적 작업을 제공합니다.	v3
XR_EXT_user_presence	이 확장 프로그램은 시스템에서 사용자 존재 변경을 감지할 때 알리는 새로운 이벤트를 도입합니다.	v3
XR_KHR_extended_struct_name_lengths	이 확장 프로그램은 최대 구조체 이름 크기를 확장하고 이러한 새로운 확장 이름에 액세스하는 새로운 함수를 제공합니다.	v3
XR_EXT_interaction_profile_battery_state_display	XR_EXT_interaction_profile_battery_state_display는 애플리케이션이 상호작용 프로필과 함께 사용되는 기기의 배터리 상태 정보를 런타임에 쿼리하는 메커니즘을 제공합니다.	v3

---

OpenXR™ 및 OpenXR 로고는 The Khronos Group Inc. 소유의 상표이며 중국, 유럽 연합, 일본, 영국에 상표로 등록되어 있습니다.