استخدام Scene Viewer لعرض نماذج تفاعلية ثلاثية الأبعاد في الواقع المعزّز من تطبيق أو متصفّح Android

عارض المشهد هو عارض شامل يتيح تجارب ثلاثية الأبعاد وتجارب الواقع المعزّز من موقعك الإلكتروني أو تطبيق Android. ويسمح لمستخدمي أجهزة Android الجوّالة بمعاينة النماذج الثلاثية الأبعاد المستضافة على الويب ووضعها وعرضها والتفاعل معها بسهولة في بيئتهم.

تتوافق معظم متصفحات Android مع تطبيق Scene Viewer. تم استخدام Scene Viewer بنجاح من العديد من شركاء Google لدعم التجارب الثلاثية الأبعاد والواقع المعزّز على نحو موثوق. وتعزّز هذه التجارب أيضًا أداء "بحث Google".

عملية التنفيذ سهلة:

• لا تتطلّب التجارب المستنِدة إلى الويب سوى الروابط ذات التنسيق الصحيح على صفحة الويب.

• لا تتطلب التجارب المستندة إلى التطبيق سوى دمج بضعة أسطر من رمز Java.

متطلبات وقت تشغيل Scene Viewer

لتجربة "الواقع المعزّز" مع "عارض المشهد"، يجب أن يكون لدى المستخدمين ما يلي:

• جهاز متوافق مع ARCore يعمل بنظام التشغيل Android 7.0 Nougat (مستوى واجهة برمجة التطبيقات 24) أو إصدار أحدث.
• إصدار حديث (حديث) من خدمات Google Play للواقع المعزّز. يتم تثبيت هذه الخدمة تلقائيًا وتحديثها على معظم الأجهزة التي تتوافق مع ARCore.
• هو إصدار حديث من تطبيق Google ويتم تثبيت هذا التطبيق مسبقًا ويتم تحديثه تلقائيًا على الغالبية العظمى من الأجهزة المتوافقة مع ARCore.

للتوفير في الحالات التي لا تتوفّر فيها "خدمات Google Play للواقع المعزّز" أو تطبيق Google أو تكون الإصدارات المثبَّتة قديمة جدًا، يمكنك تحديد عنوان URL احتياطي يؤدي إلى تشغيل تجربة بديلة، على سبيل المثال، صفحة ويب أو رسالة خطأ أو تجربة احتياطية أنشأتها.

حالات الاستخدام المتوفّرة

