שכבת-על של ביצועים ב-ARCore

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

הפעלת שכבת-העל של הביצועים

כדי להפעיל את שכבת-העל של הביצועים, פועלים לפי השלבים הבאים:

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

  2. תוכלו להשתמש בפקודת השידור הבאה למנהל הפעילות כדי להפעיל את שכבת-העל של הביצועים באפליקציה.

    # Enables ARCore's performance overlay and saves a setting to your app's
    # Android Shared Preferences, so that the overlay remains enabled in
    # subsequent ARCore sessions.
    
    # Your app must have an actively running ARCore session to receive the broadcast.
    adb shell am broadcast -a com.google.ar.core.ENABLE_PERFORMANCE_OVERLAY
    
  3. יכול להיות תועברו לתפריט Settings כדי לתת לחבילת ARCore הרשאה ליצור שכבות-על. את השלב הזה יש לבצע פעם אחת בלבד. מחפשים את Google Play Services for AR ומעבירים את המתג של ההרשאות ל-Allowed לפני שחוזרים לאפליקציה.

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

השבתת שכבת-העל של הביצועים

כדי להשבית את שכבת-העל של הביצועים, פועלים לפי השלבים הבאים:

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

  2. כדי להשבית את שכבת-העל של ביצועי האפליקציה, השתמשו בפקודת השידור הבאה למנהל הפעילות.

    # Disables ARCore's performance overlay and saves a setting to your app's
    # Android Shared Preferences, so that the overlay remains disabled in
    # subsequent ARCore sessions.
    
    # Your app must have an actively running ARCore session to receive the broadcast.
    adb shell am broadcast -a com.google.ar.core.DISABLE_PERFORMANCE_OVERLAY
    

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

פירוש ערכי השימוש במעבד

בשדה Process CPU Usage מוצג משך זמן המעבד (CPU) שבו תהליך האפליקציה משתמש כרגע, כאחוז מתוך סך כל הזמן הזמין של המעבד (CPU) במכשיר. הערך הזה כולל עומסי עבודה של אפליקציות, עומסי עבודה של ARCore וכל ספרייה אחרת שהאפליקציה משתמשת בה. לדוגמה, בשדה יוצגו שימוש ב-CPU של 25% אם תהליך האפליקציה רוויה באופן מלא ליבת מעבד אחת (CPU) במכשיר עם ארבע ליבות.

שכבת-העל של הביצועים מספקת גם פירוט של השימוש במעבד (CPU) לתכונות ספציפיות של ARCore. הפירוטים האלה מבוטאים גם כאחוז מתוך סך כל הזמן הזמין של המעבד (CPU) במכשיר. עומסי העבודה הם:

בשכבת-העל לא מוצגות תכונות מושבתות או כאלה שמשתמשות בפחות מ-0.1% מזמן המעבד (CPU).