في Android XR، النماذج الثلاثية الأبعاد هي كائنات رقمية يتم عرضها بعمق وحجم لإضافة إحساس بالواقعية والفهم المكاني إلى تطبيقك. ويمكن للمستخدمين التفاعل بشكل طبيعي مع النماذج الثلاثية الأبعاد، ما يؤدي إلى إنشاء تجربة تفاعلية ومؤثرة.
يتوافق Android XR مع التصاميم الثلاثية الأبعاد التي تتضمّن امتداد الملف .glTF أو .glb.
GL Transmission Format (glTF) هو تنسيق ملف ثلاثي الأبعاد عادي
يقلّل حجم مواد العرض ويتم تحميله بسرعة ويمكن تشغيله على جميع المنصات. يمكنك تصدير تنسيقات الملفات هذه من أدوات إنشاء المحتوى الرقمي التابعة لجهات خارجية، مثل Blender وMaya وSpline وغيرها.
لتحسين الأداء، أعطِ الأولوية لأحجام الملفات الصغيرة. تجنَّب استخدام عدد كبير من المضلّعات أو مواد عرض عالية الدقة قد تؤثر في سرعة العرض.
طُرق دمج التصاميم الثلاثية الأبعاد
يوفّر Android XR أدوات مختلفة لإضافة تصاميم ثلاثية الأبعاد تفاعلية في تطبيقك، وذلك باستخدام واجهات برمجة تطبيقات SceneCore أو Scene Viewer. إذا كنت تستخدم Compose for XR، يمكنك وضع نماذج ثلاثية الأبعاد بالنسبة إلى واجهة المستخدم باستخدام SceneCoreEntity العنصر القابل للإنشاء في مساحة فرعية.
- واجهات برمجة تطبيقات SceneCore يمكنك إنشاء تفاعلاتك الخاصة، بما في ذلك التدوير والنقل والتوسيع. يتيح ذلك للمستخدمين التفاعل مع النماذج الثلاثية الأبعاد إلى جانب اللوحات المكانية والبيئة في تطبيقك. يمكنك أيضًا إنشاء علاقات أصل/فرع بين اللوحات والتصاميم الثلاثية الأبعاد. مزيد من المعلومات عن واجهات برمجة تطبيقات SceneCore
- يمكن استخدام Scene Viewer لتحميل وعرض نماذج ثلاثية الأبعاد مع إمكانية التفاعل معها، بما في ذلك تدويرها وتحريكها وتغيير حجمها. ومع ذلك، يعمل تطبيق Scene Viewer كتطبيق منفصل، وبالتالي لن يتمكّن المستخدمون من رؤية لوحات تطبيقك وبيئته أثناء التفاعل مع التصاميم الثلاثية الأبعاد. مزيد من المعلومات حول "عارض المشهد"
واجهات برمجة تطبيقات SceneCore
باستخدام واجهات برمجة تطبيقات SceneCore، يمكنك تطوير تفاعلات غنية مع التصاميم الثلاثية الأبعاد مع إبقاء المستخدمين في سياق تطبيقك. وبما أنّ SceneCore تتيح لك مواصلة عرض اللوحات والبيئات إلى جانب التصاميم الثلاثية الأبعاد، يمكنك إنشاء علاقات بين التصاميم الثلاثية الأبعاد واللوحات، واستخدام ميزة "إدراك المشهد" لتثبيت المحتوى في المساحة المادية للمستخدم.
باستخدام SceneCore، يمكنك أيضًا إضافة ما يلي:
- التعليقات التوضيحية على التصاميم الثلاثية الأبعاد
- تشغيل الصور المتحركة المضمّنة في التصاميم الثلاثية الأبعاد
- تصاميم ثلاثية الأبعاد متعددة
- قائمة مخصّصة ومواضع تشغيل
العلاقات
يمكن أن تتضمّن التصاميم الثلاثية الأبعاد علاقات أصل/تابع مع اللوحات أو التصاميم الثلاثية الأبعاد الأخرى، ما يتيح للعنصر التابع تتبُّع حركة العنصر الأصل.
علامات الإقحام
يمكن للمستخدمين تثبيت النماذج الثلاثية الأبعاد في نقطة معيّنة في العالم الحقيقي. يمكنك إضافة نقاط ربط إلى أسطح أفقية أو عمودية عامة أو أسطح معيّنة، مثل الأرضية أو الحائط.
Scene Viewer
تتيح أداة Scene Viewer للمستخدمين رؤية النماذج الثلاثية الأبعاد والتفاعل معها. يمكن للمستخدمين فتح تصاميم ثلاثية الأبعاد بتنسيق glTF متوافق، مثل ملف glb، ووضع العناصر في المساحة. يمكنك دمج عارض ثلاثي الأبعاد في تطبيقك لتسهيل مهمة المستخدمين في عرض المنتجات واستكشاف المحتوى التعليمي وتجربة النماذج الثلاثية الأبعاد. توفّر أداة Scene Viewer واجهة مستخدم مضمّنة للتفاعلات الأساسية، بما في ذلك التحريك والتدوير وتغيير الحجم والتثبيت.
موضع الإطلاق
يتم عرض النماذج الثلاثية الأبعاد على بُعد 1.5 متر وبزاوية 15 درجة تحت مستوى نظر المستخدم، في وسط مجال رؤيته. ويتم فتحها بحجم مصغّر يبلغ 1.5 متر لكل محور.

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