حالة الاستخدام المقصودة	التطبيق المقترَح	المزايا
من زر أو رابط على موقع إلكتروني أو تطبيق Android، يمكنك تشغيل عرض الواقع المعزّز الأصلي لنموذج ثلاثي الأبعاد. في حال عدم توفّر "خدمات Google Play للواقع المعزّز" على الجهاز، يمكنك الرجوع بشكل سلس لعرض النموذج في الوضع الثلاثي الأبعاد المستنِد إلى "عارض المشهد".	شغِّل "عارض المشهد" باستخدام هدف صريح لحزمة "بحث Google"، واختَر إعداد mode مناسبًا لعرض التصميم الثلاثي الأبعاد. ar_preferred: يتم تشغيل هذه الميزة دائمًا في عارض الواقع المعزّز، ويمكن للمستخدمين التبديل يدويًا إلى عارض ثلاثي الأبعاد. في حال عدم وجود "خدمات Google Play للواقع المعزّز"، يتم الرجوع إلى العارض الثلاثي الأبعاد بشكل سلس. 3d_preferred: يتم تشغيل هذه الميزة دائمًا من خلال عارض ثلاثي الأبعاد، ويمكن للمستخدمين التبديل يدويًا إلى عارض بتقنية "الواقع المعزّز". وفي حال عدم توفّر "خدمات Google Play للواقع المعزّز"، لا يمكن للمستخدمين التبديل من العارض الثلاثي الأبعاد. 3d_only: يتم العرض دائمًا في عارض ثلاثي الأبعاد فقط، ولا يمكن للمستخدمين التبديل إلى عارض الواقع المعزّز.	دعم أوسع نطاق ممكن من الأجهزة. الرجوع تلقائيًا إلى الوضع الثلاثي الأبعاد الأصلي في Scene Viewer لحالات الاستخدام غير الواقع المعزّز.
من زر أو رابط على موقع إلكتروني أو تطبيق Android، يمكنك تشغيل عرض الواقع المعزّز الأصلي لنموذج ثلاثي الأبعاد. إذا كانت "خدمات Google Play للواقع المعزّز" غير متوفّرة على الجهاز، عليك التحكّم في السلوك الاحتياطي.	شغِّل عارض المشهد باستخدام هدف صريح لـ "خدمات Google Play للواقع المعزّز" (ARCore)، واختَر أحد إعدادات mode المناسبة لعرض النموذج الثلاثي الأبعاد. ar_preferred: يتم تشغيل هذه الميزة دائمًا في عارض الواقع المعزّز، ويمكن للمستخدمين التبديل يدويًا إلى عارض ثلاثي الأبعاد. في حال عدم توفّر "خدمات Google Play للواقع المعزّز"، يعود تطبيق Scene Viewer إلى السلوك الذي تضبطه. ar_only: يتم عرض هذه الميزة دائمًا في عارض الواقع المعزّز فقط، بدون إمكانية التبديل إلى عارض ثلاثي الأبعاد. في حال عدم توفّر "خدمات Google Play للواقع المعزّز"، يتم الرجوع إلى السلوك الذي تضبطه. على سبيل المثال، يمكنك إطلاق تجربة ثلاثية الأبعاد بملء الشاشة أو عرض رسالة خطأ بسيطة تشير إلى أنّ جهاز المستخدم لا يتوافق بعد مع إمكانات الواقع المعزّز.	يمكنك استخدام عارض نماذج ثلاثية الأبعاد بنفسك أو تقديم ردّ احتياطي آخر من تصميمك في حالات الاستخدام غير الواقع المعزّز.
يمكنك استضافة عرض مضمّن لنموذج ثلاثي الأبعاد على موقعك الإلكتروني، والسماح للمستخدم بالدخول يدويًا إلى وضع "الواقع المعزّز" الأصلي بملء الشاشة.	استخدِم <model-viewer> أو أي عارض ثلاثي الأبعاد آخر مستند إلى الويب لتشغيل تطبيق Scene Viewer الذي يعرض النموذج الثلاثي الأبعاد في الواقع المعزّز.	يمكنك تشغيل Scene Viewer في الواقع المعزّز مباشرةً من نموذج ثلاثي الأبعاد مضمّن في صفحة ويب. قدِّم للمستخدمين تجربة ثلاثية الأبعاد على سطح تملكه وتتحكّم فيه، مع خيار نقلهم تدريجيًا إلى تجربة واقع معزّز أكثر شمولية بعد فهم الغرض من ذلك.

تشغيل "عارض المشهد" باستخدام هدف صريح (ثلاثي الأبعاد أو الواقع المعزّز)

لإتاحة أكبر عدد ممكن من الأجهزة التي تعمل بنظام التشغيل Android، يمكنك استخدام هدف Android فاضح لتشغيل Scene Viewer. يمكن تشغيل الغرض الصريح من صفحة HTML أو تطبيق Android أصلي. وسيعالج تطبيق Google المثبَّت مسبقًا على أجهزة Android المتوافقة مع ARCore.

واستنادًا إلى إمكانيات الجهاز ومعلمات الغرض التي تم ضبطها، يمكن وضع النماذج الثلاثية الأبعاد التفاعلية في بيئة المستخدم أو العودة لعرضها في عارض ثلاثي الأبعاد.

• إذا كانت "خدمات Google Play للواقع المعزّز" متوفّرة على الجهاز، كما هو محدَّث، سيعرض تطبيق "Scene Viewer" النموذج النموذجي في وضع الواقع المعزّز أو العرض الثلاثي الأبعاد.

• في حال عدم توفّر "خدمات Google Play للواقع المعزّز" أو عدم تحديثها، يعود "عارض المشهد" بشكل أنيق إلى عرض النموذج في عرض ثلاثي الأبعاد.

• في حال تعذّر عرض تصميم ثلاثي الأبعاد، بسبب عدم تثبيت تطبيق Google أو لأنّه إصدار قديم مثلاً، سيتم استخدام المَعلمة S.browser_fallback_url لعرض صفحة ويب احتياطية بدلاً من ذلك.

