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