שימוש ב-Scene Viewer להצגת מודלים תלת-ממדיים אינטראקטיביים ב-AR מאפליקציה או מדפדפן ל-Android

נוף לסצנה הוא מכשיר צפייה עשיר שמאפשר חוויות תלת-ממדיות ו-AR מהאתר או מהאפליקציה ל-Android. הוא מאפשר למשתמשים בניידים של Android להציג תצוגה מקדימה, למקם בקלות מודלים תלת-ממדיים שמתארחים באינטרנט וליצור איתם אינטראקציה.

רוב דפדפני Android תומכים ב-Scene Viewer. Square Viewer הוטמעה בהצלחה על ידי שותפים רבים של Google כדי לתמוך באופן מהימן בחוויות תלת-ממד ו-AR. הוא גם מעצים את החוויות האלה בחיפוש Google.

תהליך ההטמעה פשוט:

  • לחוויות מבוססות אינטרנט נדרשות רק קישורים בפורמט תקין בדף אינטרנט.

  • חוויות מבוססות-אפליקציות דורשות שילוב של כמה שורות של קוד Java בלבד.

דרישות זמן ריצה ל-Scene Viewer

כדי להתנסות ב-AR עם סצנת התצוגה, למשתמשים צריכים להיות:

  • מכשיר שתומך ב-ARCore עם Android מגרסה 7.0 Nougat (רמת API 24) ואילך.
  • גרסה עדכנית (עדכנית) של Google Play Services למציאות רבודה. השירות הזה מותקן ומעודכן באופן אוטומטי ברוב המכשירים שתומכים ב-ARCore.
  • גרסה עדכנית של אפליקציית Google. האפליקציה מותקנת מראש ומעדכנת באופן אוטומטי ברוב המכשירים הנתמכים ב-ARCore.

כדי לספק מקרים שבהם Google Play Services למציאות רבודה או ל-Google app לא קיימת או שהגרסאות המותקנות ישנות מדי, ניתן לציין כתובת URL חלופית שמפעילה חוויה חלופית, למשל דף אינטרנט, הודעת שגיאה או חוויית משתמש חלופית שיצרתם.

תרחישים נתמכים

התרחיש המיועד לדוגמה אפליקציה מומלצת יתרונות
באמצעות לחצן או קישור באתר או באפליקציה ל-Android, מפעילים תצוגת AR מקורית של דגם תלת מימד.

אם במכשיר לא קיימים Google Play Services למציאות רבודה, ניתן לחזור בצורה חלקה להצגת הדגם במצב תלת-ממד שמופעל ב-Scene Viewer.
יש להפעיל את סצנת הצילום באמצעות כוונה מפורשת לחבילה של חיפוש Google, ולבחור הגדרת mode מתאימה להצגת המודל התלת-ממדי.
  • ar_preferred: תמיד מופעל במציג AR והמשתמשים יכולים לעבור באופן ידני למציג תלת-ממד. אם אין גישה ל-Google Play Services למציאות רבודה, ניתן לחזור בצורה חלקה להפעלה במציג התלת-ממד.
  • 3d_preferred: תמיד מופעל במציג תלת-ממד, והמשתמשים יכולים לעבור באופן ידני למציג AR. אם אין גישה ל-Google Play Services למציאות רבודה, המשתמשים לא יכולים לצאת ממציג התלת-ממד.
  • 3d_only: תמיד מוצג רק במציג תלת-ממד, והמשתמשים לא יכולים לעבור למציג AR.
  • לספק תמיכה במגוון רחב ככל האפשר של מכשירים.
  • חזרה אוטומטית למצב התלת-ממד המקורי ב-Scene Viewer בתרחישים לדוגמה שאינם מציאות רבודה.
באמצעות לחצן או קישור באתר או באפליקציה ל-Android, מפעילים תצוגת AR מקורית של דגם תלת מימד.

