إنشاء المحتوى باستخدام إضافات OpenXR متوافقة

أجهزة XR المشمولة
تساعدك هذه الإرشادات في إنشاء تجارب لهذه الأنواع من أجهزة XR.
سماعات الرأس بنظام الواقع الممتد
نظارات سلكية بنظام الواقع الممتد

يتوافق Android XR مع OpenXR من خلال مواصفات OpenXR 1.1 وقائمة طويلة من إضافات المورّدين التابعين لجهات خارجية. يوفّر استخدام هذه الإضافات تجربة مألوفة عند تطوير تطبيقات XR. تتطلّب بعض هذه الإمكانات أذونات تشغيل Android. إذا كنت تريد إنشاء تطبيقات مباشرةً باستخدام واجهات برمجة تطبيقات OpenXR، يمكنك العثور على ملفات العناوين المطلوبة في مستودع jetpack-xr-natives.

إضافات Android XR الخاصة بالمورِّدين

اسم الإضافة

الوصف

إصدار Spatial API

XR_ANDROID_anchor_sharing_export

إنّ نقاط الارتكاز التي ينشئها تطبيق باستخدام XR_ANDROID_trackables مرتبطة بجلسة معيّنة، وبالتالي لا تظهر للمستخدمين الآخرين...

v1

XR_ANDROID_body_tracking

يستخدم IK لتحديد موضع الجسم استنادًا إلى موضع الرأس واليدين.
الأذونات: Body Tracking

الإصدار 2

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

تتيح هذه الإضافة للتطبيقات تحديد الإضافات المتوافقة مع إعدادات النظام الحالية.

إصدار 3

XR_ANDROID_eye_tracking

تتيح هذه الإضافة للتطبيقات الحصول على موضع واتجاه عيني المستخدم، بالإضافة إلى حالة تتبُّع العين.
الأذونات: EYE_TRACKING_FINE

v1

XR_ANDROID_face_tracking

يتيح هذا الامتداد للتطبيقات الحصول على أوزان أشكال المزج وعرض تعابير الوجه في تجارب الواقع الممتد.
الأذونات: FACE_TRACKING

v1

XR_ANDROID_face_tracking_data_source

تتيح هذه الإضافة للتطبيقات الحصول على بيانات تتبّع تعابير الوجه من مصادر بيانات متعددة.
الأذونات: FACE_TRACKING وRECORD_AUDIO

إصدار 3

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

إصدار 3

XR_ANDROID_mouse_interaction

يوفر هذا الامتداد XrPath للحصول على إدخال الماوس ويحدد وضعًا واحدًا شائع الاستخدام لإيماءات الماوس الخاصة بملفات المستخدمين...

v1

XR_ANDROID_passthrough_camera_state

قد يستغرق بدء تشغيل كاميرا العرض المباشر بعض الوقت، وقد لا تكون متاحة على الفور.

v1

XR_ANDROID_performance_metrics

يوفّر هذا الامتداد واجهات برمجة تطبيقات لتعداد عدّادات مقاييس الأداء المختلفة لجهاز XR الحالي والاستعلام عنها.

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

تسمح الدالة xrCreateSpatialAnchorEXT المحدّدة في إضافة XR_EXT_spatial_anchor للتطبيقات بإنشاء...
الأذونات: SCENE_UNDERSTANDING_COARSE

إصدار 3

XR_ANDROID_spatial_annotation_tracking

توفّر هذه الإضافة إمكانية تتبُّع التعليقات التوضيحية لإضافة <<XR_EXT_spatial_entity>> من أجل تتبُّع مختلف...
الأذونات: SCENE_UNDERSTANDING_FINE

إصدار 3

XR_ANDROID_spatial_component_subsumed_by

تستند هذه الإضافة إلى XR_EXT_spatial_entity وتوفّر مكوّنًا جديدًا لـ XR_SPATIAL_CAPABILITY_PLANE_TRACKING_EXT من أجل...
الأذونات: SCENE_UNDERSTANDING_COARSE

إصدار 3

XR_ANDROID_spatial_discovery_raycast

تستند هذه الإضافة إلى XR_EXT_spatial_entity وتوفّر وظيفة raycast للإمكانات المكانية الحالية.
الأذونات: SCENE_UNDERSTANDING_FINE

إصدار 3

XR_ANDROID_spatial_entity_bound_anchor

تسمح هذه الإضافة للتطبيقات بإنشاء نقاط ربط وإرفاقها بالكائنات المكانية.
الأذونات: SCENE_UNDERSTANDING_COARSE

إصدار 3

XR_ANDROID_spatial_object_tracking

