يمكن للمستخدم تجربة تطبيقك في وضعَين، هما "مساحة الصفحة الرئيسية" (Home Space) أو "المساحة الكاملة" (Full Space). في المساحة المشتركة، يمكن للمستخدم تنفيذ مهام متعددة أثناء تشغيل تطبيقك جنبًا إلى جنب مع تطبيقات أخرى. في "المساحة الكاملة"، يحتل تطبيقك مركز الصدارة باعتباره محور تجربة المستخدم، مع إمكانية الوصول الكامل إلى الإمكانات الغامرة في Android XR.
يتم فتح تطبيقك في Home Space تلقائيًا ما لم تحدّد غير ذلك كما هو موضّح في قسم تحديد الوضع التلقائي للتشغيل.
لا تتوفّر ميزة المعالجة المكانية إلا في وضع "المساحة الكاملة". يمكن لتطبيقك الانتقال إلى "المساحة الكاملة" للاستفادة من الإمكانات المكانية والثلاثية الأبعاد. عندما يكون تطبيقك في المقدّمة، يمكنك الانتقال بين هذين الوضعَين من خلال طلب المساحة المناسبة.
استخدِم SpaceToggleButton للتبديل بين "مساحات منزلية" و"مساحات كاملة"
للتبديل بين "المساحة المشتركة" و"المساحة الكاملة"، استخدِم الدالة المركّبة
SpaceToggleButton من مكتبة التصميم المتعدد الأبعاد للواقع الممتد.
هذا زر قابل للتركيب يتكيّف مع الوضع المكاني الحالي ويبدّل بين "مساحة كاملة" و"مساحة الصفحة الرئيسية".
إنشاء انتقال مخصّص بين "مساحة الصفحة الرئيسية" و"المساحة الكاملة"
إذا كنت تستخدم مكتبة Jetpack Compose for XR، يمكنك طلب مساحة الصفحة الرئيسية أو مساحة كاملة باستخدام العنصر المحلي LocalSession.
val session = LocalSession.current ?: return session.scene.requestHomeSpace() // or session.scene.requestFullSpace()
إذا كنت تستخدم مكتبة Jetpack SceneCore، يمكنك طلب
المساحة المقابلة من Session. يُرجى الاطّلاع على الوصول إلى الجلسة من Jetpack
SceneCore.
xrSession.scene.requestHomeSpace()
راجِع إرشادات التصميم لمعرفة المزيد عن "مساحة الصفحة الرئيسية" و"المساحة الكاملة" وأفضل طريقة للانتقال بينهما.
الإعلان عن الوضع التلقائي لبدء النشاط
بدلاً من ذلك، يمكنك إضافة الأسطر التالية إلى ملف Android Manifest لاختيار المساحة التي يجب فتح تطبيقك فيها:
<!-- Launch in Full Space. -->
<property
android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
android:value="XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED" />
<!-- Or, launch in Home Space. -->
<property
android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
android:value="XR_ACTIVITY_START_MODE_HOME_SPACE" />
انظر أيضًا
- التحقّق من الإمكانات المكانية
- إنشاء جلسة
- إضافة بيئات إلى تطبيقك
- إضافة تصاميم ثلاثية الأبعاد إلى تطبيقك