تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
في Android XR، النماذج الثلاثية الأبعاد هي عناصر رقمية يتم عرضها بدرجة عمق وحجم معيّنين لإضافة لمسة من الواقعية والفهم المكاني إلى تطبيقك. ويمكن للمستخدمين التفاعل بشكل طبيعي مع النماذج الثلاثية الأبعاد، ما يخلق تجربة تحويلية وتفاعلية.
يتوافق نظام Android XR مع النماذج الثلاثية الأبعاد التي لها امتداد ملف .glTF أو .glb.
GL Transmission Format (glTF) هو تنسيق ملف ثلاثي الأبعاد عادي يقلل من حجم مواد العرض ويحمّلها بسرعة ويمكن تشغيله على جميع المنصات. يمكنك
تصدير تنسيقات الملفات هذه من أدوات إنشاء المحتوى الرقمي التابعة لجهات خارجية، مثل
Blender وMaya وSpline وغيرها.
لتحسين الأداء، امنح الأولوية لحجم الملفات الصغيرة. تجنَّب استخدام عدد كبير جدًا من المضلّعات
أو استخدام مواد تركيبية عالية الدقة التي قد تؤثّر في سرعة العرض.
طُرق دمج النماذج الثلاثية الأبعاد
يوفّر Android XR أدوات مختلفة لإضافة نماذج ثلاثية الأبعاد تفاعلية في تطبيقك: باستخدام واجهتَي برمجة التطبيقات
SceneCore API أو Scene Viewer. إذا كنت بصدد إنشاء محتوى باستخدام Compose for XR، يمكنك
وضع النماذج الثلاثية الأبعاد بالنسبة إلى واجهة المستخدم باستخدام العنصر القابل للتجميع في مساحة فرعية للحجم.
واجهات برمجة تطبيقات SceneCore يمكنك إنشاء تفاعلاتك الخاصة، بما في ذلك التدوير
والنقل والتكبير/التصغير. يتيح ذلك للمستخدمين التفاعل مع النماذج الثلاثية الأبعاد إلى جانب لوحات وبيئة
تطبيقك المكانية. يمكنك أيضًا إنشاء علاقات بين العناصر الرئيسية
واللوحات والنماذج الثلاثية الأبعاد. التعرّف على واجهات برمجة تطبيقات SceneCore
يمكن استخدام عارض المشهد لتحميل النماذج الثلاثية الأبعاد وعرضها مع التفاعلات،
بما في ذلك التدوير والنقل والتكبير/التصغير. ومع ذلك، يتم تشغيل "عارض المَشاهد" كتطبيق
منفصل. نتيجةً لذلك، لن يتمكّن المستخدمون من رؤية لوحات تطبيقك و
بيئته أثناء التفاعل مع النماذج الثلاثية الأبعاد. مزيد من المعلومات عن ميزة "عارض المشهد"
واجهات برمجة تطبيقات SceneCore
باستخدام واجهات برمجة التطبيقات SceneCore، يمكنك تطوير تفاعلات غنية للنماذج الثلاثية الأبعاد مع إبقاء المستخدمين في سياق تطبيقك. بما أنّ SceneCore تتيح لك مواصلة عرض التصاميم والبيئات إلى جانب النماذج الثلاثية الأبعاد، يمكنك إنشاء علاقات بين النماذج الثلاثية الأبعاد والتصاميم، واستخدام ميزة "إدراك المشهد" لتثبيت المحتوى في المساحة المادية للمستخدم.
باستخدام SceneCore، يمكنك أيضًا إضافة ما يلي:
التعليقات التوضيحية للتصاميم الثلاثية الأبعاد
تشغيل الصور المتحركة المضمّنة في النماذج الثلاثية الأبعاد
تصاميم ثلاثية الأبعاد متعددة
قائمة مخصّصة ومواقع إطلاق
العلاقات
يمكن أن ترتبط النماذج الثلاثية الأبعاد بعلاقات رئيسية مع الألواح أو النماذج الثلاثية الأبعاد الأخرى، بحيث يلي العنصر الثانوي حركة العنصر الرئيسي.
علامات الإقحام
يمكن للمستخدمين تثبيت النماذج الثلاثية الأبعاد في نقطة معيّنة في العالم الواقعي. يمكنك
إضافة نقاط تثبيت إلى مساحات أفقية أو عمودية عامة أو مساحات
معيّنة، مثل الأرضية أو الحائط.
Scene Viewer
تسمح ميزة "عارض المشهد" للمستخدمين بالاطّلاع على النماذج الثلاثية الأبعاد والتفاعل معها. يمكن للمستخدمين فتح نماذج ثلاثية الأبعاد متوافقة بتنسيق glTF ( .gltf)، مثل ملف glb ( .glb)، ووضع العناصر في المساحة. يمكنك
دمج أداة عرض المحتوى الثلاثي الأبعاد في تطبيقك لتسهيل استخدام ميزة
عرض المنتجات واستكشاف المحتوى التعليمي والاطّلاع على النماذج الثلاثية الأبعاد. يوفّر "عارض المشهد" واجهة مستخدم مدمجة للتفاعلات الأساسية، بما في ذلك التنقّل والدوران والتكبير والربط.
موضع الإطلاق
يتم عرض النماذج الثلاثية الأبعاد على مسافة 1.5 متر و15 درجة تحت خط نظر المستخدم، في
مركز مجال رؤيته. يتم فتحها بحجم مصغّر يبلغ 1.5 متر
لكل محور.
تشمل التفاعلات ما يلي:
واجهة المستخدم والتفاعلات التي تسمح للمستخدمين بتحريك نماذج 3D
وإدارتها وتثبيتها وتغيير حجمها باستخدام إيماءات طبيعية
قائمة التفاعلات
يمكن تخصيص قائمة النماذج الثلاثية الأبعاد باستخدام إجراءات إضافية. إذا كان ملف glTF يحتوي على أحجام مختلفة، مثل الحجم المقترَح والحجم الفعلي، يتيح الزر 1:1 للمستخدمين التبديل بينهما بسرعة. للخروج من عرض النموذج الثلاثي الأبعاد
والعودة إلى التطبيق، يمكن للمستخدمين النقر على زر الإغلاق الإلزامي.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# 3D model design\n\nIn Android XR, 3D models are digital objects rendered with depth and volume to\nadd a sense of realism and spatial understanding to your app. Users can\nnaturally interact with 3D models, creating a transformative and engaging\nexperience.\n| **Preview:** Currently, 3D models are only available in Full Space.\n\nAndroid XR supports 3D models with either a `.glTF` or `.glb` file extension.\n[GL Transmission Format (glTF)](https://www.khronos.org/glTF) is a standard 3D file format that\nminimizes asset size, loads fast, and is operable across platforms. You can\nexport these file formats from third-party digital content creation tools such\nas [Blender](https://www.blender.org/), [Maya](https://www.autodesk.com/products/maya), [Spline](https://spline.design/),\namong others.\n\nTo optimize performance, prioritize small file sizes. Avoid excessive polygon\ncounts or high-resolution textures that could impact rendering speed. \nAlas, your browser doesn't support HTML5 video. That's OK! You can still [download the video](/static/videos/design/ui/xr/3d-content-shark.mp4) and watch it with a video player.\n\nMethods to integrate 3D models\n------------------------------\n\nAndroid XR offers different tools to add interactive 3D models in your app: with\nSceneCore APIs or Scene Viewer. If you're building with Compose for XR, you can\nplace 3D models relative to your UI using the [volume subspace composable](/develop/xr/jetpack-xr-sdk/develop-ui#use-volume).\n\n- **SceneCore APIs** . You can create your own interactions including rotate, move, and scale. This allows users to interact with 3D models alongside your app's spatial panels and environment. You can also create parent relationships between panels and 3D models. [Learn about SceneCore APIs](/develop/xr/jetpack-xr-sdk/work-with-entities).\n- **Scene Viewer** can be used to load and display 3D models with interactions including rotate, move, and scale. However, Scene Viewer runs as a separate app. As a result, users won't be able to see your app's panels and environment while interacting with 3D models. [Learn about Scene Viewer](/develop/xr/jetpack-xr-sdk/add-3d-models#load-3d).\n\nSceneCore APIs\n--------------\n\nWith SceneCore APIs, you can develop rich interactions for 3D models while\nkeeping users in the context of your app. Since SceneCore lets you keep showing\npanels and environments alongside 3D models, you can create relationships\nbetween 3D models and panels, and use scene perception to anchor content to a\nuser's physical space.\n\nWith SceneCore, you can also add:\n\n- Annotations to the 3D models\n- Playback of [animations](/develop/xr/jetpack-xr-sdk/add-3d-models#animate-3d) embedded in 3D models\n- Multiple 3D models\n- A custom menu and launch positions\n\n### Relationships\n\n3D models can have parent relationships with panels or other 3D models, so that\nthe child element follows the parent's movement. \nAlas, your browser doesn't support HTML5 video. That's OK! You can still [download the video](/static/videos/design/ui/xr/3d-content-parent-child.mp4) and watch it with a video player.\n\n### Anchors\n\nUsers can fix 3D models to a specific point in the real world. You have the\noption to add anchors to general horizontal or vertical surfaces or specific\nsurfaces such as the floor or wall. \nAlas, your browser doesn't support HTML5 video. That's OK! You can still [download the video](/static/videos/design/ui/xr/3d-content-anchor.mp4) and watch it with a video player.\n\n### Scene Viewer\n\nScene Viewer allows users to see and interact with 3D models. Users can open\nsupported .glTF 3D models like a .glb file and place objects in space. You can\n[integrate the 3D viewer](/develop/xr/jetpack-xr-sdk/add-3d-models#load-3d) in your app to make it simple for users to\nvisualize products, explore educational content, and experience 3D models. Scene\nViewer provides built-in UI for basic interactions including moving, rotating,\nscaling, and anchoring. \nAlas, your browser doesn't support HTML5 video. That's OK! You can still [download the video](/static/videos/design/ui/xr/3d-content-spawn.mp4) and watch it with a video player.\n\n### Launch position\n\n3D models launch at 1.5 meters and 15 degrees below a user's line of sight, in\nthe center of their field of view. They open in the miniature size of 1.5 meters\nper axis.\n\n### Interactions Includes\n\nUI and interactions that allow users to move, rotate, anchor, and scale 3D\nmodels using natural gestures. \nAlas, your browser doesn't support HTML5 video. That's OK! You can still [download the video](/static/videos/design/ui/xr/3d-content-gestures.mp4) and watch it with a video player.\n\n### Interaction menu\n\nThe 3D model menu can be customized with additional actions. If the glTF file\ncontains different sizes such as a suggested size and an actual size, the 1:1\nbutton allows users to quickly switch between them. To exit the 3D model view\nand return to the app, users can click the mandatory close button."]]