تستند هذه الإضافة إلى XR_EXT_spatial_entity وتحدّد إمكانية مكانية لتتبُّع مجموعة من العناصر المادية المحدّدة مسبقًا...
الأذونات: SCENE_UNDERSTANDING_COARSE

إصدار 3

XR_ANDROID_trackables

تتيح هذه الإضافة للتطبيق الوصول إلى الأجهزة التي يمكن تتبُّعها من البيئة المحيطة.
الأذونات: SCENE_UNDERSTANDING_COARSE

v1

XR_ANDROID_trackables_image

تتيح هذه الإضافة تتبُّع الصور المستوية على النحو المحدّد من خلال مجموعات من الصور المرجعية المدخلة.
الأذونات: SCENE_UNDERSTANDING_COARSE

إصدار 3

XR_ANDROID_trackables_marker

تتيح هذه الإضافة تتبُّع العلامات المادية.
الأذونات: SCENE_UNDERSTANDING_COARSE

v1

XR_ANDROID_trackables_object

تتيح هذه الإضافة تتبُّع الكائنات المادية.
الأذونات: SCENE_UNDERSTANDING_COARSE

v1

XR_ANDROID_trackables_qr_code

يتيح هذا الامتداد تتبُّع رموز الاستجابة السريعة المادية وفك تشفير بيانات رموز الاستجابة السريعة.
الأذونات: SCENE_UNDERSTANDING_COARSE

v1

XR_ANDROID_unbounded_reference_space

يتيح هذا الامتداد للتطبيقات إنشاء مساحة مرجعية من النوع XR_REFERENCE_SPACE_TYPE_UNBOUNDED_ANDROID.

v1

الإضافات التابعة لجهات خارجية

اسم الإضافة

الوصف

إصدار Spatial API

XR_MND_headless

قد تحتاج بعض التطبيقات إلى الوصول إلى أجهزة التفاعل مع الواقع الممتد بدون عرض أي محتوى صور على الشاشة أو الشاشات.

v1

XR_KHR_binding_modification

تضيف هذه الإضافة بنية اختيارية يمكن تضمينها في السلسلة XrInteractionProfileSuggestedBinding::next التي تم تمريرها...

v1

XR_EXT_debug_utils

نظرًا إلى طبيعة واجهة OpenXR، لا تتوفّر معلومات كثيرة عن الأخطاء للمطوّر والتطبيق.

v1

XR_EXT_hand_tracking

تتيح هذه الإضافة للتطبيقات تحديد موضع المفاصل الفردية لمدخلات تتبُّع اليد.
الأذونات: HAND_TRACKING

v1

XR_EXT_performance_settings

تحدّد هذه الإضافة واجهة برمجة تطبيقات تتيح للتطبيق تقديم تلميحات حول الأداء إلى وقت التشغيل، كما تتيح لوقت التشغيل إرسال...

v1

XR_FB_display_refresh_rate

على المنصات التي تتيح تعديل معدّل تحديث الشاشة ديناميكيًا

v1

XR_FB_swapchain_update_state

تتيح هذه الإضافة للتطبيق تعديل حالة قابلة للتغيير معيّنة مرتبطة بسلسلة تبديل وإجراء طلبات بحث عنها.

v1

XR_FB_foveation

Foveation in the context of XR is a rendering technique that allows the area of an image near the focal point or fovea of the...

v1

XR_FB_foveation_configuration

على أجهزة العرض المثبّتة على الرأس من Facebook، يمكن للمطوّرين إنشاء ملفات تعريف تركيز النظر التي يتم إنشاؤها بواسطة بيئة التشغيل للخصائص البصرية والأداء.

v1

XR_FB_foveation_vulkan

تتطلّب واجهة برمجة التطبيقات Vulkan للرسومات تطبيق صورة على سلسلة التبديل لتطبيق نمط التثبيت البؤري.

v1

XR_FB_space_warp

توفّر هذه الإضافة إمكانية تفعيل تكنولوجيا Space Warp على التطبيق.

v1

XR_KHR_opengl_es_enable

يجب أن يتم توفير هذه الإضافة من خلال أوقات التشغيل التي تتيح استخدام التطبيقات لواجهات برمجة تطبيقات OpenGL ES للعرض.

v1

XR_KHR_android_create_instance

عندما ينشئ التطبيق كائن XrInstance على أنظمة Android

v1

XR_KHR_android_surface_swapchain

أحد الأنشطة الشائعة في الواقع الممتد هو عرض بث مباشر للصور.

v1

XR_KHR_android_thread_settings