אם במכשיר לא קיימים Google Play Services למציאות רבודה, אפשר לקבוע את אופן הפעולה החלופי.
מפעילים את סצנת הצפייה בסצנה באמצעות כוונה מפורשת של Google Play Services ל-AR (ARCore) ובוחרים הגדרת mode מתאימה להצגת המודל התלת-ממדי.
  • ar_preferred: מתחילה תמיד במציג AR והמשתמשים יכולים לעבור באופן ידני למציג תלת-ממד. אם אין אפשרות להשתמש ב-Google Play Services ל-AR, אפליקציית Sky Viewer תחזור להתנהגות שהגדרתם.
  • ar_only: תמיד מוצג במציג AR בלבד, ללא אפשרות לעבור למציג תלת-ממד. אם אין גישה ל-Google Play Services ל-AR, המערכת תחזור להתנהגות שהגדרתם. לדוגמה, נניח שהפעלת חוויה משלך בתלת-ממד במסך מלא, או שתוצג הודעת שגיאה ידידותית שמציינת שהמכשיר של המשתמש עדיין לא תומך ביכולות AR.
יש לך אפשרות להשתמש במציג המודלים בתלת-ממד משלך או לספק תגובת חלופית אחרת לעיצוב שלך בתרחישים לדוגמה שאינם מציאות רבודה.
ניתן לארח תצוגה מוטבעת של דגם תלת מימד באתר שלך ולאפשר למשתמש להיכנס באופן ידני למצב AR מקורי במסך מלא. אפשר להשתמש ב-<model-viewer> או בכל מציג תלת-ממדי אחר מבוסס-אינטרנט כדי להפעיל את סצנת הצפייה ב-סצנות, שמציגה את המודל התלת-ממדי ב-AR.
  • אפשר להפעיל את סצנת הצפייה ב-AR באופן טבעי ב-AR ישירות ממודל תלת-ממדי שמוטמע בדף אינטרנט.
  • אפשר לספק למשתמשים חוויית תלת-ממד בשטח שנמצא בבעלותך ובשליטתך, עם אפשרות להעביר אותם בהדרגה לחוויית AR סוחפת יותר לאחר שברור להם שהם רוצים לעשות זאת.

הפעלת סצנת הצפייה בסצנה באמצעות כוונה מפורשת (תלת-ממד או AR)

כדי לתמוך בטווח הרחב ביותר של מכשירי Android, עליכם להשתמש בכוונה מפורשת של Android כדי להפעיל את המודעה ב-Scene Viewer. אפשר להפעיל את הכוונה המפורשת מדף HTML או מאפליקציית Android מובנית. אפליקציית Google שהותקנה מראש במכשירי Android שנתמכים ב-ARCore תטופל על ידי הכוונה.

בהתאם לפרמטרים של Intent שהוגדרו וליכולות המכשיר, ניתן למקם מודלים תלת-ממדיים אינטראקטיביים בסביבת המשתמש או לחזור להציג אותם במציג תלת-ממד.

  • אם במכשיר קיימים Google Play Services למציאות רבודה, כפי שהוא עדכני, הכלי יציג את המודל בתצוגה מקורית של AR או בתלת-ממד.

  • אם אין אפשרות להציג את Google Play Services ל-AR או שאינם עדכניים, ב-Scene Viewer חוזרים בצורה חלקה להצגת הדגם בתצוגה תלת-ממדית.

  • אם לא ניתן להציג מודל תלת-ממדי, למשל בגלל שאפליקציית Google לא מותקנת או בגלל שמדובר בגרסה ישנה, הפרמטר S.browser_fallback_url ישמש במקום זאת להצגת דף אינטרנט חלופי.

הפעלת סצנת הצילום מ-HTML או מ-Java

HTML

כדי להפעיל את ה-Intent המפורשת מ-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

כדי להפעיל את ה-Intent המפורשת מ-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);

ניהול גרסאות של Intent

גרסת ה-Intent מצוינת באמצעות מספר הגרסה שאחרי arvr.google.com/scene-viewer. לדוגמה, במהדורה הראשונית השתמשו בגרסה 1.0. כאשר דרושות תכונות חדשות יותר של נוף, ייתכן שתוכלו להפעיל את התכונה נוף עם גרסת Intent גבוהה יותר, שתואמת לתכונות הנדרשות לכם.

