Tạo bản dựng bằng các tiện ích OpenXR được hỗ trợ

Các thiết bị XR được hỗ trợ

Hướng dẫn này giúp bạn xây dựng các trải nghiệm cho những loại thiết bị XR sau.

Tìm hiểu về các loại thiết bị XR →

Thiết bị đeo đầu XR

Kính thông minh XR có dây

Tìm hiểu về các loại thiết bị XR →

Android XR hỗ trợ OpenXR thông qua quy cách OpenXR 1.1 và một danh sách dài các tiện ích của nhà cung cấp bên thứ ba. Việc sử dụng các tiện ích này mang đến cho bạn trải nghiệm quen thuộc khi phát triển cho XR. Một số chức năng trong số này yêu cầu quyền khi bắt đầu chạy trên Android. Nếu muốn tạo trực tiếp trên API OpenXR, bạn có thể tìm thấy các tệp tiêu đề cần thiết trong kho lưu trữ jetpack-xr-natives.

Lưu ý: Cột Phiên bản Spatial API cho biết phiên bản phát hành của Spatial API mà trong đó có hỗ trợ cho một tiện ích. Bạn nên kiểm tra xem một tính năng có trên thiết bị mục tiêu hay không bằng cách sử dụng các tiện ích OpenXR có hỗ trợ tính năng (chẳng hạn như XR_ANDROID_enumerate_system_extension_properties).

Tiện ích của nhà cung cấp Android XR

