تتضمّن حزمة تطوير البرامج (SDK) الخاصة بمنصة Jetpack XR جميع الأدوات والمكتبات التي تحتاج إليها لإنشاء تجارب غامرة ومعزَّزة لأجهزة Android XR.
إنشاء تجارب غامرة بالكامل
استهداف الأجهزة المخصّصة عالية الدقة، مثل سمّاعات الرأس والنظّارات السلكية التي تعمل بنظام الواقع الممتد استخدام أدوات تطوير Android الحديثة، مثل Kotlin وCompose، بالإضافة إلى أدوات الجيل السابق، مثل Java وViews يمكنك تحديد الموقع المكاني لعناصر واجهة المستخدم وتحميل وعرض نماذج ثلاثية الأبعاد وفهم العالم الحقيقي دلاليًا.
إذا كان لديك تطبيق على Android للأجهزة الجوّالة أو الشاشات الكبيرة، يتيح لك حزمة تطوير البرامج (SDK) الخاصة بـ Jetpack XR إضافة بُعد جديد إلى تطبيقك من خلال تحويل التصاميم الحالية إلى تصاميم مكانية وتحسين تجاربك باستخدام نماذج ثلاثية الأبعاد وبيئات غامرة. يمكنك الاطّلاع على إرشادات الجودة للحصول على اقتراحاتنا بشأن تحويل تطبيق Android الحالي إلى تطبيق مكاني.
إنشاء تجارب معزّزة ومفيدة
استهدِف النظارات الصوتية والنظارات المزودة بشاشة الخفيفة والأنيقة. استخدام أدوات حديثة لتطوير تطبيقات Android، مثل Kotlin وJetpack Compose Glimmer استخدِم واجهات برمجة التطبيقات التي تسهّل عرض تجارب التطبيقات من الهاتف إلى النظارات.
استخدام مكتبات Jetpack
توفّر مكتبات Jetpack XR SDK مجموعة أدوات شاملة لإنشاء تجارب غنية وغامرة وتجارب معزَّزة خفيفة الوزن وكل ما بينهما. تشكّل المكتبات التالية جزءًا من حزمة تطوير البرامج (SDK) الخاصة بـ Jetpack XR:
- Jetpack Compose للواقع الممتد (XR): يمكنك إنشاء تنسيقات واجهة مستخدم مكانية بشكل تعريفي تستفيد من إمكانات الواقع المكاني في Android XR.
- التصميم المتعدد الأبعاد للواقع الممتد: يمكنك الإنشاء باستخدام مكوّنات وتنسيقات التصميم المتعدد الأبعاد التي تتكيّف مع الواقع الممتد.
- Jetpack SceneCore: يمكنك إنشاء مخطط مشهد Android XR والتعامل معه باستخدام محتوى ثلاثي الأبعاد.
- ARCore لـ Jetpack XR: يمكنك دمج المحتوى الرقمي في العالم الحقيقي باستخدام إمكانات الإدراك.
- Jetpack Compose Glimmer: هي مجموعة أدوات لواجهة المستخدم تتيح إنشاء تجارب واقع معزّز على Android XR، وهي محسَّنة لنظارات العرض.
- Jetpack Projected: واجهات برمجة التطبيقات التي تسهّل تجارب التطبيقات المعروضة من الهاتف إلى النظارات الصوتية أو النظارات المزودة بشاشة
تطوير واجهة برمجة التطبيقات خلال "معاينة المطوّر"
تُعدّ مكتبات Jetpack XR SDK جزءًا من "معاينة المطوّرين" لمنصة Android XR، ولا تزال واجهات برمجة التطبيقات هذه قيد التطوير. يمكنك الاطّلاع على ملاحظات إصدار المكتبة لمعرفة المشاكل المعروفة:
- ملاحظات إصدار Jetpack Compose for XR
- ملاحظات إصدار ARCore for Jetpack XR
- ملاحظات إصدار Jetpack SceneCore
- ملاحظات إصدار XR Runtime
- ملاحظات إصدار Glimmer من Jetpack Compose
- ملاحظات إصدار Jetpack Projected
إذا واجهت مشكلة غير مدرَجة في إحدى هاتين القائمتين، يُرجى الإبلاغ عن خطأ أو إرسال ملاحظات.
Jetpack Compose لتجربة الواقع المُمتد
أجهزة XR المشمولة: سماعات رأس بنظام الواقع الممتد، نظارات بنظام الواقع الممتد سلكية
باستخدام Jetpack Compose XR، يمكنك استخدام مفاهيم Compose المألوفة، مثل الصفوف والأعمدة، لإنشاء تصاميم واجهة مستخدم مكانية في تجارب الواقع الممتد، سواء كنت تنقل تطبيقًا ثنائي الأبعاد حاليًا إلى تجارب الواقع الممتد أو تنشئ تطبيقًا جديدًا من البداية.
توفّر هذه المكتبة عناصر قابلة للإنشاء في المساحات الفرعية، مثل اللوحات المكانية والعناصر الدوّارة، ما يتيح لك وضع واجهة المستخدم الحالية المستندة إلى Compose أو Views في تنسيق مكاني ثنائي الأبعاد.
راجِع تطوير واجهة مستخدم باستخدام Jetpack Compose XR للحصول على إرشادات مفصّلة.
تتيح لك Compose for XR استخدام الدالة المركّبة SceneCoreEntity الخاصة بالمساحة الفرعية، والتي تتيح لك وضع الكيانات، مثل النماذج الثلاثية الأبعاد، بالنسبة إلى واجهة المستخدم.
يمكنك الاطّلاع على كيفية تحويل تطبيق Android الحالي إلى تطبيق مكاني أو عرض مرجع واجهة برمجة التطبيقات للحصول على معلومات أكثر تفصيلاً.
التصميم المتعدد الأبعاد لتجربة الواقع المُمتد
أجهزة XR المشمولة: سماعات رأس بنظام الواقع الممتد، نظارات بنظام الواقع الممتد سلكية
يوفر التصميم المتعدد الأبعاد مكوّنات وتخطيطات تتوافق مع الواقع الممتد. إذا كنت تستخدم التنسيقات التكيّفية في عملية الإنشاء مزيد من المعلومات حول تنفيذ Material Design for XR
Jetpack SceneCore
أجهزة XR المشمولة: سماعات رأس بنظام الواقع الممتد، نظارات بنظام الواقع الممتد سلكية
تتيح لك مكتبة Jetpack SceneCore وضع محتوى ثلاثي الأبعاد وترتيبه، ويتم تحديد هذا المحتوى من خلال الكيانات، بالنسبة إلى بعضها البعض وإلى بيئتك. باستخدام SceneCore، يمكنك:
- ضبط البيئات المكانية
- إنشاء مثيلات
PanelEntity - وضع تصاميم ثلاثية الأبعاد وإضافة حركة إليها
- تحديد مصادر الصوت المكاني
- إضافة "مكوّنات" إلى الكيانات لجعلها قابلة للنقل وتغيير الحجم، ويمكن تثبيتها في العالم الحقيقي
توفّر مكتبة Jetpack SceneCore أيضًا إمكانية استخدام التطبيقات التي تم إنشاؤها باستخدام "طرق العرض" في إنشاء محتوى مكاني. يمكنك الاطّلاع على دليلنا حول كيفية العمل باستخدام طرق العرض لمزيد من التفاصيل.
يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات للحصول على معلومات أكثر تفصيلاً.
ARCore for Jetpack XR
أجهزة XR المشمولة: سمّاعات رأس بنظام الواقع الممتد، نظّارات بنظام الواقع الممتد سلكية، نظّارات صوتية، نظّارات عرض
استنادًا إلى مكتبة ARCore الحالية، توفّر مكتبة ARCore for Jetpack XR إمكانات لدمج المحتوى الرقمي مع العالم الحقيقي. تتضمّن هذه المكتبة تتبُّع الحركة، وعناصر ثابتة، واختبارات تحديد المواقع، وتحديد الأسطح باستخدام التصنيف الدلالي (مثل الأرضيات والجدران وأسطح الطاولات). تستفيد هذه المكتبة من حزمة الإدراك الأساسية المستندة إلى OpenXR، ما يضمن التوافق مع مجموعة كبيرة من الأجهزة ويساعد في جعل التطبيقات متوافقة مع المستقبل.
يمكنك الاطّلاع على التعامل مع ARCore for Jetpack XR للحصول على مزيد من المعلومات التفصيلية.
Glimmer في Jetpack Compose
أجهزة XR المشمولة: نظارات العرض
Jetpack Compose Glimmer هي مجموعة أدوات لواجهة المستخدم تتيح إنشاء تجارب واقع مختلط (XR) معزّز على Android XR، وهي محسَّنة لنظارات العرض. يمكنك إنشاء واجهة مستخدم جميلة وبسيطة ومريحة للأجهزة التي يتم ارتداؤها طوال اليوم.
- مصمَّمة لتسهيل القراءة والاطّلاع السريع: على عكس الهواتف، فإنّ الشاشة الأساسية هي شاشة شفافة، ما يتيح لك رؤية ما وراءها. توفّر مكتبة Glimmer في Jetpack Compose سمات خاصة بالنظارات ولوحات ألوان مبسطة وأسلوب خط لجعل المحتوى سهل القراءة وسريع المعالجة وغير مشتّت للانتباه.
- تحسين التفاعل مع الأجهزة القابلة للارتداء: لقد حسّنّا نماذج التفاعل لتناسب طريقة استخدام الأشخاص للنظارات. تتضمّن ميزة مكوّنات Jetpack Compose Glimmer حالات تركيز واضحة، مثل المخططات التفصيلية المحسّنة بدلاً من المؤثرات المتموجة المشتّتة للانتباه، وهي مصمَّمة للتعامل مع المدخلات المادية الشائعة، مثل النقرات والتمريرات السريعة على الإطار، وبالطبع، الصوت.
- استخدام أنماط مألوفة لواجهة المستخدم التعريفية: بما أنّ Jetpack Compose Glimmer يستند بالكامل إلى Jetpack Compose، يمكنك استخدام كل ما تعرفه عن إنشاء واجهة مستخدم تعريفية في Android. نوفّر مجموعة كاملة من دوال Composable الأساسية والمضمّنة، مثل Text وIcon وButton والمكوّنات المتخصّصة، مثل TitleChip، وكلها محسّنة لتناسب بيئة النظارات.
حزمة Jetpack Projected
أجهزة XR المشمولة: نظارات صوتية، نظارات عرض
عند إنشاء تطبيقات لنظارات الصوت والنظارات المزودة بشاشة، يتم تشغيل تطبيقك على جهاز مضيف مصاحب، مثل هاتف Android، يعرض تجارب الواقع الممتد التي يوفّرها تطبيقك. تتيح Jetpack Projected لأجهزة Android المضيفة التواصل مع نظّارات الصوت أو العرض إذا كانت الأجهزة المضيفة تتضمّن إمكانات العرض بتقنية الواقع الممتد.
- الوصول إلى أجهزة الجهاز المعروض: سياق جهاز مرتبط بالجهاز المعروض (نظارات صوتية أو نظارات عرض) يتيح السياق المعروض الوصول إلى أجهزة العرض، مثل الكاميرا. تُعد الأنشطة المخصّصة التي تم إنشاؤها خصيصًا للعرض على النظارات الصوتية أو نظارات العرض تعمل حاليًا كسياق معروض. إذا كان جزء آخر من تطبيقك (مثل نشاط على الهاتف أو خدمة) بحاجة إلى الوصول إلى أجهزة النظارات، يمكنه الحصول على سياق متوقّع.
- تبسيط طلبات الأذونات: تتّبع نظارات الصوت والنظارات الذكية نموذج أذونات Android العادي، مع أذونات خاصة بالنظارات يجب طلبها في وقت التشغيل قبل أن يتمكّن تطبيقك من الوصول إلى معدّات الجهاز، مثل الكاميرا. تسهّل أداة "مساعد الأذونات" آليات طلب الحصول على إذن هذه على مستوى واجهتَي الهاتف والنظارات لتوفير تجربة طلب متّسقة.
- التحقّق من إمكانات الجهاز والعرض: تحقَّق مما إذا كان الجهاز المعروض يتضمّن شاشة عرض وحالة شاشة العرض لتقديم العناصر المرئية. تكييف تطبيقك بناءً على إمكانيات الجهاز على سبيل المثال، قد تحتاج إلى توفير سياق صوتي أكبر إذا كان الجهاز لا يتضمّن شاشة عرض أو إذا كانت شاشة العرض غير مفعّلة.
- الوصول إلى إجراءات الكاميرا في التطبيق: يمكن لتطبيقك الوصول إلى إجراءات الكاميرا التي يتّخذها المستخدم، مثل تشغيل الكاميرا أو إيقافها في تطبيق لبث الفيديو.
OpenXR™ وشعار OpenXR هما علامتان تجاريتان مملوكتان لشركة The Khronos Group Inc. ومسجّلتان كعلامة تجارية في الصين والاتحاد الأوروبي واليابان والمملكة المتحدة.