בגרסה 1.1 של Intent נוספה תמיכה בקישורי intent://, שניתן להפעיל אותם ישירות באפליקציה ל-Android ולא בכתובת URL. אם אתם רוצים לוודא שהפונקציונליות הזו תהיה זמינה כשתופעל, ולא ניתן יהיה להפעיל אותה בכל מצב אחר, תוכלו להפעיל את התכונה 'מציג סצנה' מתוך כוונה להשתמש ב-intent://arvr.google.com/scene-viewer/1.1.

פרמטרים נתמכים של Intent

הפרמטרים הבאים נתמכים עבור Intent מפורש לחבילת חיפוש Google.

פרמטר של Intent ערכים מותרים תגובות
file (חובה) כתובת URL חוקית כתובת ה-URL הזו מציינת את קובץ ה-glTF או ה-glb שצריך לטעון ל-Scene Viewer. יש לסמן את הכתובת הזו בתו בריחה (escape) של כתובת URL.
S.browser_fallback_url (חובה לאובייקטים מסוג Intent מבוססי HTML) כתובת URL חוקית זוהי תכונה של Google Chrome הנתמכת רק עבור יישומים מבוססי-אינטרנט. כשאפליקציית Google לא קיימת במכשיר, זוהי כתובת האתר שאליה Google Chrome מנווט.
mode (אופציונלי) 3d_preferred (ברירת מחדל) ב-Scene Viewer מוצג הדגם בתלת-ממד באמצעות לחצן צפייה במרחב שלך.



אם במכשיר לא מותקנים Google Play Services ל-AR, הלחצן הצגה במרחב שלך מוסתר.

3d_only התכונה סצנה מופעלת כשהמודל מוצג במצב תלת-ממד, גם אם Google Play Services למציאות רבודה (AR) פועלים במכשיר. הלחצן לצפייה במרחב שלך אף פעם לא מוצג.

ar_preferred סצנת התצוגה בסצנה מופעלת במצב מקורי של AR כמצב הכניסה. המשתמש יכול לעבור בין מצבי AR למצב תלת-ממדי באמצעות הלחצנים צפייה במרחב שלך וצפייה בתלת-ממד.



אם לא ניתן למצוא את Google Play Services ל-AR, ב-Scene Viewer יש חזרה חלקה למצב תלת-ממד כמצב הכניסה.

ar_only כשמשתמשים בערך הזה, יש להפעיל באמצעות Intent מפורש של Android אל com.google.ar.core.

הערה: אין להשתמש במצב ar_only כשמפעילים כוונת Android מפורשת לאפליקציית Google.

link (אופציונלי) כתובת URL חוקית כתובת URL של דף אינטרנט חיצוני. אם יש לחצן כזה, בממשק המשתמש יוצג לחצן שיכוון לכתובת ה-URL הזו.

title (אופציונלי) מחרוזת חוקית שם למודל. אם היא קיימת, היא תוצג בממשק המשתמש. השם יקוצר בשלוש נקודות אחרי 60 תווים.

סאונד (אופציונלי) כתובת URL חוקית כתובת URL לטראק של אודיו שמופעל בלופ, שמסונכרן עם האנימציה הראשונה המוטמעת בקובץ glTF. יש לספק את התג לצד glTF עם אנימציה באורך תואם. אם הוא קיים, הצליל יופעל בלולאה אחרי טעינת המודל. יש לסמן את הכתובת הזו בתו בריחה (escape) של כתובת URL.
resizable (אופציונלי) true (ברירת מחדל)

false

אם המדיניות מוגדרת לערך false, המשתמשים לא יוכלו להתאים את המודל בחוויית ה-AR. קנה המידה פועל כרגיל בתצוגה התלת-ממדית.
enable_vertical_placement (אופציונלי) false (ברירת מחדל)

true

אם המדיניות מוגדרת לערך true, המשתמשים יוכלו להציב את המודל על משטח אנכי.

הדרכה לגבי חוויית המשתמש

כדי לספק למשתמשים את חוויית המשתמש הטובה ביותר, מומלץ להציג את הקריאות לפעולה כדי להבהיר שהמשתמש עומד להיכנס לסביבה סוחפת.