Tên tiện ích	Mô tả	Phiên bản Spatial API
XR_ANDROID_anchor_sharing_export	Các điểm neo do một ứng dụng tạo thông qua XR_ANDROID_trackables, XR_EXT_spatial_anchor và XR_ANDROID_spatial_anchor_space được liên kết với một phiên cụ thể và do đó không hiển thị cho các ứng dụng khác. Tiện ích này cho phép các ứng dụng chia sẻ điểm neo với các ứng dụng khác đang chạy.	v1
XR_ANDROID_body_tracking	Sử dụng IK để xác định vị trí cơ thể dựa trên vị trí đầu và tay. Quyền: Body Tracking	v2
XR_ANDROID_composition_layer_passthrough_mesh	Dành cho những thiết bị hỗ trợ nhiều chế độ kết hợp môi trường. Quyền: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_depth_texture	Tiện ích này cho phép ứng dụng yêu cầu bản đồ độ sâu của môi trường thực tế xung quanh tai nghe và truy vấn độ phân giải độ sâu được hỗ trợ khi tạo. Quyền: SCENE_UNDERSTANDING_FINE	v1
XR_ANDROID_device_anchor_persistence	Tiện ích này cho phép ứng dụng duy trì hoạt động. Quyền: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_enumerate_system_extension_properties	Tiện ích này cho phép các ứng dụng xác định những tiện ích được cấu hình hệ thống hiện tại hỗ trợ.	v3
XR_ANDROID_eye_tracking	Tiện ích này cho phép các ứng dụng lấy vị trí và hướng của mắt người dùng, cũng như trạng thái theo dõi ánh mắt. Quyền: EYE_TRACKING_FINE	v1
XR_ANDROID_face_tracking	Tiện ích này cho phép các ứng dụng lấy trọng số của hình dạng kết hợp và hiển thị biểu cảm khuôn mặt trong trải nghiệm XR. Quyền: FACE_TRACKING	v1
XR_ANDROID_face_tracking_data_source	Tiện ích này cho phép các ứng dụng lấy dữ liệu theo dõi khuôn mặt từ nhiều nguồn dữ liệu. Quyền: FACE_TRACKING, RECORD_AUDIO	v3
XR_ANDROID_hand_mesh	Tiện ích này cho phép các thao tác nhập bằng cách theo dõi cử động của tay được biểu thị dưới dạng một lưới tay động. Quyền: HAND_TRACKING	v1
XR_ANDROID_light_estimation	Tiện ích này cho phép ứng dụng yêu cầu dữ liệu thể hiện ánh sáng của môi trường thực tế xung quanh tai nghe. Quyền: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_light_estimation_cubemap	Tiện ích này được xây dựng dựa trên tiện ích XR_ANDROID_light_estimation cơ bản. Quyền: SCENE_UNDERSTANDING_FINE	v3
XR_ANDROID_mouse_interaction	Tiện ích này cung cấp một XrPath để nhận thao tác đầu vào bằng chuột và xác định một tư thế hành động thường dùng cho hồ sơ chuột của người dùng, bao gồm cả thiết bị chuột và thiết bị bàn di chuột.	v1
XR_ANDROID_passthrough_camera_state	Camera truyền qua có thể mất một khoảng thời gian để khởi động và có thể không hoạt động ngay lập tức.	v1
XR_ANDROID_performance_metrics	Tiện ích này cung cấp các API để liệt kê và truy vấn nhiều bộ đếm chỉ số hiệu suất của thiết bị XR hiện tại.	v1
XR_ANDROID_raycast	Tiện ích này cho phép ứng dụng thực hiện các thao tác truyền tia đối với các đối tượng có thể theo dõi trong môi trường. Quyền: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_recommended_resolution	Tiện ích này cho phép thời gian chạy thông báo cho ứng dụng khi độ phân giải được đề xuất thay đổi.	v1
XR_ANDROID_recommended_settings	Môi trường mặc định của người dùng có thể: ở nhiều trạng thái bằng cách kết hợp chế độ hoà trộn và phương thức nhập.	v1
XR_ANDROID_scene_meshing	Tiện ích này nhằm cung cấp các lưới đại diện gần đúng cho các đối tượng thực trong môi trường của người dùng.	v1
XR_ANDROID_spatial_anchor_space	Hàm xrCreateSpatialAnchorEXT được xác định trong tiện ích XR_EXT_spatial_anchor cho phép các ứng dụng tạo neo không gian bằng một giá trị nhận dạng XrSpatialEntityEXT để biểu thị neo đó. Ngược lại, tiện ích này tạo một neo không gian được biểu thị bằng một đối tượng xử lý XrSpace. Quyền: SCENE_UNDERSTANDING_COARSE	v3
XR_ANDROID_spatial_annotation_tracking	Tiện ích này cung cấp khả năng theo dõi chú thích cho tiện ích XR_EXT_spatial_entity để theo dõi nhiều chú thích trong cảnh. Thư viện này cho phép các ứng dụng đặt lớp phủ lên các đối tượng thực hoặc ảo do các tham chiếu thời gian chạy xác định. Quyền: SCENE_UNDERSTANDING_FINE	v3
XR_ANDROID_spatial_component_subsumed_by	Tiện ích này dựa trên XR_EXT_spatial_entity và cung cấp một thành phần mới cho XR_SPATIAL_CAPABILITY_PLANE_TRACKING_EXT để hiển thị XrSpatialEntityIdEXT bao gồm thực thể hiện tại. Quyền: SCENE_UNDERSTANDING_COARSE	v3
XR_ANDROID_spatial_discovery_raycast	Tiện ích này được xây dựng dựa trên XR_EXT_spatial_entity và cung cấp chức năng truyền tia cho các chức năng không gian hiện có. Quyền: SCENE_UNDERSTANDING_FINE	v3
XR_ANDROID_spatial_entity_bound_anchor	Tiện ích này cho phép các ứng dụng tạo và đính kèm các điểm neo vào các thực thể không gian. Quyền: SCENE_UNDERSTANDING_COARSE	v3
XR_ANDROID_spatial_object_tracking	Tiện ích này dựa trên XR_EXT_spatial_entity và xác định khả năng không gian để theo dõi một tập hợp các đối tượng thực được xác định trước mà không cần tập dữ liệu đầu vào từ ứng dụng. Quyền: SCENE_UNDERSTANDING_COARSE	v3
XR_ANDROID_trackables	Tiện ích này cho phép ứng dụng truy cập vào các đối tượng có thể theo dõi trong môi trường thực tế. Quyền: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_trackables_image	Tiện ích này cho phép theo dõi hình ảnh phẳng theo quy định của các nhóm hình ảnh tham chiếu đầu vào. Quyền: SCENE_UNDERSTANDING_COARSE	v3
XR_ANDROID_trackables_marker	Tiện ích này cho phép theo dõi điểm đánh dấu thực tế. Quyền: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_trackables_object	Tiện ích này cho phép theo dõi đối tượng thực. Quyền: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_trackables_qr_code	Tiện ích này cho phép theo dõi mã QR thực và giải mã dữ liệu mã QR. Quyền: SCENE_UNDERSTANDING_COARSE	v1
XR_ANDROID_unbounded_reference_space	Tiện ích này cho phép các ứng dụng tạo một không gian tham chiếu XR_REFERENCE_SPACE_TYPE_UNBOUNDED_ANDROID.	v1

Tiện ích của bên thứ ba