تشغيل Scene Viewer من HTML أو Java

HTML

لتشغيل الغرض الصريح من HTML، استخدِم البنية التالية:

<a href="intent://arvr.google.com/scene-viewer/1.0?file=https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/master/2.0/Avocado/glTF/Avocado.gltf#Intent;scheme=https;package=com.google.android.googlequicksearchbox;action=android.intent.action.VIEW;S.browser_fallback_url=https://developers.google.com/ar;end;">Avocado</a>

Java

لتشغيل الغرض الصريح من لغة Java، استخدِم الرمز التالي:

Intent sceneViewerIntent = new Intent(Intent.ACTION_VIEW);
sceneViewerIntent.setData(Uri.parse("https://arvr.google.com/scene-viewer/1.0?file=https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/master/2.0/Avocado/glTF/Avocado.gltf"));
sceneViewerIntent.setPackage("com.google.android.googlequicksearchbox");
startActivity(sceneViewerIntent);

تحديد إصدارات الأهداف

تتم الإشارة إلى نسخة الغرض من خلال رقم الإصدار بعد arvr.google.com/scene-viewer. على سبيل المثال، تم استخدام الإصدار 1.0. عند الحاجة إلى ميزات جديدة في Scene Viewer، يمكنك تشغيل Scene Viewer بإصدار أعلى من أهدافه يتوافق مع الميزات التي تطلبها.

أتاح الإصدار 1.1 من Intent دعم روابط intent:// التي يمكن تشغيلها مباشرةً في تطبيق Android بدلاً من عنوان URL. إذا كنت تريد أن يضمن تطبيق Scene Viewer أن تكون هذه الوظيفة متاحة عند تشغيلها، ولا تريد تشغيلها في الحالات الأخرى، عليك تشغيل "عارض المشهد" بغرض intent://arvr.google.com/scene-viewer/1.1.

مَعلمات النيّة بالشراء

تتوافق المَعلمات التالية مع غرض صريح لحزمة "بحث Google".

مَعلمة الغرض	القيم المسموح بها	التعليقات
file (مطلوب)	عنوان URL صالح	يحدّد عنوان URL هذا ملف glTF أو glb الذي يجب تحميله في Scene Viewer. ويجب أن يحتوي على أحرف إلغاء لعنوان URL.
S.browser_fallback_url (مطلوب للأهداف المستندة إلى HTML)	عنوان URL صالح	هذه ميزة في Google Chrome متاحة فقط لعمليات التنفيذ المستندة إلى الويب. في حال عدم توفّر تطبيق Google على الجهاز، يكون هذا هو عنوان URL الذي ينتقل إليه Google Chrome.
mode (اختياري)	3d_preferred (تلقائي)	يعرض "عارض المشهد" النموذج في الوضع الثلاثي الأبعاد مع زر عرض في مساحتك. في حال عدم توفّر "خدمات Google Play للواقع المعزّز" على الجهاز، سيكون زرّ العرض في مساحتك مخفيًا.
	3d_only	يتم تشغيل "عارض المشهد" مع عرض النموذج في الوضع الثلاثي الأبعاد، حتى في حال توفّر "خدمات Google Play للواقع المعزّز" على الجهاز. ولا يتم عرض الزر عرض في مساحتك مطلقًا.
	ar_preferred	يتم تشغيل "عارض المشهد" في وضع "الواقع المعزّز" الأصلي بصفته وضع الدخول. يتوفر للمستخدم خيار التبديل بين وضعَي الواقع المعزّز والوضع الثلاثي الأبعاد باستخدام الزرَّين عرض في مساحتك وعرض ثلاثي الأبعاد. في حال عدم توفّر "خدمات Google Play للواقع المعزّز"، يعود تطبيق Scene Viewer إلى الوضع الثلاثي الأبعاد في وضع الدخول.
	ar_only	عند استخدام هذه القيمة، يجب الإطلاق من خلال هدف فاضح من Android إلى com.google.ar.core. ملاحظة: لا تستخدم وضع ar_only عند تشغيل الجهاز من خلال هدف Android صريح على تطبيق Google.