لكي يكون الواقع الممتد مريحًا، من المهم أن تقدّم التطبيقات اللقطات بسرعة وبشكل متّسق.

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 صورة مشفّرة مستطيلة متساوية المساحة ناتجة عن...

v1

XR_KHR_convert_timespec_time

توفّر هذه الإضافة وظيفتَين للتحويل بين الوقت الرتيب timespec وXrTime.

v1

XR_KHR_vulkan_enable

تتيح هذه الإضافة استخدام واجهة برمجة تطبيقات الرسومات Vulkan في وقت تشغيل OpenXR.

v1

XR_KHR_vulkan_enable2

تتيح هذه الإضافة استخدام واجهة برمجة تطبيقات الرسومات Vulkan في وقت تشغيل OpenXR.

v1

XR_KHR_loader_init

في بعض الأنظمة الأساسية، يجب تهيئة أداة التحميل باستخدام مَعلمات خاصة بالنظام الأساسي قبل أن يتم التحميل.

v1

XR_KHR_loader_init_android

في نظام التشغيل Android، تحتاج بعض عمليات تنفيذ أداة التحميل إلى أن يقدّم التطبيق معلومات إضافية عند بدء التشغيل.

v1

XR_KHR_swapchain_usage_input_attachment_bit

تتيح هذه الإضافة لأحد التطبيقات تحديد أنّه يجب إنشاء صور swapchain بطريقة تتيح استخدامها كـ...

v1

XR_EXT_dpad_binding

تتيح هذه الإضافة للتطبيق ربط إجراء رقمي واحد أو أكثر بلوحة اللمس أو عصا الإبهام كما لو كانت لوحة أزرار اتجاه...

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

تضيف هذه الإضافة نوعًا جديدًا من إعدادات العرض، وهو XR_VIEW_CONFIGURATION_TYPE_PRIMARY_QUAD_VARJO إلى XrViewConfigurationType...

v1

XR_META_vulkan_swapchain_create_info

باستخدام هذه الإضافة، يمكن لتطبيق يستند إلى Vulkan تمرير 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 مجموعة من الميزات الثانوية التي تم استبعادها أو تجاهلها عن قصد من الحزمة الأصلية...

v1

XR_FB_composition_layer_settings

تتيح هذه الإضافة للتطبيقات طلب استخدام خيارات المعالجة، مثل التوضيح أو أخذ عينات فائقة، على...

v1

XR_KHR_locate_spaces

تقدّم هذه الإضافة الدالة xrLocateSpacesKHR.

v1

XR_EXT_local_floor

يحتوي مواصفات OpenXR الأساسية على نوعَين من مساحات المراجع الثابتة في العالم XrSpace في XrReferenceSpaceType.

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

في أنظمة الواقع الممتد، هناك بعض العمليات التي تستغرق وقتًا طويلاً ولا يمكن إكمالها بشكل معقول ضمن حلقة إطار عادية.

v1

XR_FB_color_space

قد تستخدم أجهزة XR مساحة ألوان مختلفة عن العديد من الشاشات المستخدَمة في عملية التطوير.

v1

XR_EXT_composition_layer_inverted_alpha

يوفر هذا الامتداد علامة، عند تطبيقها على طبقة تركيبة، تعكس تفسير قيمة ألفا في...

v1

XR_EXT_frame_synthesis

توفّر هذه الإضافة إمكانية تفعيل تركيب اللقطات في التطبيقات استنادًا إلى بيانات إضافية يقدّمها التطبيق.

إصدار 3

XR_QCOM_trackables_image_operations

توفّر هذه السمة عمليات تتبُّع الصور من Qualcomm للعناصر القابلة للتتبُّع.

إصدار 3

XR_QCOM_trackables_qr_code_operations

إصدار 3

XR_EXT_user_presence

يضيف هذا الامتداد حدثًا جديدًا لإرسال إشعار عند رصد النظام لتغيير في حالة حضور المستخدم.

إصدار 3

XR_KHR_extended_struct_name_lengths

تزيد هذه الإضافة من الحد الأقصى لحجم أسماء البُنى وتوفّر دالة جديدة للوصول إلى هذه الأسماء الموسّعة الجديدة.

إصدار 3

XR_EXT_interaction_profile_battery_state_display

توفّر XR_EXT_interaction_profile_battery_state_display آلية تتيح للتطبيقات الاستعلام من وقت التشغيل عن حالة البطارية...

إصدار 3


‫OpenXR™‎ وشعار OpenXR هما علامتان تجاريتان مملوكتان لشركة The Khronos Group Inc. ‎ ومسجّلتان كعلامة تجارية في الصين والاتحاد الأوروبي واليابان والمملكة المتحدة.