التطوير باستخدام حزمة تطوير البرامج (SDK) لـ Jetpack XR

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

تتضمّن حزمة تطوير البرامج (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) الخاصة بتجربة الواقع الممتد (XR) في Jetpack:

  • ‫Jetpack Compose للواقع الممتد (XR): يمكنك إنشاء تنسيقات واجهة مستخدم مكانية بشكل تعريفي تستفيد من إمكانات Android XR المكانية.
  • Material Design for XR: يمكنك إنشاء تطبيقات باستخدام مكونات وتنسيقات Material تتكيّف مع تجربة الواقع الممتد.
  • ‫Jetpack SceneCore: يمكنك إنشاء مخطط المشهد في Android XR والتعامل معه باستخدام محتوى ثلاثي الأبعاد.
  • ‫ARCore لـ Jetpack XR: يمكنك دمج المحتوى الرقمي في العالم الحقيقي باستخدام إمكانات الإدراك.
  • ‫Jetpack Compose Glimmer: هي مجموعة أدوات لواجهة المستخدم تتيح إنشاء تجارب واقع مختلط على Android XR، وهي محسّنة للعمل على نظارات الذكاء الاصطناعي.
  • Jetpack Projected: واجهات برمجة التطبيقات التي تسهّل تجارب التطبيقات المعروضة من هاتف إلى نظارات الذكاء الاصطناعي

تطوير واجهات برمجة التطبيقات خلال "معاينة المطوّرين"

تُعدّ مكتبات Jetpack XR SDK جزءًا من إصدار "معاينة المطوّرين" من Android XR، ولا تزال واجهات برمجة التطبيقات هذه قيد التطوير. يمكنك الاطّلاع على ملاحظات إصدار المكتبة لمعرفة المشاكل المعروفة:

إذا واجهت مشكلة غير مدرَجة في إحدى هاتين القائمتين، يُرجى الإبلاغ عن خطأ أو إرسال ملاحظات.

‫Jetpack Compose لتجربة الواقع المُمتد

أجهزة XR المشمولة: سمّاعات الرأس والنظّارات السلكية التي تعمل بنظام الواقع الممتد

باستخدام Jetpack Compose for XR، يمكنك استخدام مفاهيم Compose المألوفة، مثل الصفوف والأعمدة، لإنشاء تصاميم واجهة مستخدم مكانية في تجارب الواقع الممتد، سواء كنت تنقل تطبيقًا ثنائي الأبعاد حاليًا إلى تجارب الواقع الممتد أو تنشئ تطبيقًا جديدًا من البداية.

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

راجِع تطوير واجهة مستخدم باستخدام Jetpack Compose للواقع الممتد للحصول على إرشادات تفصيلية.

تطوير مثال عام على أداة تحكّم في مكونات واجهة مستخدم XR

تقدّم Compose for XR العنصر القابل للإنشاء Volume الخاص بالمساحة الفرعية، والذي يتيح لك وضع عناصر SceneCore، مثل النماذج الثلاثية الأبعاد، بالنسبة إلى واجهة المستخدم.

يمكنك الاطّلاع على كيفية تحويل تطبيق Android الحالي إلى تطبيق مكاني أو عرض مرجع واجهة برمجة التطبيقات للحصول على معلومات أكثر تفصيلاً.

‫Material Design لتجربة الواقع المُمتد

أجهزة XR المشمولة: سمّاعات الرأس والنظّارات السلكية التي تعمل بنظام الواقع الممتد

يوفر Material Design مكوّنات وتصميمات تتوافق مع تجارب الواقع الممتد. إذا كنت تستخدم التنسيقات التكيّفية في عملية الإنشاء. مزيد من المعلومات حول تنفيذ Material Design لأجهزة XR

‫Jetpack SceneCore

أجهزة XR المشمولة: سمّاعات الرأس والنظّارات السلكية التي تعمل بنظام الواقع الممتد

تتيح لك مكتبة Jetpack SceneCore وضع محتوى ثلاثي الأبعاد وترتيبه، ويتم تحديد هذا المحتوى من خلال الكيانات، بالنسبة إلى بعضها البعض وإلى بيئتك. باستخدام SceneCore، يمكنك:

توفّر مكتبة Jetpack SceneCore أيضًا إمكانية تحويل التطبيقات التي تم إنشاؤها باستخدام "طرق العرض" إلى تطبيقات مكانية. يمكنك الاطّلاع على دليلنا حول كيفية العمل باستخدام طرق العرض لمزيد من التفاصيل.

يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات للحصول على معلومات أكثر تفصيلاً.

‫ARCore for Jetpack XR

أجهزة XR المشمولة: سمّاعات الرأس والنظّارات السلكية التي تعمل بنظام الواقع الممتد والنظّارات الذكية المستنِدة إلى الذكاء الاصطناعي

استنادًا إلى مكتبة ARCore الحالية، توفّر مكتبة ARCore for Jetpack XR إمكانات لدمج المحتوى الرقمي مع العالم الحقيقي. تتضمّن هذه المكتبة تتبُّع الحركة، وعناصر ثابتة، واختبارات الاصطدام، وتحديد مستوى الارتفاع مع تصنيف دلالي (مثل الأرضيات والجدران وأسطح الطاولات). تستفيد هذه المكتبة من حزمة الإدراك الأساسية المستندة إلى OpenXR، ما يضمن التوافق مع مجموعة كبيرة من الأجهزة ويساعد في جعل التطبيقات متوافقة مع المستقبل.