link (اختياري)	عنوان URL صالح	تمثّل هذه السمة عنوان URL لصفحة ويب خارجية. وفي حال توفّره، سيظهر زر في واجهة المستخدم يؤدي إلى عنوان URL هذا عند النقر عليه.
title (اختياري)	سلسلة صالحة	اسم النموذج. وفي حال توفّره، سيتم عرضه في واجهة المستخدم. سيتم اقتطاع الاسم بعلامات حذف بعد 60 حرفًا.
الصوت (اختياري)	عنوان URL صالح	عنوان URL يؤدي إلى مقطع صوتي متكرّر تتمّ مزامنته مع أوّل صورة متحركة مضمّنة في ملف glTF. ويجب تقديمه مع تنسيق glTF مع صورة متحركة ذات طول مطابق. وفي حال توفُّره، يتم تكرار الصوت بعد تحميل النموذج. ويجب أن يحتوي على أحرف إلغاء لعنوان URL.
resizable (اختياري)	true (تلقائي) false	عند ضبط هذه السياسة على false، لن يتمكّن المستخدمون من تغيير حجم النموذج في تجربة الواقع المعزّز. يعمل تغيير الحجم بشكل طبيعي في تجربة الأبعاد الثلاثية.
enable_vertical_placement (اختياري)	false (تلقائي) true	وعند ضبط هذه السياسة على true، سيتمكّن المستخدمون من وضع النموذج على سطح عمودي.

إرشادات حول تجربة المستخدم

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

بالنسبة إلى تجارب العارض الثلاثي الأبعاد، نقترح استخدام عبارة تحث المستخدم على اتخاذ إجراء تحمل التصنيف عرض ثلاثي الأبعاد وتبدو كإحدى الصور التالية:

تشغيل Scene Viewer باستخدام هدف صريح مع "خدمات Google Play" للواقع المعزّز (وضع "الواقع المعزّز" فقط)

يتم تشغيل وضع "الواقع المعزّز" في "عارض المشهد" من خلال "خدمات Google Play للواقع المعزّز".

لضمان توفُّر ميزة "الواقع المعزّز" في تطبيق Scene Viewer، يمكنك استخدام هدف Android فاضح من موقع إلكتروني أو تطبيق Android أصلي لتشغيل Scene Viewer عبر com.google.ar.core package وتقديم browser_fallback_url. بهذه الطريقة، يمكنك التأكّد من أنّ جميع المستخدمين لديهم تجربة الواقع المعزّز أصلية عبر Scene Viewer أو تجربة احتياطية أنشأتها بنفسك. على سبيل المثال، يمكنك إنشاء تجارب احتياطية مثل العارض الثلاثي الأبعاد أو ظهور رسالة خطأ رشيقة.

لتشغيل الغرض الصريح من HTML، استخدِم البنية التالية:

<a href="intent://arvr.google.com/scene-viewer/1.0?file=https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/master/2.0/Avocado/glTF/Avocado.gltf&mode=ar_only#Intent;scheme=https;package=com.google.ar.core;action=android.intent.action.VIEW;S.browser_fallback_url=https://developers.google.com/ar;end;">Avocado</a>;

لتشغيل الغرض الصريح من لغة Java، استخدِم الرمز التالي:

Intent sceneViewerIntent = new Intent(Intent.ACTION_VIEW);
Uri intentUri =
    Uri.parse("https://arvr.google.com/scene-viewer/1.0").buildUpon()
    .appendQueryParameter("file", "https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/master/2.0/Avocado/glTF/Avocado.gltf")
    .appendQueryParameter("mode", "ar_only")
    .build();
sceneViewerIntent.setData(intentUri);
sceneViewerIntent.setPackage("com.google.ar.core");
startActivity(sceneViewerIntent);

مَعلمات النيّة بالشراء

تتوافق المَعلمات التالية مع هدف صريح لحزمة "خدمات Google Play" للواقع المعزّز.