Tên tiện ích	Mô tả	Phiên bản Spatial API
XR_MND_headless	Một số ứng dụng có thể cần truy cập vào các thiết bị tương tác XR mà không hiển thị nội dung hình ảnh nào trên màn hình.	v1
XR_KHR_binding_modification	Tiện ích này thêm một cấu trúc không bắt buộc có thể được đưa vào chuỗi XrInteractionProfileSuggestedBinding::next được truyền đến xrSuggestInteractionProfileBindings để chỉ định thông tin bổ sung nhằm sửa đổi hành vi liên kết mặc định.	v1
XR_EXT_debug_utils	Do tính chất của giao diện OpenXR, nhà phát triển và ứng dụng có rất ít thông tin về lỗi.	v1
XR_EXT_hand_tracking	Tiện ích này cho phép các ứng dụng xác định vị trí của từng khớp trong dữ liệu đầu vào theo dõi cử động của tay. Quyền: HAND_TRACKING	v1
XR_EXT_performance_settings	Tiện ích này xác định một API để ứng dụng đưa ra gợi ý về hiệu suất cho thời gian chạy và để thời gian chạy gửi thông báo liên quan đến hiệu suất trở lại ứng dụng. Điều này cho phép cả hai bên điều chỉnh một giải pháp thoả hiệp phù hợp giữa hiệu suất CPU và GPU cần thiết, khả năng duy trì nhiệt độ và trải nghiệm nhất quán, tốt cho người dùng trong suốt phiên.	v1
XR_FB_display_refresh_rate	Trên những nền tảng hỗ trợ việc điều chỉnh tốc độ làm mới màn hình một cách linh hoạt.	v1
XR_FB_swapchain_update_state	Tiện ích này cho phép ứng dụng sửa đổi và truy vấn trạng thái có thể thay đổi cụ thể được liên kết với một swapchain.	v1
XR_FB_foveation	Trong bối cảnh thực tế mở rộng (XR), foveation là một kỹ thuật kết xuất cho phép hiển thị vùng của hình ảnh gần tiêu điểm hoặc hố mắt của mắt ở độ phân giải cao hơn so với các vùng ở ngoại vi.	v1
XR_FB_foveation_configuration	Trên HMD của Facebook, nhà phát triển có thể tạo các hồ sơ lấy nét được tạo bởi thời gian chạy cho các đặc tính quang học và hiệu suất.	v1
XR_FB_foveation_vulkan	API đồ hoạ Vulkan yêu cầu phải áp dụng một hình ảnh cho chuỗi hoán đổi để áp dụng một mẫu foveation.	v1
XR_FB_space_warp	Tiện ích này hỗ trợ bật công nghệ làm cong không gian trên ứng dụng.	v1
XR_KHR_opengl_es_enable	Môi trường thời gian chạy hỗ trợ các ứng dụng sử dụng API OpenGL ES để kết xuất phải cung cấp tiện ích này.	v1
XR_KHR_android_create_instance	Khi ứng dụng tạo một đối tượng XrInstance trên hệ thống Android.	v1
XR_KHR_android_surface_swapchain	Một hoạt động thường gặp trong XR là xem luồng hình ảnh.	v1
XR_KHR_android_thread_settings	Để XR hoạt động thoải mái, các ứng dụng cần phân phối khung hình một cách nhanh chóng và nhất quán.	v1
XR_KHR_composition_layer_color_scale_bias	Thang màu và độ lệch được áp dụng cho màu của lớp trong quá trình kết hợp, sau khi chuyển đổi thành biểu diễn alpha nhân trước.	v1
XR_KHR_composition_layer_cube	Tiện ích này bổ sung thêm một loại lớp cho phép lấy mẫu trực tiếp từ cubemap.	v1
XR_KHR_composition_layer_cylinder	Tiện ích này thêm một loại lớp bổ sung mà thời gian chạy XR phải ánh xạ một hoạ tiết bắt nguồn từ một chuỗi hoán đổi lên bên trong một phần hình trụ. Bạn có thể hình dung điều này tương tự như cách một màn hình TV cong xuất hiện trước mắt người xem.	v1
XR_KHR_composition_layer_depth	Tiện ích này xác định một loại lớp bổ sung cho phép các ứng dụng gửi hình ảnh độ sâu cùng với hình ảnh màu trong các lớp chiếu.	v1
XR_KHR_composition_layer_equirect	Tiện ích này thêm một loại lớp bổ sung mà thời gian chạy XR phải ánh xạ một hình ảnh được mã hoá theo hình chữ nhật đều bắt nguồn từ một chuỗi hoán đổi lên bên trong một hình cầu.	v1
XR_KHR_composition_layer_equirect2	Tiện ích này thêm một loại lớp bổ sung mà thời gian chạy XR phải ánh xạ một hình ảnh được mã hoá theo hình chữ nhật đều bắt nguồn từ một chuỗi hoán đổi lên bên trong một hình cầu. Tiện ích này sử dụng một cách tham số hoá khác phù hợp hơn với công thức của XR_KHR_composition_layer_cylinder nhưng có chức năng tương đương với XR_KHR_composition_layer_equirect.	v1
XR_KHR_convert_timespec_time	Tiện ích này cung cấp 2 hàm để chuyển đổi giữa thời gian đơn điệu timespec và XrTime.	v1
XR_KHR_vulkan_enable	Tiện ích này cho phép sử dụng API đồ hoạ Vulkan trong thời gian chạy OpenXR.	v1
XR_KHR_vulkan_enable2	Tiện ích này cho phép sử dụng API đồ hoạ Vulkan trong thời gian chạy OpenXR.	v1
XR_KHR_loader_init	Trên một số nền tảng, trước khi tải, trình tải phải được khởi chạy bằng các thông số dành riêng cho nền tảng.	v1
XR_KHR_loader_init_android	Trên Android, một số phương thức triển khai trình tải cần ứng dụng cung cấp thêm thông tin khi khởi chạy.	v1
XR_KHR_swapchain_usage_input_attachment_bit	Tiện ích này cho phép một ứng dụng chỉ định rằng hình ảnh trong chuỗi hoán đổi phải được tạo theo cách để có thể dùng làm tệp đính kèm đầu vào. Tại thời điểm viết, đoạn mã này chỉ ảnh hưởng đến các chuỗi trao đổi Vulkan.	v1
XR_EXT_dpad_binding	Tiện ích này cho phép ứng dụng liên kết một hoặc nhiều thao tác kỹ thuật số với bàn di chuột hoặc cần điều khiển như thể đó là một d-pad bằng cách xác định các đường dẫn thành phần bổ sung để đề xuất các liên kết.	v1
XR_EXT_uuid	Tiện ích này xác định một Giá trị nhận dạng duy nhất trên toàn cầu tuân theo RFC 4122.	v1
XR_FB_composition_layer_depth_test	Tiện ích này cho phép tạo thành phần lớp đã kiểm thử độ sâu.	v1
XR_EXT_eye_gaze_interaction	Tiện ích này cung cấp một XrPath để nhận dữ liệu đầu vào về ánh mắt từ thiết bị theo dõi ánh mắt nhằm cho phép các hoạt động tương tác bằng ánh mắt. Quyền: EYE_TRACKING_FINE	v1
XR_EXT_hand_interaction	Tiện ích này xác định 4 tư thế hành động thường dùng cho tất cả hồ sơ tương tác bằng tay của người dùng, bao gồm cả thiết bị theo dõi cử động của tay và thiết bị điều khiển chuyển động.	v1
XR_KHR_visibility_mask	Tiện ích này hỗ trợ việc cung cấp mặt nạ vẽ cho từng khung hiển thị cho các ứng dụng.	v1
XR_META_foveation_eye_tracked	Tính năng kết xuất tập trung theo ánh mắt kết xuất mật độ điểm ảnh thấp hơn ở vùng ngoại vi của ánh mắt người dùng. Quyền: EYE_TRACKING_FINE	v1
XR_FB_hand_tracking_aim	Tiện ích XR_EXT_hand_tracking cung cấp danh sách các tư thế khớp bàn tay, thể hiện cấu hình hiện tại của bàn tay được theo dõi. Tiện ích này bổ sung một lớp nhận dạng cử chỉ mà hệ thống sử dụng. Quyền: HAND_TRACKING	v1
XR_EXT_palm_pose	Tiện ích này xác định một "mã nhận dạng tư thế chuẩn" mới cho hồ sơ tương tác, có tên là "palm_ext".	v1
XR_VARJO_foveated_rendering	Tai nghe Varjo cung cấp màn hình có mật độ điểm ảnh cực cao ở khu vực trung tâm của màn hình. Quyền: EYE_TRACKING_FINE	v1
XR_VARJO_quad_views	Tiện ích này thêm một loại cấu hình khung hiển thị mới – XR_VIEW_CONFIGURATION_TYPE_PRIMARY_QUAD_VARJO vào XrViewConfigurationType. Loại này có thể được xrEnumerateViewConfigurations trả về để cho biết rằng thời gian chạy hỗ trợ 4 khung hiển thị.	v1
XR_META_vulkan_swapchain_create_info	Khi sử dụng tiện ích này, một ứng dụng dựa trên Vulkan có thể truyền thêm VkImageCreateFlags hoặc VkImageUsageFlags bằng cách liên kết một cấu trúc XrVulkanSwapchainCreateInfoMETA với XrSwapchainCreateInfo khi gọi xrCreateSwapchain.	v1
XR_FB_hand_tracking_mesh	Phần mở rộng XR_EXT_hand_tracking cung cấp danh sách các tư thế khớp bàn tay nhưng không có cơ chế để kết xuất lưới bàn tay có vỏ. Quyền: HAND_TRACKING	v1
XR_FB_composition_layer_image_layout	Tiện ích này không xác định một loại lớp thành phần mới.	v1
XR_KHR_maintenance1	XR_KHR_maintenance1 bổ sung một bộ sưu tập các tính năng nhỏ mà ban đầu đã bị bỏ qua hoặc bỏ sót trong bản phát hành OpenXR 1.0.	v1
XR_FB_composition_layer_settings	Tiện ích này cho phép các ứng dụng yêu cầu sử dụng các lựa chọn xử lý như làm sắc nét hoặc lấy mẫu siêu dữ liệu trên một lớp thành phần.	v1
XR_KHR_locate_spaces	Tiện ích này giới thiệu hàm xrLocateSpacesKHR.	v1
XR_EXT_local_floor	Quy cách OpenXR cốt lõi chứa 2 loại không gian tham chiếu cố định theo thế giới XrSpace trong XrReferenceSpaceType.	v1
XR_EXT_spatial_marker_tracking	Tiện ích này dựa trên XR_EXT_spatial_entity và cho phép các ứng dụng phát hiện cũng như theo dõi điểm đánh dấu trong môi trường của chúng. Quyền: SCENE_UNDERSTANDING_COARSE	v1
XR_EXT_spatial_persistence	Tiện ích này cho phép các ứng dụng khám phá và tương quan các thực thể không gian trong các phiên ứng dụng. Quyền: SCENE_UNDERSTANDING_COARSE	v1
XR_EXT_spatial_anchor	Tiện ích này dựa trên XR_EXT_spatial_entity và cho phép các ứng dụng tạo neo không gian. Quyền: SCENE_UNDERSTANDING_COARSE	v1
XR_EXT_spatial_plane_tracking	Tiện ích này dựa trên XR_EXT_spatial_entity và xác định khả năng không gian theo dõi mặt phẳng cho khung thực thể không gian.	v1
XR_EXT_spatial_entity	Tiện ích này giới thiệu các khái niệm và nền tảng để hiểu cảnh và suy luận không gian trong OpenXR.	v1
XR_EXT_future	Trong các hệ thống XR, có một số thao tác diễn ra trong thời gian dài và không hoàn tất một cách hợp lý trong một vòng lặp khung hình thông thường.	v1
XR_FB_color_space	Các thiết bị XR có thể sử dụng một hệ màu khác với nhiều màn hình được dùng trong quá trình phát triển.	v1
XR_EXT_composition_layer_inverted_alpha	Tiện ích này cung cấp một cờ. Khi được áp dụng cho một lớp thành phần, cờ này sẽ đảo ngược cách diễn giải giá trị alpha trong hình ảnh chuỗi hoán đổi của lớp.	v1
XR_EXT_frame_synthesis	Tiện ích này hỗ trợ bật tính năng tổng hợp khung hình trên các ứng dụng dựa trên dữ liệu bổ sung do ứng dụng cung cấp.	v3
XR_QCOM_trackables_image_operations	Cung cấp các thao tác theo dõi hình ảnh của Qualcomm cho các đối tượng có thể theo dõi.	v3
XR_QCOM_trackables_qr_code_operations	Cung cấp các thao tác theo dõi mã QR của Qualcomm cho các đối tượng có thể theo dõi.	v3
XR_EXT_user_presence	Tiện ích này giới thiệu một sự kiện mới để thông báo khi hệ thống phát hiện thấy sự thay đổi về trạng thái hoạt động của người dùng.	v3
XR_KHR_extended_struct_name_lengths	Tiện ích này mở rộng kích thước tên cấu trúc tối đa và cung cấp một hàm mới để truy cập vào các tên mở rộng mới này.	v3
XR_EXT_interaction_profile_battery_state_display	XR_EXT_interaction_profile_battery_state_display cung cấp một cơ chế để các ứng dụng truy vấn thời gian chạy để biết thông tin về trạng thái pin của các thiết bị được dùng với hồ sơ tương tác.	v3

---

OpenXR™ và biểu trưng OpenXR là các nhãn hiệu thuộc sở hữu của The Khronos Group Inc. và được đăng ký làm nhãn hiệu ở Trung Quốc, Liên minh Châu Âu, Nhật Bản và Vương quốc Anh.