يمكنك الاطّلاع على التعامل مع ARCore for Jetpack XR للحصول على مزيد من المعلومات التفصيلية.

Glimmer في Jetpack Compose

أجهزة XR المشمولة: نظارات الذكاء الاصطناعي

‫Jetpack Compose Glimmer هي مجموعة أدوات لواجهة المستخدم تتيح إنشاء تجارب واقع معزّز على Android XR، وهي محسّنة لتتوافق مع نظارات الذكاء الاصطناعي. يمكنك إنشاء واجهة مستخدم جميلة وبسيطة ومريحة للأجهزة التي يتم ارتداؤها طوال اليوم.

  • مصمَّمة لتسهيل القراءة والاطّلاع السريع: على عكس الهواتف، فإنّ الشاشة الأساسية هي شاشة شفافة، ما يتيح لك رؤية ما وراءها. توفّر مكتبة Glimmer في Jetpack Compose سمات خاصة بالنظارات ولوحات ألوان مبسطة وأسلوب خط لجعل المحتوى سهل القراءة وسريع المعالجة وغير مزعج.
  • تحسين التفاعلات الخاصة بالأجهزة القابلة للارتداء: لقد حسّنّا نماذج التفاعل لتناسب طريقة استخدام الأشخاص للنظارات. توفّر ميزة عناصر Jetpack Compose Glimmer حالات تركيز واضحة، مثل الخطوط المحيطة المحسّنة بدلاً من المؤثرات المتموجة المشتتة للانتباه، وهي مصمَّمة للتعامل مع الإدخالات المادية الشائعة، مثل النقرات والتمريرات السريعة على الإطار، وبالطبع، الصوت.
  • استخدام أنماط مألوفة لواجهة المستخدم التعريفية: بما أنّ Jetpack Compose Glimmer مبني بالكامل على Jetpack Compose، يمكنك استخدام كل ما تعرفه عن تصميم واجهة المستخدم التعريفية في Android. نوفّر مجموعة كاملة من دوال Composable الأساسية والمضمّنة، مثل Text وIcon وButton والمكوّنات المتخصّصة، مثل TitleChip، وكلها محسّنة لتناسب بيئة النظارات.
تطوير مثال عام على أداة تحكّم في مكونات واجهة مستخدم XR

حزمة Jetpack Projected

أجهزة XR المشمولة: نظارات الذكاء الاصطناعي

عند إنشاء تطبيقات لنظارات الذكاء الاصطناعي، يتم تشغيل تطبيقك على جهاز مضيف مصاحب، مثل هاتف Android، يعرض تجارب الواقع الممتد التي يوفّرها تطبيقك. تتيح حزمة Jetpack Projected لأجهزة Android المضيفة هذه التواصل مع نظارات الذكاء الاصطناعي إذا كانت الأجهزة المضيفة تتضمّن إمكانات عرض XR.

  • الوصول إلى أجهزة العرض: سياق جهاز مرتبط بجهاز العرض (نظارات الذكاء الاصطناعي) يوفّر السياق المُسقَط إمكانية الوصول إلى أجهزة الجهاز المُسقَط، مثل الكاميرا. تتوفّر الأنشطة المخصّصة التي تم إنشاؤها خصيصًا للعرض على نظارات الذكاء الاصطناعي بالفعل كوظيفة سياق معروض. إذا كان جزء آخر من تطبيقك (مثل نشاط على الهاتف أو خدمة) بحاجة إلى الوصول إلى أجهزة نظارات الذكاء الاصطناعي، يمكنه الحصول على سياق معروض.
  • تبسيط طلبات الأذونات: تتّبع نظارات الذكاء الاصطناعي نموذج أذونات Android العادي، مع أذونات خاصة بالنظارات يجب طلبها في وقت التشغيل قبل أن يتمكّن تطبيقك من الوصول إلى معدّات الجهاز، مثل الكاميرا. تساعد أداة "مساعد الأذونات" في تبسيط آليات طلب الأذونات هذه على مستوى واجهات الهاتف والنظارات الذكية التي تعمل بالذكاء الاصطناعي لتوفير تجربة طلب متّسقة.
  • التحقّق من إمكانات الجهاز والعرض: تحقَّق مما إذا كان الجهاز المعروض يتضمّن شاشة عرض وحالة شاشة العرض لتقديم العناصر المرئية. تكييف تطبيقك بناءً على إمكانيات الجهاز على سبيل المثال، قد تحتاج إلى توفير سياق صوتي أكبر إذا كان الجهاز لا يتضمّن شاشة عرض أو إذا كانت شاشة العرض غير مفعّلة.
  • الوصول إلى إجراءات الكاميرا في التطبيق: يمكن لتطبيقك الوصول إلى إجراءات الكاميرا التي يتّخذها المستخدم، مثل تشغيل الكاميرا أو إيقافها في تطبيق لبث الفيديو.

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