مَعلمة الغرض	القيم المسموح بها	التعليقات
browser_fallback_url (مطلوب للأهداف المستندة إلى HTML)	عنوان URL صالح	ولا يتوفّر هذا إلا في عمليات التنفيذ المستندة إلى الويب. في حال عدم توفّر "خدمات Google Play للواقع المعزّز" على الجهاز أو عدم تحديثها، يكون هذا هو عنوان URL الذي يتم الانتقال إليه.
mode (اختياري)	ar_only	يشغِّل تطبيق Scene Viewer دائمًا النموذج الثلاثي الأبعاد في عرض الواقع المعزّز الأصلي ويخفي أي واجهة مستخدم عند التبديل إلى العارض ثلاثي الأبعاد Scene Viewer. في حال عدم توفّر "خدمات Google Play للواقع المعزّز"، سيُشغِّل تطبيق Scene Viewer عنوان URL الذي حدّدته في browser_fallback_url للتجارب المستندة إلى الويب. بالنسبة إلى التجارب المستندة إلى التطبيقات، يعود تطبيق Scene Viewer إلى تجربة بديلة، مثل ظهور رسالة خطأ أو تجربة أخرى أنشأتها بنفسك.
	ar_preferred	يتم تشغيل تطبيق Scene Viewer في وضع الواقع المعزّز الأصلي كوضع الدخول، ويوفّر للمستخدمين خيار التبديل بين وضعَي الواقع المعزّز والوضع الثلاثي الأبعاد باستخدام الزرَّين العرض في مساحتك والعرض الثلاثي الأبعاد. في حال عدم توفّر "خدمات Google Play للواقع المعزّز"، سيُشغِّل تطبيق Scene Viewer عنوان URL الذي حدّدته في browser_fallback_url للتجارب المستندة إلى الويب. بالنسبة إلى التجارب المستندة إلى التطبيقات، يعود تطبيق Scene Viewer إلى تجربة بديلة، مثل ظهور رسالة خطأ أو تجربة أخرى أنشأتها بنفسك.