בצפייה בתלת-ממד, אנחנו ממליצים להשתמש בקריאה לפעולה עם התווית צפייה בתלת-ממד שנראית כמו אחת מהתמונות הבאות:

הפעלת Sky Viewer באמצעות כוונה מפורשת לשירותי Google Play ל-AR (מצב AR בלבד)

מצב AR ב-Scene Viewer מופעל על ידי Google Play Services ל-AR.

כדי שה-AR יהיה זמין ב-Scene Viewer, תוכלו להשתמש בכוונה מפורשת של Android מאתר או מאפליקציה מקומית ל-Android כדי להפעיל את נוף ב-סצנה באמצעות com.google.ar.core package ולספק browser_fallback_url. כך תוכלו להבטיח שלכל המשתמשים תהיה חוויית AR מקומית דרך נוף של סצנות או חוויה חלופית שיצרתם בעצמכם. לדוגמה, תוכלו ליצור חוויות גיבוי כמו מציג תלת-ממד או הודעת שגיאה חיננית.

כדי להפעיל את ה-Intent המפורשת מ-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>;

כדי להפעיל את ה-Intent המפורשת מ-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);

פרמטרים נתמכים של Intent

הפרמטרים הבאים נתמכים ב-Intent מפורש לחבילת AR של שירותי Google Play.

פרמטר של Intent ערכים מותרים תגובות
browser_fallback_url (חובה לאובייקטים מסוג Intent מבוססי HTML) כתובת URL חוקית האפשרות הזו נתמכת רק בהטמעות מבוססות-אינטרנט. כששירות Google Play Services למציאות רבודה אינו קיים במכשיר או שאינו עדכני, זו כתובת ה-URL שאליה מתבצע הניווט.
mode (אופציונלי) ar_only התכונה 'הצגת נוף' תמיד מפעילה את המודל התלת-ממדי בתצוגת AR מובנית, ומסתירה כל ממשק משתמש שמאפשר לעבור למציג התלת-ממד ב-Scene Viewer.

אם אין אפשרות להשתמש ב-Google Play Services למציאות רבודה (AR), ב-Scene Viewer משיק את כתובת ה-URL שהגדרתם ב-browser_fallback_url עבור חוויות מבוססות-אינטרנט. בחוויות מבוססות-אפליקציה, סצנת ה-Scene Viewer חוזרת לחוויה חלופית כמו הודעת שגיאה או חוויה אחרת שבנית בעצמך.

ar_preferred התכונה סצנה מופעלת במצב מקורי של AR כמצב הכניסה, ומאפשרת למשתמשים לעבור בין מצבי AR למצב תלת-ממד באמצעות הלחצנים צפייה במרחב שלך וצפייה בתלת-ממד.

אם אין אפשרות להשתמש ב-Google Play Services למציאות רבודה (AR), ב-Scene Viewer משיק את כתובת ה-URL שהגדרתם ב-browser_fallback_url עבור חוויות מבוססות-אינטרנט. בחוויות מבוססות-אפליקציה, סצנת ה-Scene Viewer חוזרת לחוויה חלופית כמו הודעת שגיאה או חוויה אחרת שבנית בעצמך.

   

link (אופציונלי) כתובת URL חוקית כתובת URL של דף אינטרנט חיצוני. אם היא קיימת, כשלוחצים על הלחצן, יוצג בממשק המשתמש לחצן שיכוון לכתובת ה-URL הזו.



לגרסה 1.1 נוספה תמיכה בקישורי Intent:// ב-Scene Viewer כדי לאפשר שלחצן הכניסה ל-Scene יופעל ישירות באפליקציות אחרות. הערה: יש להשתמש באפשרות הזו בזהירות ולציין את המאפיין הזה רק כשמבטיחים ש-handler של Intent יהיה נוכח עבור ה-Intent הנתון.
title (אופציונלי) מחרוזת חוקית שם למודל. אם היא קיימת, היא תוצג בממשק המשתמש. השם יקוצר בשלוש נקודות אחרי 60 תווים.



