المكوّنات المكانية

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

تتضمّن حزمة Jetpack Compose للواقع الممتد مجموعة متنوعة من المكوّنات المكانية لمساعدتك في إنشاء واجهة مستخدم وتنسيقات مكانية لتطبيقك.

الدوال المركّبة في Subspace

الدوال المركّبة للمساحة الفرعية هي نوع خاص من المكوّنات المكانية التي لا يمكن عرضها إلا في مساحة فرعية ويجب تضمينها في Subspace قبل وضعها في تنسيق ثنائي الأبعاد. يتيح لك SubspaceModifier إضافة سمات مثل العمق والإزاحة وتحديد الموضع إلى الدوال المركّبة في المساحة الفرعية.

المكوّنات الأخرى التي تم تحويلها إلى صوت مكاني

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

يمكن وضع المكوّنات المكانية في أي مكان في التسلسل الهرمي لواجهة المستخدم في تطبيقك. ويمكن إعادة استخدام هذه العناصر في واجهة المستخدم الثنائية الأبعاد، ولا تظهر سماتها المكانية إلا عند تفعيل الإمكانات المكانية. يتيح لك ذلك إضافة ارتفاع إلى القوائم ومربعات الحوار والمكونات الأخرى دون الحاجة إلى كتابة التعليمات البرمجية مرتين. في ما يلي بعض الأمثلة على كيفية تغيُّر سلوك المكوّنات المختلفة التي تم تفعيل ميزة "الصوت المكاني" لها عند تفعيل هذه الميزة أو إيقافها:

المكوّن المكاني

عند تفعيل ميزة "المعالجة الصوتية"

في بيئة ثنائية الأبعاد

SpatialDialog

يتم دفع اللوحة قليلاً إلى الخلف في عمق المحور Z لعرض مربّع حوار مرتفع

يتم الرجوع إلى العرض الثنائي الأبعاد Dialog.

SpatialPopup

يتم دفع اللوحة قليلاً إلى الخلف في عمق z لعرض نافذة منبثقة مرتفعة

يتم الرجوع إلى Popup ثنائي الأبعاد.

SpatialElevation

يمكن ضبط SpatialElevationLevel لإضافة الارتفاع.

يتم عرضها بدون ارتفاع مكاني.

الأدلّة

يتضمّن هذا القسم أدلة المطوّرين التالية: