איך מתעדים ומנתחים עקבות ביצועים ב-Android XR Engine Hub

מכשירי XR רלוונטיים

ההנחיות האלה יעזרו לכם ליצור חוויות למכשירי XR מהסוגים הבאים.

מידע ולמידה על סוגי מכשירי XR ←

מידע ולמידה על סוגי מכשירי XR ←

Android XR Engine Hub מאפשר לתעד עקבות של ביצועי המערכת והאפליקציה בתדירות גבוהה ישירות ממכשיר Android XR המחובר. כשההקלטה של המעקב מסתיימת, Android XR Engine Hub מבצע באופן אוטומטי את הפעולות הבאות:

• שומרת את קובץ המעקב .perfetto בתחנת העבודה ופותחת אותו בממשק המשתמש של Perfetto באינטרנט עם פרמטרים מוגדרים מראש של אזור התצוגה (visStart ו-visEnd).
• הכלי מצמצם את הנתונים הגולמיים של .perfetto שנלכדו באופן מקומי בתחנת העבודה, ומסכם אותם בטקסט תמציתי של ניצול המעבד (CPU) וה-GPU, נתונים סטטיסטיים של זמן רינדור פריים ופריימים חסרים.
• שליחת סיכום המעקב המצומצם ל-Gemini (כשהוא מוגדר עם מפתח ה-API שלכם) כדי לאבחן צווארי בקבוק בקצב הפריימים ולספק המלצות לפעולות אופטימיזציה ישירות ב-Hub.

הגדרת מפתח ה-API של Gemini

ניתוח נתוני המעקב מבוסס-AI משתמש בתהליך עבודה של "הבאת מפתח משלך" (BYOK) עם מפתח API של Google AI Studio. אם לא תגדירו מפתח API, עדיין תוכלו לתעד מעקבים ולבדוק אותם בממשק המשתמש של Perfetto באינטרנט, אבל לא יופעלו אבחונים אוטומטיים של Gemini.

כדי להגדיר את מפתח ה-API של Gemini:

1. מקבלים מפתח Gemini API מ-Google AI Studio.
2. פותחים את Android XR Engine Hub ובוחרים באפשרות Settings בסרגל הצד הימני (או לוחצים על Add Gemini API Key in Settings בדף Performance).
3. בשדה Gemini API key, מדביקים את מפתח ה-API.

4. לוחצים על שמירה.

   אתם יכולים לעדכן את מפתח ה-API בכל שלב, או לנקות את השדה Gemini API key וללחוץ על Save כדי להסיר את המפתח השמור מתחנת העבודה.

תיעוד וניתוח של נתוני מעקב אחר ביצועים

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

1. מחברים את מכשיר Android XR לתחנת העבודה באמצעות כבל USB-C ובוחרים אותו מהתפריט הנפתח של המכשיר בחלק העליון של Android XR Engine Hub.

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

3. בסרגל הצד הימני של הניווט ב-Android XR Engine Hub, לוחצים על Performance.

4. בכרטיס XR Device Tracing, לוחצים על Start Recording ומשחזרים את האינטראקציה או את הבעיה בביצועים במכשיר ה-XR.

   

5. כשמסיימים, לוחצים על Stop Recording או מחכים שהמעקב ייפסק באופן אוטומטי כשיגיע למגבלת הזמן של 30 שניות.

בסיום ההקלטה, Android XR Engine Hub מעבד את הנתונים שצולמו ומציג את התוצאות בשלוש דרכים:

• ממשק המשתמש של Perfetto באינטרנט: דפדפן ברירת המחדל פותח את המעקב שצולם בממשק המשתמש של Perfetto באינטרנט כדי שתוכלו לבדוק את הטראקים המפורטים של ציר הזמן, את הידור ההצללה ואת תזמון השרשורים.
• תוצאת ניתוח הביצועים: אם הגדרתם מפתח Gemini API, בחלונית תוצאת ניתוח הביצועים מוצגת ההודעה ניתוח המעקב באמצעות Gemini בזמן שסיכום המעקב המקומי נבדק, ואז מוצג דוח מובנה שמדגיש את צווארי הבקבוק העיקריים, הפריימים שהוחמצו והצעות לתיקונים. לוחצים על סמל ההעתקה בפינה הימנית העליונה של החלונית כדי להעתיק את הדוח בפורמט Markdown ללוח.
• קובצי מעקב מקומיים: לוחצים על מעקבים בכרטיס מעקב אחר מכשיר XR כדי לפתוח את תיקיית הפלט המקומית שמכילה את קובצי ה-.perfetto השמורים.