使用支援的 OpenXR 擴充功能進行建構

適用 XR 裝置
這份指南可協助您為這類 XR 裝置打造體驗。
XR 頭戴式裝置
有線 XR 眼鏡

Android XR 透過 OpenXR 1.1 規格和一長串的第三方供應商擴充功能支援 OpenXR。使用這些擴充功能,您就能在開發 XR 應用程式時,享有熟悉的使用體驗。其中有些功能需要Android 執行階段權限。如要直接使用 OpenXR API 建構,請前往 jetpack-xr-natives 存放區,尋找所需的標頭檔案。

Android XR 供應商擴充功能

擴充功能名稱

說明

XR_ANDROID_composition_layer_passthrough_mesh

允許應用程式透過額外的合成層,將透視紋理投影到任意幾何體上。這項擴充功能需要 android.permission.SCENE_UNDERSTANDING_COARSE

XR_ANDROID_depth_texture

提供遮蔽、命中測試和其他特定工作的原始和平滑深度,這些工作會使用準確的場景幾何圖形,例如偵測偽造臉部。根據目前的攝影機/眼睛姿勢,提供低解析度的場景深度紋理和信賴度。這項擴充功能需要 android.permission.SCENE_UNDERSTANDING_FINE

XR_ANDROID_device_anchor_persistence

允許應用程式在目前的裝置上,跨應用程式和裝置工作階段保存、擷取及取消保存錨點。這項擴充功能需要 android.permission.SCENE_UNDERSTANDING_COARSE

XR_ANDROID_eye_tracking

允許應用程式取得使用者眼睛的位置和方向,讓虛擬人偶的眼睛姿勢和狀態呈現更逼真。請勿將這項擴充功能用於其他眼動追蹤用途。如要進行互動,請改用 XR_EXT_eye_gaze_interaction。這項擴充功能需要 android.permission.EYE_TRACKING_COARSEandroid.permission.EYE_TRACKING_FINE

XR_ANDROID_face_tracking

允許應用程式取得混合形狀的權重,並在延展實境體驗中算繪臉部表情。這項擴充功能需要 android.permission.FACE_TRACKING

XR_ANDROID_hand_mesh

啟用以動態手部網格表示的手部追蹤輸入內容。這項擴充功能旨在為使用者雙手的個人化呈現方式網格提供頂點和索引緩衝區。如要追蹤手部關節 XR_EXT_hand_tracking,以及進行互動 XR_EXT_hand_interaction,請使用這類追蹤器。這項擴充功能需要 android.permission.HAND_TRACKING

XR_ANDROID_light_estimation

估算使用者目前環境的環境照明 (包括球諧函數)。透過這項擴充功能,應用程式可要求取得頭戴式裝置周圍真實環境光照的資料。這項資訊可用於算繪虛擬物體,使這些物體的光照條件與其所處的場景相同。這項擴充功能需要 android.permission.SCENE_UNDERSTANDING_COARSE

XR_ANDROID_mouse_interaction

這項擴充功能會導入專為滑鼠裝置設計的新互動設定檔,透過 OpenXR 動作系統輸入內容。允許使用者滑鼠設定檔的常用動作姿勢,包括滑鼠裝置和觸控板裝置。這項功能的設計目的是在 3D 空間中透過滑鼠指標與物件互動。舉例來說,使用虛擬雷射筆對準牆上的虛擬按鈕,就適合「瞄準」姿勢。

XR_ANDROID_passthrough_camera_state

提供穿透模式攝影機的啟用、初始化或停用狀態。

XR_ANDROID_performance_metrics

這項擴充功能提供 API,可列舉及查詢目前 XR 裝置、合成器和 XR 應用程式的各種效能指標計數器。

XR_ANDROID_raycast

透過這項擴充功能,應用程式可對環境中的可追蹤物件執行光線投射。這項擴充功能需要 android.permission.SCENE_UNDERSTANDING_COARSE

XR_ANDROID_scene_meshing

應用程式可即時取得真實環境的語意 3D 網格。這項擴充功能需要 android.permission.SCENE_UNDERSTANDING_FINE

XR_ANDROID_trackables

這項擴充功能可讓應用程式存取實體環境中的可追蹤項目 (例如飛機),並建立附加至可追蹤項目的錨點。這項擴充功能需要 android.permission.SCENE_UNDERSTANDING_COARSE

XR_ANDROID_trackables_object

支援追蹤場景中的實體物件,例如鍵盤和滑鼠。這項擴充功能需要 android.permission.SCENE_UNDERSTANDING_COARSE

XR_ANDROID_trackables_qr_code

啟用實體 QR code 追蹤和 QR code 資料解碼。這項擴充功能需要 android.permission.SCENE_UNDERSTANDING

XR_ANDROID_unbounded_reference_space

提供不受限制的參照空間,可用於隨著時間推移,建構更完善的場景理解。這個參考空間可讓觀眾在複雜環境中自由移動 (通常距離起點好幾公尺),同時持續針對觀眾附近的座標系統穩定性進行最佳化。

其他支援的擴充功能

系統也支援下列額外擴充功能。資訊位於外部網站。


OpenXR™ 和 OpenXR 標誌是 The Khronos Group Inc. 的商標,已在中國、歐盟、日本和英國註冊為商標。