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