link (اختياري)	عنوان URL صالح	تمثّل هذه السمة عنوان URL لصفحة ويب خارجية. وفي حال توفّره، سيظهر زر في واجهة المستخدم يؤدي إلى عنوان URL هذا عند النقر عليه. أتاح الإصدار 1.1 إمكانية استخدام روابط intent:// في Scene Viewer للسماح لزر الانتقال إلى "مشاهد المشهد" بالتشغيل مباشرةً في التطبيقات الأخرى. يجب توخّي الحذر عند استخدام هذه السمة ولا يجب تحديدها إلا عندما يضمن توفّر معالج النية للغرض المحدّد.
title (اختياري)	سلسلة صالحة	اسم النموذج. وفي حال توفّره، سيتم عرضه في واجهة المستخدم. سيتم اقتطاع الاسم بعلامات حذف بعد 60 حرفًا. أتاح الإصدار 1.1 استخدام أنماط HTML لمحتوى العنوان، مع السماح بقدرٍ عشوائي من النصوص. يجب أن يتضمّن العنوان أحرف إلغاء لعنوان URL.
sound (اختياري)	عنوان URL صالح	عنوان URL يؤدي إلى مقطع صوتي متكرّر تتم مزامنته مع الصورة المتحركة الأولى المضمّنة في ملف glTF. ويجب تقديمه إلى جانب صورة glTF مع صورة متحركة ذات طول مطابق. وفي حال توفّره، يتم تكرار الصوت بعد تحميل النموذج.
resizable (اختياري)	true (تلقائي) false	عند ضبط هذه السياسة على false، لن يتمكّن المستخدمون من تغيير حجم النموذج في تجربة الواقع المعزّز. يعمل تغيير الحجم بشكل طبيعي في تجربة الأبعاد الثلاثية.
disable_occlusion (اختياري)	false (تلقائي) true	عند ضبط القيمة على true، تظهر العناصر الموضوعة في المشهد دائمًا أمام عناصر حقيقية في المشهد. لمزيد من المعلومات، يمكنك الاطّلاع على [تفعيل التظليل](/ar/develop/depth#enable_occlusion).

إرشادات حول تجربة المستخدم

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

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

• من المحتمَل ألا تكون خدمات Google Play للواقع المعزّز مثبتة على أجهزتهم. إليك كيفية تعامل <model-viewer> مع العنصر الاحتياطي ويمكنك استخدام هذا الجزء من الرمز كنقطة بداية

  // Check whether this is an Android device.
  const isAndroid = /android/i.test(navigator.userAgent);
  // This fallback URL is used if the Google app is not installed and up to date.
  const fallbackUrl = 'https://arvr.google.com/scene-viewer?file=https%3A%2F%2Fstorage.googleapis.com%2Far-answers-in-search-models%2Fstatic%2FTiger%2Fmodel.glb&link=https%3A%2F%2Fgoogle.com&title=Tiger';
  
  // This intent URL triggers Scene Viewer on Android and falls back to
  // fallbackUrl if the Google app is not installed and up to date.
  const sceneViewerUrl = 'intent://arvr.google.com/scene-viewer/1.0?file=https://storage.googleapis.com/ar-answers-in-search-models/static/Tiger/model.glb&title=Tiger#Intent;scheme=https;package=com.google.android.googlequicksearchbox;action=android.intent.action.VIEW;S.browser_fallback_url=' +
      fallbackUrl + ';end;';
  
  // Create a link.
  var a = document.createElement('a');
  a.appendChild(document.createTextNode('Tiger'));
  // Set the href to the intent URL on Android and the fallback URL
  // everywhere else.
  a.href = isAndroid ? sceneViewerUrl : fallbackUrl;
  // Add the link to the page.
  document.body.appendChild(a);
  

استخدام <model-viewer> لتشغيل Scene Viewer

يمكنك تفعيل Scene Viewer من موقعك الإلكتروني عن طريق تضمين مكوّن الويب <model-viewer> مع السمة ar.

<model-viewer ar
              ar-modes="scene-viewer webxr quick-look"
              alt="A 3D model of an astronaut."
              src="Astronaut.gltf"></model-viewer>

عند عرض الموقع الإلكتروني على جهاز Android متوافق مع ARCore، يعرض الموقع الإلكتروني الذي يتضمّن المكوِّن <model-viewer> مع السمة ar زرًا كما هو موضّح في المثال التالي.

عند استخدام الوضع scene-viewer في ar-modes، يتم التبديل إلى عرض الواقع المعزّز الأصلي ويدعو المستخدم إلى وضع النموذج في بيئته باستخدام Scene Viewer.

في حال عدم توفّر "خدمات Google Play" مع الواقع المعزّز، سيؤدي النقر على هذا الزر إلى عرض النموذج في العارض الثلاثي الأبعاد لـ <model-viewer>.

راجِع مستندات <model-viewer> لمزيد من المعلومات حول كيفية بدء استخدام <model-viewer>.

متطلبات الملفات للنماذج

يتوفر في Scene Viewer الدعم والقيود التالية للنماذج.

إتاحة تنسيقات الملفات	glTF 2.0/glb، باستخدام الإضافات التالية: KHR_materials_unlit KHR_texture_transform
الصور المتحركة	تكرار الرسوم المتحركة للهيكل العظمي تكرار رسوم متحركة صلبة تكرار الرسم المتحرك للتحويل سيتم تشغيل الصورة المتحركة بشكل متكرّر. إذا كان ملف glTF يتضمّن عدة صور متحركة، لن يشغِّل تطبيق Scene Viewer سوى الصورة المتحركة الأولى.
الحدود القصوى المقترَحة	ويعتمد الأداء العام لمواد العرض على فرض قيود ومفاضلات بين الرؤوس والمواد ودرجة دقة القوام والشبكة لكل مادة وعوامل أخرى. اتّبِع الإرشادات التالية لتحسين مواد العرض. عدد المثلّثات: الحدّ الأقصى الذي يُنصح به هو 100,000 مثلّث، لكن استهداف أقل عدد سيحافظ على مستوى أداء عالٍ في "عارض المشهد". من 30000 إلى 50000 هو النطاق المثالي. عدد المواد: الحدّ الأقصى الذي يُنصح به هو 10 مواد، اثنان منها يمكن أن تكون ألفا. استهدِف أقل رقم ممكن للحفاظ على أداء مادة العرض بشكل جيد. الشبكة المتداخلة لكل مادة: 1 الحد الأقصى لدقة الزخرفة: 2048 × 2048 العظام (بما في ذلك المفاصل غير المرجحة): 254 (الحد الأقصى) أوزان العظام لكل حد من الرأس: 4 (الحد الأقصى) الأشعة فوق البنفسجية: أشعة فوق البنفسجية واحدة لكل شبكة (الحد الأقصى) حجم النموذج: 10 ميغابايت (قد تؤدي النماذج الأكبر حجمًا إلى ترك انطباع سيئ لدى المستخدم).
دعم الظل	ويتم عرض الظلال القوية تلقائيًا بواسطة Scene Viewer عند وضع كائن، لذا ننصح بعدم مزج الظلال في نموذجك.
دعم الهيئة	تنسيق PNG: PNG-24، تمت فهرسة PNG-8. يُفضَّل استخدام ملفات JPG عندما لا تكون هناك شفافية لأنّها تقلّل من الحجم. مساحة اللون: sRGB
المادة	سجل PBR
تحميل الملف	HTTPS
المشهد	المحور: اليد اليمنى، مع الخصائص التالية: +X صحيح تم رفع قيمة +Y -Z النقاط للأمام من المصدر (بمعنى آخر، يجب أن تكون "واجهة" مادة العرض مواجهة + Z) المقياس: وحدة واحدة = متر واحد (على النحو المحدّد في مواصفات glTF لضمان وضع النموذج في الواقع المعزّز بمقياس حقيقي)

استخدام أداة المعاينة للتحقق من صحة النماذج الثلاثية الأبعاد

لضمان عرض ملف النموذج الثلاثي الأبعاد بشكل صحيح في Scene Viewer، استخدِم أداة المعاينة على الإنترنت للتحقّق من صحة الملفات على الكمبيوتر الشخصي.

التحقّق من صحة النموذج الثلاثي الأبعاد

للتحقّق من صحة نموذج، تحتاج أداة المعاينة إلى ملف glb أو glTF وأي ملفات صور وسلال مرتبطة وملف صوتي اختياري. سيتم تكرار الملف الصوتي مع الرسوم المتحركة 0.

يمكنك تحديد عدة ملفات فردية، أو يمكنك اختياريًا وضع glb أو glTF والملفات المرتبطة به في ملف ZIP. (لا تتوافق طريقة ملف ZIP مع الملفات الصوتية).

للتحقق من صحة النموذج الثلاثي الأبعاد:

1. افتح أداة المعاينة على الإنترنت في متصفّح.

2. استخدِم إحدى الطرق التالية لإضافة الملفات إلى أداة المعاينة:

   • السحب والإفلات. اختَر ملف glb أو glTF وجميع الملفات المرتبطة به (أو ملف ZIP يحتوي على هذه الملفات)، واسحب الملفات المحددة أو ملف ZIP إلى أداة المعاينة.

   • من "أداة المعاينة" في أداة المعاينة، اختر Scene Viewer > Load File (عارض المشهد). اختَر ملف glb أو glTF وجميع الملفات المرتبطة به (أو ملف ZIP يحتوي على هذه الملفات)، وانقر على فتح.

بعد تحميل الملفات التي تتكون من النموذج الثلاثي الأبعاد الخاص بك في أداة المعاينة، تعرض وحدة تحكم أسفل المتصفح النتائج، بما في ذلك أي رسائل خطأ.

إضافة نماذج ثلاثية الأبعاد للتحقق من صحتها

للتحقّق من صحة نموذج ثلاثي الأبعاد، أضِف الملفات التي تشكِّل النموذج الثلاثي الأبعاد إلى أداة محرّر النماذج.

للتحقق من صحة نموذج، تحتاج أداة المعاينة إلى ملف glb أو glTF الخاص بالنموذج وأي ملفات صور وسلال مرتبطة وملف صوتي اختياري. يمكنك تحديد عدة ملفات فردية أو إضافة ملف ZIP واحد.

عند إضافة ملف ZIP، يحمِّل المعاينات أول glb أو glTF، بالإضافة إلى الصورة المرتبطة وملفات bin داخل ملف zip هذا.

1. افتح أداة "محرِّر النماذج" في أحد المتصفحات.

2. استخدِم إحدى الطرق التالية لإضافة الملفات إلى أداة المعاينة:

   • لسحب الملفات وإفلاتها للتحقق، اختَر ملف glb أو glTF وأي ملفات مرتبطة به (أو اختَر ملف ZIP يحتوي على هذه الملفات) واسحبه إلى أداة المعاينة.

   • اختيار الملفات من "أداة المعاينة" في أداة المعاينة، اختر Scene Viewer > Load File (عارض المشهد). اختَر عدة ملفات glb أو glTF وجميع الملفات المرتبطة به (أو ملف ZIP يحتوي على هذه الملفات)، وانقر على فتح.

أخطاء التحقّق من الصحة

رمز الخطأ	درجة الخطورة	مراسلة	القيم المسموح بها الحالية
INVALID_INPUT_FILE_EXTENSION	خطأ	يحتوي ملف الإدخال [filename] على امتداد ملف غير متوافق مع أداة التحقّق.	['.glb', '.gltf']
REC_INPUT_BINARY_SIZE_EXCEEDED	تحذير	ملف الإدخال الذي قدّمه المستخدم له حجم ثنائي يتجاوز الحدّ المسموح به في مواصفات Scene Viewer، علمًا أنّ الحد الأقصى للحجم الموصى به هو [size] ميغابايت.	10
MAX_INPUT_BINARY_SIZE_EXCEEDED	خطأ	ملف الإدخال الذي قدّمه المستخدم له حجم ثنائي يتجاوز الحدّ الأقصى المسموح به في مواصفات Scene Viewer، علمًا أنّ الحد الأقصى للحجم يبلغ [size] ميغابايت.	15
UNSUPPORTED_GLTF_EXTENSION_USED	خطأ	لا تتوافق الإضافة [ext] في glTF مع مواصفات Scene Viewer.	['KHR_materials_pbrSpecularGlossiness', 'KHR_materials_unlit', 'KHR_texture_transform']
ANIMATION_LIMIT_EXCEEDED	خطأ	يتجاوز عدد الصور المتحركة في تنسيق glTF الحدّ الأقصى المسموح به في مواصفات Scene Viewer، وهو الحدّ الأقصى لعدد الصور المتحركة الذي يبلغ [num].	1
MORPH_TARGET_USED	خطأ	يحتوي تنسيق glTF على هدف تشكيل لا يتوافق مع مواصفات Scene Viewer.
MATERIAL_LIMIT_EXCEEDED	تحذير	يتجاوز عدد المواد في تنسيق glTF الحدّ الأقصى الذي تنص عليه مواصفات Scene Viewer، وهو يصل إلى [num] من المواد كحدّ أقصى.	10
TEXTURE_RESOLUTION_LIMIT_EXCEEDED	تحذير	تتجاوز درجة دقة الصورة في الفهرس [idx] في تنسيق glTF الحدّ الأقصى الذي تنصح به مواصفات Scene Viewer، علمًا أن الحد الأقصى لدقة الصورة هو [res] x [res].	2048 x 2048
UV_LIMIT_EXCEEDED	خطأ	يزيد عدد الأشعة فوق البنفسجية لكل شبكة في تنسيق glTF عن الحدّ الأقصى الذي تسمح به مواصفات Scene Viewer، وهو الحدّ الأقصى لعدد الأشعة فوق البنفسجية الذي يبلغ [عدد] من الأشعة فوق البنفسجية لكل شبكة.	1
VERTEX_COLOR_USED	خطأ	يحتوي تنسيق glTF على لون رأس لا يتوافق مع مواصفات Scene Viewer.
JOINT_LIMIT_EXCEEDED	خطأ	يتجاوز عدد المفاصل في تنسيق glTF الحدّ الأقصى المسموح به في مواصفات Scene Viewer، وهو [num] كحدّ أقصى.	254
TRIANGLE_LIMIT_EXCEEDED	تحذير	يتجاوز عدد المثلثات في تنسيق glTF الحدّ الأقصى الذي تنص عليه مواصفات Scene Viewer، وهو [num] كحد أقصى.	100000
PRIMITIVE_MODE_UNSUPPORTED	خطأ	الوضع الأساسي [mode] غير متوافق مع مواصفات Scene Viewer.	{4 : قائمة مثلثة، 5 : شريط مثلث، 6 : مروحة مثلثة}
MISSING_PBR_METALLIC_ROUGHNESS	المعلومات	لا تتضمّن المادة في الفهرس [idx] السمة pbrMetallicRoughness. ولا يكون هذا الإجراء مطلوبًا في مواصفات Scene Viewer إذا تم استخدام عوامل المعدن والخشونة بدلاً من ذلك. وفي حال استخدام أي من هاتين الطريقتين، ستستخدم المادة قيمًا تلقائية، ما قد يؤدي إلى سلوك غير مقصود.