בגרסה 1.1 נוספה תמיכה בעיצוב HTML של תוכן הכותרת, עם כמות שרירותית של טקסט. הערה: יש לסמן את הכותרת בתו בריחה (escape) של כתובת URL.
sound (אופציונלי) כתובת URL חוקית כתובת URL לטראק של אודיו שמופעל בלופ, שמסונכרן עם האנימציה הראשונה המוטמעת בקובץ glTF. יש לספק את התג לצד glTF עם אנימציה באורך תואם. אם הוא קיים, הצליל יופעל בלופ אחרי טעינת המודל.
resizable (אופציונלי) true (ברירת מחדל)

false

אם המדיניות מוגדרת לערך false, המשתמשים לא יוכלו להתאים את המודל בחוויית ה-AR. קנה המידה פועל כרגיל בתצוגה התלת-ממדית.
disable_occlusion (אופציונלי) false (ברירת מחדל)

true

אם המדיניות מוגדרת לערך true, אובייקטים שממוקמים בסצנה תמיד יופיעו לפני אובייקטים בעולם האמיתי. מידע נוסף זמין במאמר [הפעלת חסימה](/ar/develop/depth#enable_occlusion).

הדרכה לגבי חוויית המשתמש

כדי לספק למשתמשים את חוויית המשתמש הטובה ביותר, מומלץ לפעול לפי ההנחיות הבאות.

  • בחוויות AR, הקריאה לפעולה הגלויה צריכה להבהיר שהמשתמש עומד להיכנס לסביבה סוחפת. מומלץ להשתמש בקריאה לפעולה View in your Space:

  • יכול להיות שהמכשירים של המשתמשים לא מתקינים את Google Play Services למציאות רבודה במכשיר. כך תטפל ב-<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> כדי להפעיל את Session Viewer

כדי להפעיל את Square 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, הוא עובר לתצוגת AR מקורית ומזמין את המשתמשים למקם את הדגם בסביבה שלהם באמצעות Bright Viewer.

אם אין גישה ל-Google Play Services עם AR, הקשה על הלחצן הזה תציג את הדגם במציג התלת-ממד של <model-viewer>.

בתיעוד של <model-viewer> מוסבר איך להתחיל לעבוד עם <model-viewer>.

דרישות קובץ למודלים

ב-Scene Viewer יש את התמיכה והמגבלות הבאות למודלים.

תמיכה בפורמטים של קבצים glTF 2.0/glb, עם התוספים הבאים:
  • KHR_materials_unlit
  • KHR_texture_transform
אנימציה
  • אנימציה של שלד בלופ
  • אנימציה קשיחה בלולאה
  • אנימציה של טרנספורמציה בלופ
האנימציה תופעל בלופ. אם הקובץ glTF מכיל כמה אנימציות, סצנה זו מפעילה רק את האנימציה הראשונה.
מגבלות מומלצות הביצועים הכוללים של הנכסים תלויים במגבלות שהוגדרו וביצירת פשרות בין קודקודים, חומרים, רזולוציית מרקם, רשת לחומר וגורמים אחרים. תוכלו להיעזר בהנחיות הבאות כדי לבצע אופטימיזציה של הנכסים.
  • מספר המשולשים: המגבלה המומלצת היא 100,000 משולשים, אבל טירגוט למספר הנמוך ביותר ישמור על ביצועים גבוהים ב-Scene Viewer. הטווח האידאלי הוא 30,000 עד 50,000.
  • מספר החומרים: המגבלה המומלצת היא 10 חומרים, שניים מהם יכולים להיות אלפא. כדאי לטרגט את המספר הנמוך ביותר האפשרי כדי לשמור על ביצועים טובים.
  • רשת לכל חומר: 1
  • רזולוציית מרקם מקסימלית: 2,048 × 2,048
  • עצם (כולל מפרקים לא משוקללים): 254 (מגבלה קשיחה)
  • משקל עצם לכל גבול קודקוד: 4 (מגבלה קשה)
  • UV: UV אחד לרשת (מגבלה קשיחה)
  • גודל המודל: 10MB (מודלים גדולים יותר עלולים לפגוע בחוויית המשתמש).
תמיכה בצל צלליות קשות מרונדרות באופן אוטומטי על ידי Sky Viewer כשמציבים אובייקט. לכן, מומלץ לא להטמיע צלליות בצילום.
תמיכה במרקמים
  • פורמט PNG: PNG-24, אינדקס PNG-8.
    עדיף להשתמש בקובצי JPG אם אין שקיפות, כי הם מקטינים את הגודל.
  • מרחב צבעים: sRGB
חומר PBR
הקובץ בטעינה HTTPS
סצנה
  • ציר: יד ימין, עם המאפיינים הבאים:
    • +X נכון
    • +Y בעלייה
    • -Z מצביע קדימה מהמקור (כלומר, החלק הקדמי של הנכס צריך להיות מופנה כלפי +Z)
  • קנה מידה: יחידה אחת = מטר אחד (כפי שמוגדר במפרט glTF כדי להבטיח שהמודל ממוקם ב-AR בקנה מידה אמיתי)

שימוש בכלי התצוגה המקדימה לאימות המודלים התלת-ממדיים

כדי לוודא שקובץ המודל התלת-ממדי שלכם יוצג כראוי ב-Scene Viewer, השתמשו בכלי שלנו לתצוגה מקדימה אונליין כדי לאמת את הקבצים במחשב.

אימות המודל התלת-ממדי שלך

כדי לאמת את המודל, לכלי התצוגה המקדימה נדרש קובץ glb או glTF אחד, כל קובץ תמונה ו-bin משויך וקובץ אודיו אופציונלי. קובץ האודיו יתנגן יחד עם אנימציה 0.

אתם יכולים לבחור קבצים ספציפיים בנפרד, ואפשר גם לשמור בקובץ ZIP את קובצי glb או glTF ואת הקבצים המשויכים אליהם. (השיטה של קובץ ZIP לא תומכת בקובצי אודיו).

כדי לאמת את המודל התלת-ממדי:

  1. פותחים בדפדפן את הכלי אונליין לתצוגה מקדימה.

  2. יש להוסיף את הקבצים לכלי התצוגה המקדימה באחת מהשיטות הבאות:

    • גוררים ומשחררים. בוחרים קובץ glb או glTF ואת כל הקבצים המשויכים אליו (או קובץ ZIP שמכיל את הקבצים האלה), וגוררים את הקבצים שנבחרו או את קובץ ה-ZIP לכלי התצוגה המקדימה.

    • מהכלי של התצוגה המקדימה. בכלי התצוגה המקדימה, בוחרים Scene Viewer > Load File (טעינת קובץ). בוחרים קובץ glb או glTF ואת כל הקבצים המשויכים אליו (או קובץ ZIP שמכיל את הקבצים האלה), ולוחצים על Open.

אחרי שטוענים את הקבצים שמורכבים מהמודל התלת-ממדי בכלי התצוגה המקדימה, התוצאות מוצגות במסוף בתחתית הדפדפן, כולל הודעות השגיאה שהתקבלו.

הוספת מודלים תלת-ממדיים לאימות

כדי לאמת מודל תלת-ממדי, צריך להוסיף את הקבצים שמהם מורכב המודל לכלי לעריכת מודלים.

כדי לאמת את המודל, לתצוגה המקדימה נדרש קובץ glb או glTF של המודל, קובצי תמונה ו-bin משויכים וקובץ אודיו אופציונלי. אפשר לבצע בחירה מרובה של קבצים בודדים או להוסיף קובץ ZIP יחיד.

כשמוסיפים קובץ ZIP, הכלי לתצוגה מקדימה טוען את ה-glb או ה-glTF הראשונים שהוא מוצא, וגם את קובצי התמונה והסלים המשויכים בתוך קובץ ה-ZIP.

  1. פותחים את הכלי לעריכת מודלים בדפדפן.

  2. יש להוסיף את הקבצים לכלי התצוגה המקדימה באחת מהשיטות הבאות:

    • כדי לגרור ולשחרר קבצים לאימות, בוחרים כמה קבצים glb או glTF וכל קובץ משויך (או בוחרים קובץ ZIP שמכיל את הקבצים האלה) וגוררים אותו לכלי התצוגה המקדימה.

    • בחירת קבצים מכלי התצוגה המקדימה. בכלי התצוגה המקדימה, בוחרים Scene Viewer > Load File (טעינת קובץ). בוחרים שוב את קובץ glb או glTF ואת כל הקבצים המשויכים אליו (או קובץ ZIP שמכיל את הקבצים האלה) ולוחצים על Open.

שגיאות אימות

קוד שגיאה מידת החומרה מסר ערכים נתמכים נוכחיים
INVALID_INPUT_FILE_EXTENSION שגיאה לקובץ הקלט [filename] יש סיומת קובץ שאינה נתמכת על ידי כלי התיקוף. ['.glb', '.gltf']
REC_INPUT_BINARY_SIZE_EXCEEDED אזהרה הגודל הבינארי של קלט המשתמש שסופק חורג מהמגבלה המומלצת על ידי מפרט Sim Viewer. מגבלת הגודל המומלצת היא [size] MB . 10
MAX_INPUT_BINARY_SIZE_EXCEEDED שגיאה הגודל הבינארי של קלט המשתמש שסופק חורג מהמגבלה המקסימלית הנתמכת על ידי מפרט Simple Viewer. המגבלה היא גודל מקסימלי של MB[size]. 15
UNSUPPORTED_GLTF_EXTENSION_USED שגיאה התוסף [ext] ב-glTF לא נתמך על ידי מפרט סצנת הצפייה. ['KHR_materials_pbrSpecularGlossiness', 'KHR_materials_unlit', 'KHR_texture_transform']
ANIMATION_LIMIT_EXCEEDED שגיאה מספר האנימציות ב-glTF חורג מהמגבלה הנתמכת על ידי מפרט Sim Viewer. מספר האנימציות המקסימלי הנתמך הוא [num]. 1
MORPH_TARGET_USED שגיאה ה-glTF מכיל יעד שינוי שאינו נתמך על ידי מפרט סצנת הצילום.
MATERIAL_LIMIT_EXCEEDED אזהרה מספר החומרים ב-glTF חורג מהמגבלה המומלצת על ידי מפרט Sim Viewer. מספר החומרים המרבי המותר הוא [num]. 10
TEXTURE_RESOLUTION_LIMIT_EXCEEDED אזהרה הרזולוציה של התמונה באינדקס [idx] ב-glTF חורגת מהמגבלה המומלצת על ידי מפרט Sim Viewer, שהוא רזולוציה מרבית של [res] x [res]. 2,048 x 2,048
UV_LIMIT_EXCEEDED שגיאה מספר ה-UV לרשת ב-glTF חורג מהמגבלה הנתמכת על ידי מפרט ה-Scene Viewer. המגבלה הנתמכת המקסימלית היא [num] UV לרשת. 1
VERTEX_COLOR_USED שגיאה ה-glTF מכיל צבע קודקוד שאינו נתמך על ידי מפרט ה-Scene Viewer.
JOINT_LIMIT_EXCEEDED שגיאה מספר החיבורים ב-glTF חורג מהמגבלה הנתמכת על ידי מפרט Sim Viewer. מספר החיבורים המקסימלי הנתמך הוא [num] חיבורים. 254
TRIANGLE_LIMIT_EXCEEDED אזהרה מספר המשולשים ב-glTF חורג מהמגבלה המומלצת על ידי מפרט ה-Scene Viewer. מספר המשולשים המקסימלי הוא [num] משולשים. 100,000
PRIMITIVE_MODE_UNSUPPORTED שגיאה המצב הפרמיטיבי [mode] לא נתמך על ידי מפרט Sky Viewer. {4 : רשימת משולשים, 5 : רצועה משולשת, 6 : מאוורר משולש}
MISSING_PBR_METALLIC_ROUGHNESS מידע בחומר שבאינדקס [idx] חסר המאפיין pbrMetallicRoughness. מפרט סצנת הצפייה ב-סצנה לא נדרש לעשות זאת, אם במקום זאת נעשה שימוש בגורמי מטאליות וחספוס. אם לא ייעשה שימוש באף אחד מאלה, המערכת תשתמש בערכי ברירת המחדל של החומר וייתכן שהתוצאות יהיו שונות ממה שציפית.