הנחיות להסמכת שינוי מקור אודיו

הכנה להסמכה

• מכינים מכשירים לבדיקה.
  • תצטרכו 5 מכשירי Android.
    • המכשירים האלה צריכים לכלול:
      • לפחות מכשיר אחד עם Android T ‏ (13) ומכשיר אחד עם Android V ‏ (15).
      • לפחות מכשיר אחד של סמסונג ומכשיר אחד של Pixel.
      • לדוגמה:
        • ‫1 OnePlus (Android 10).
        • ‫3 Samsung (Android 11, ‏ 12, ‏ 13).
        • ‫1 Pixel (Android 15).
  • מכשיר אחד ללא שינוי מקור אודיו:
    • כל אייפון, PC, מחשב נייד עם Bluetooth (BT) או טלפון Android שבו שינוי מקור אודיו מושבת.
      • אפשר להשבית את ההגדרה 'שינוי מקור אודיו' מתוך ההגדרה 'פרטים על מכשיר Bluetooth'.
    • תרחיש הבדיקה 2.8 של Multipoint (MP) צריך מכשיר בלי שינוי מקור אודיו בנוסף ל-5 טלפונים לבדיקה.

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

  • ההגדרה הזו גם מאפשרת ל-Google לאסוף נתוני בדיקה דרך Google Analytics.

קלאסי עם A2DP+HFP

• מוודאים שבכל מכשירי Android מותקנת גרסה 23.xx.xx ואילך של GmsCore.

‫BLE עם LE Audio

• לפחות שניים מהטלפונים שמשמשים כהפניה צריכים לתמוך ב-LE Audio.
  • לדוגמה, טלפון סמסונג אחד וטלפון Pixel אחד שתומכים ב-LE Audio.
• מוודאים שבכל מכשירי Android מותקנת גרסה 24.33.xx ואילך של GmsCore.

קריטריונים לאישור

• שיעור ההצלחה של החלפת היעד צריך להיות מעל 95% בכל תרחישי הבדיקה.

• בבדיקות שדורשות מעבר, החיבור לפרופיל והמעבר למצב פעיל צריכים להסתיים תוך 3 שניות אחרי הפעלת אירועי אודיו ב-75% מהמקרים לפחות.

קלאסי עם A2DP+HFP

צריך לבצע בדיקות עצמיות בשילובים הבאים:

• טלפון א' = Android S ‏ (12) + טלפון ב' = Android T ‏ (13)
• טלפון א' = Android T ‏ (13) + טלפון ב' = Android S ‏ (12)

‫BLE עם LE Audio

צריך לבצע בדיקות עצמיות בשילובים הבאים:

• טלפון א': BT Classic, טלפון ב': BT Classic
• טלפון א': LE Audio, טלפון ב': BT Classic
• טלפון א': BT Classic, טלפון ב': LE Audio

אופציונלי: ספקי שירות שתומכים בחיבורים כפולים של LE Audio צריכים לבדוק:

• טלפון א': LE Audio, טלפון ב': LE Audio

מדריך לבדיקה

הכנה של המכשיר הנבדק (DUT)

• מוודאים שמכשיר ה-BT לא שויך בעבר לאף טלפון שמחובר לחשבון Google של הבדיקה.
  • אם המכשיר שויך לחשבון Google של הבדיקה, צריך לבטל את השיוך באופן הבא:
    • ברשימת המכשירים המותאמים:
      • עוברים להגדרות ה-Bluetooth.
      • בוחרים באפשרות 'שכחת המכשיר'.
      • מפעילים מצב טיסה ולאחר מכן מכבים אותו.
  • מוודאים שהאפשרות 'שמירה אוטומטית של מכשירים' מופעלת.
    • המתג הזה מושבת כברירת מחדל.
    • אפשר למצוא את האפשרות הזו בהגדרות > Google > מכשירים > מכשירים שמורים (אחת לכל DUT).
  • מעבירים את מכשיר ה-Bluetooth למצב התאמה.
  • מתאימים את מכשיר ה-Bluetooth הראשון (A).
  • מבצעים התאמה בין מכשירי Bluetooth הבאים לבין מכשירים אחרים (B,‏ C,‏ D וכו').

היקף

• בכל האוזניות מתבצעים בדיקות מתוך הכרטיסיות השונות בדוח הבדיקה העצמית של BT Classic או של BT LE Audio.
• באוזניות שתומכות רק במצב SinglePoint (SP) מופעלות הפעולות הבאות:
  • הכרטיסייה Generic_test.
• באוזניות שתומכות במצב MP, הפעולות הבאות מתבצעות:
  • הכרטיסייה Generic_test.
  • הכרטיסייה Multipoint_only.
• במכשירים מסוג MP שאפשר לעבור בהם למצב SP, מריצים את הפקודות הבאות:
  • הכרטיסייה Generic_test עם MP מושבת.
  • הכרטיסייה Generic_test עם MP מופעל.
  • הכרטיסייה Multipoint_only עם MP מופעל.

השלמת תהליך ההרשמה העצמית והדוח של הבדיקה העצמית

• יוצרים עותק של דוחות הבדיקה העצמית BT Classic או BT LE Audio.
• מריצים את כל מקרי הבדיקה לפחות פעמיים.

• הבדיקות צריכות להתבצע בפורמט הבא:

קלאסי עם A2DP+HFP

• מכשיר ב' יהיה ה-DUT הראשי.
  • מזינים את הפרטים של מכשיר ב' בשדות 'טלפון' ו'מערכת הפעלה' בחלק העליון של התבנית.

מקרה בדיקה לדוגמה:

• טלפונים לבדיקה:

  • מכשיר 1: Samsung (‏Android 13)
  • מכשיר 2: Pixel ‏ (Android 12 או 13) ואחרים.

• בדיקות שבוצעו:

  • סבב 1. מכשיר א'=Samsung S10+‎ (12), מכשיר ב'=Pixel 7 pro (13) עמודה ד': טלפון=Pixel 7 pro, מערכת הפעלה=Android 13
  • סבב 2. מכשיר א'=Pixel 7 pro (13), מכשיר ב'=Pixel 6(12) עמודה ה': טלפון=Pixel 6, מערכת הפעלה=Android 12

דוגמה לבדיקה שהושלמה בתבנית הבדיקה העצמית:

‫BLE עם LE Audio

1. מכשיר א' = Android V ‏ (15) + מכשיר ב' = Android T ‏ (13)
2. מכשיר א' = Android T‏ (13) + מכשיר ב' = Android V‏ (15)
3. מכשיר א'‏=Android T‏ (13) + מכשיר ב'‏=Android S‏ (12)
4. מכשיר א' = Android T‏ (15) + מכשיר ב' = Android V‏ (15)
5. מכשיר ב' יהיה ה-DUT הראשי.
   • מזינים את הפרטים של מכשיר ב' בשדות 'טלפון' ו'מערכת הפעלה' בחלק העליון של התבנית.

מקרה בדיקה לדוגמה:

• טלפונים לבדיקה:

  • מכשיר 1: Samsung (‏Android 13)
  • מכשיר 2: Pixel (Android 15) ואחרים.

• בדיקות שבוצעו:

  • ‫[LEA+BT]: מכשיר א'= Pixel 8 ‏ (15), מכשיר ב'=Pixel 7 pro ‏ (13) עמודה ד': טלפון=Pixel 7 pro, מערכת הפעלה=Android 13
  • ‫[BT+LEA]: עמודה Device A=Pixel 7 (13), ‏ Device B=Pixel 8 (Android 15) E: Phone=Pixel 8, OS=Android 15
  • ‫[BT+BT]: מכשיר א'=Pixel 7 Pro‏ (13), מכשיר ב'=Samsung S10+‎‏ (12) עמודה ה': טלפון=Samsung S10+‎, מערכת הפעלה=Android 12
  • ‫[LEA+LEA]: מכשיר א'=Pixel 8 (15), מכשיר ב'=Pixel 8(15) עמוד ה':<0x0A>טלפון=Pixel 8, מערכת הפעלה=Android 15

דוגמה לבדיקה שהושלמה בתבנית הבדיקה העצמית:

אירועים של אודיו:

• ‫4 הסוגים של אירועי אודיו שנבדקו והאפליקציות המומלצות לבדיקה הם:

  1. התקשר אל:
     1. אפליקציית הטלפון המובנית.
  2. ‫VoIP: כל אפליקציית VoIP תפעל, למשל:
     1. אפליקציית הבדיקה של שינוי מקור האודיו.
     2. FB Messenger.
     3. קו.
     4. וואטסאפ.
     5. ‫Google Meet.
     6. ‫Google Meet.
  3. מדיה: כל נגן אודיו יתאים, למשל:
     1. אפליקציית הבדיקה של שינוי מקור האודיו.
     2. ‫Youtube Music.
     3. Apple Music.
     4. Spotify.
     5. Google Podcasts)
  4. משחק:
     1. אפליקציית הבדיקה של שינוי מקור האודיו.

הערה: פרטים נוספים מפורטים בקטע אפליקציית הבדיקה של שינוי מקור אודיו.

פרטים על ניפוי באגים:

• ההתראות מופעלות אחרי שמצטרפים לקבוצה fp-sass-partner-test. הנה כמה דוגמאות:

  • ההתראה האחרונה על מצב:

  

  • אין התראה על מתג:

  

  הערה: 'המצב האחרון' הוא מצב החיבור בזמן אירוע האודיו, ולא האירוע האחרון הנוכחי.
  • התראה על זמן האחזור של המעבר:

  

מדידת זמן הטעינה

הערה: 'מכשיר מחפש' הוא הטלפון או הטאבלט שמשמשים לחיבור האוזניות בבדיקה, שנקרא גם מכשיר A,‏ B,‏ C,‏ D או E בתרחישי הבדיקה.

• יש שני סוגים של השהיות במעבר:
  1. חיבור פרופיל Bluetooth למכשיר Seeker מנותק.
     • ההודעה הזו כוללת את כל המקרים של SinglePoint וחלק מהמקרים של MP שבהם המכשיר המבוקש (מכשיר ב') מנותק.
  2. החלפת ה-Seeker הפעיל שמחובר.
     • זה כולל חלק מהמקרים של MP שהמכשיר היעד (מכשיר ב') כבר מחובר אליהם.
• יש שתי דרכים לאחזר מידע על זמן האחזור:
  1. אפשר להציג את כל נתוני ההשהיה באמצעות פקודת adb.
     • פרטים נוספים זמינים בקטע זמן האחזור של ה-dump.
     • הפקודה הזו יכולה לספק ולתעד את זמן האחזור אחרי שמסיימים לפחות מקרה בדיקה אחד.
  2. שימוש באפליקציית הבדיקה של שינוי מקור האודיו.
     • אחרי המעבר, זמן האחזור יוצג באפליקציה שפועלת במכשיר היעד של המשתמש.
     • אם לא הייתה החלפה, האפליקציה תציג את הסיבה 'אין החלפה'.

אפליקציית בדיקה לשינוי מקור האודיו:

• שימוש באפליקציה להפעלת אירועים של אודיו ב-VoIP, במדיה או במשחקים במהלך בדיקה עצמית יפשט את הגדרת הבדיקה ויקטין את זמן האחזור של האירועים ב-Seeker.
  • אפשר להוריד את הגרסה העדכנית כאן.
  • כדי להפעיל את הבדיקה של LE Audio VoIP, צריך להפעיל מדיניות באופן ידני: > adb root > adb shell settings put global hidden_api_policy 1 > adb reboot

הערה: כדי לבקש גישה לקישור להורדה, צריך חשבון Google. הענקת הגישה היא תהליך ידני ועשויה להימשך כמה ימים.

• התקנת האפליקציה:
  • מעתיקים את קובץ ה-APK לטלפון הבדיקה ופותחים אותו.
  • אפשר גם להשתמש ב-adb install audio_test_app.apk.

אזהרה: כשפותחים את האפליקציה בפעם הראשונה, צריך לאשר את כל ההרשאות.

• אם מוצגת תיבת דו-שיח שמבקשת גישה להתראות:
  1. לוחצים על 'אישור'.
  2. בוחרים באפשרות FP SASS test (בדיקת FP SASS) ברשימת האפליקציות.
  3. מאשרים גישה להתראות.

סקירה כללית של האפליקציה:

• ספק היעד

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

• המצב הנוכחי

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

• סוג המחפש

  • האפשרות הזו משמשת למעבר בין זרמי אודיו במכשיר.

סוג האודיו

קלאסי עם A2DP+HFP

• VoIP
  • בחירה במצב הזה תשנה את מצב האודיו ל-AudioManager.MODE_IN_COMMUNICATION ותתקשר ל-AudioManager.startBluetoothSco, ואז תפעיל אודיו עם USAGE_VOICE_COMMUNICATION.
  • סוג מקור הנתונים הוא STREAM_VOICE_CALL.
  • מצב החיבור של הספק אמור להשתנות לCONNECTED_HFP תוך 5 שניות.
• מדיה
  • במצב הזה, האודיו יופעל עם תמיכה בפרוטוקול AVRCP. סוג השימוש באודיו הוא: USAGE_MEDIA.
  • מצב החיבור של הספק אמור להשתנות לCONNECTED_A2DP_WITH_AVRCP תוך 5 שניות.
  • סטטוס החיבור עשוי להשתנות לזמן קצר לCONNECTED_A2DP_ONLY כשמתחילים או מפסיקים את החיבור.

• משחק

  • במצב הזה מושמע אודיו שלא תומך ב-AVRCP. סוג השימוש באודיו הוא: USAGE_GAME.
  • מצב החיבור של הספק אמור להשתנות לCONNECTED_A2DP_ONLY תוך 5 שניות.
  הערה: בטלפונים של Samsung, מצב החיבור יהיה CONNECTED_A2DP_WITH_AVRCP ולא CONNECTED_A2DP_ONLY. פרטים נוספים מופיעים בקטע בעיות מוכרות.

‫BLE עם LE Audio

• VoIP

  • בחירה במצב הזה תשנה את מצב האודיו ל-AudioManager.MODE_IN_COMMUNICATION ותפעיל אודיו עם USAGE_VOICE_COMMUNICATION.
  הערה: בגרסאות Android שקודמות ל-Tiramisu (Android 13), אפליקציית הבדיקה קוראת ל-AudioManager.startBluetoothSco כדי להתחיל חיבור אודיו של Bluetooth SCO. אחרת, אפליקציית הבדיקה מתקשרת אל AudioManager.setCommunicationDevice כדי לבחור את מכשיר האודיו שמשמש לתקשורת.
  • סוג מקור הנתונים הוא STREAM_VOICE_CALL.
  • מצב החיבור של הספק אמור להשתנות לCONNECTED_LE_AUDIO_CALL תוך 5 שניות.

• מדיה

  • בחירה במצב הזה תפעיל אודיו עם סוג הזרם STREAM_MUSIC. סוג השימוש באודיו הוא: USAGE_MEDIA.
  • מצב החיבור של הספק אמור להשתנות לCONNECTED_LE_AUDIO_MEDIA_WITH_CONTROL תוך 5 שניות.
  • יכול להיות שמצב החיבור ישתנה לזמן קצר ל-CONNECTED_LE_AUDIO_MEDIA_WITHOUT_CONTROL כשמתחילים או מפסיקים את החיבור.

• משחק

  • אם בוחרים במצב הזה, מושמע אודיו שהמשתמש לא יכול לשלוט בו ישירות. סוג השימוש באודיו הוא: USAGE_GAME.
  • מצב החיבור של הספק אמור להשתנות לCONNECTED_LE_AUDIO_MEDIA_WITHOUT_CONTROL תוך 5 שניות.

• כפתורי הפעלה ועצירה

  • הכפתורים PLAY ו-STOP מפעילים או מפסיקים את האודיו.

• תוצאה של מתג

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

זמן האחזור של ה-Dump

• הפקודה הבאה מאפשרת למשתמשים לתעד מדידות של זמן האחזור כשמריצים בדיקות ידניות: adb shell dumpsys activity service com.google.android.gms/.nearby.discovery.service.DiscoveryService
  • מדידות זמן האחזור מוצגות בקטע NearbyDeviceManager's SwitchHistory:

            NearbyDeviceManager
              Nearby Sass device count: 1
                Sass device - address:XX:XX:XX:XX:XX:XX, name:Googler's Pixel Buds, accountKey:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX, modelId:6edaf7
                  SwitchHistory
                    15:30:21:166 - 15:30:25:201, latency 3035ms, Succeed, SASS_TRIGGERED_CONNECT, SASS switch, A2DP
                    15:34:58:568 - 15:34:58:568, latency 0ms, Succeed, SWITCH_ACTIVE_TO_SELF, SASS switch, HFP
                    15:36:26:615 - 15:36:31:603, latency 1988ms, Succeed, SASS_TRIGGERED_CONNECT, SASS switch, A2DP
                    15:37:56:108 - 15:37:56:250, latency 142ms, Succeed, SWITCH_ACTIVE_TO_SELF, SASS switch, A2DP"

• כל מעבר ש-GmsCore לא יכול למדוד (למשל, מעבר פעיל ל-HFP) יתועד כהשהיה של 0ms.

הפניה לתבניות של יומנים:

בעיות ידועות:

אלה באגים מוכרים שנגרמים על ידי הכלי לאיתור באגים:

1. החלפת אודיו שגויה במשחק.
   • בטלפונים של Samsung, מצב החיבור יהיה CONNECTED_A2DP_WITH_AVRCP ולא CONNECTED_A2DP_ONLY כשמשחקים במשחקים.
   • יכול להיות שבחלק מהמשחקים (למשל Candy Crush) מוזיקת הרקע תופעל מחדש ויופעל אירוע אודיו חדש ללא קלט של משתמשים. יכול להיות שהטלפונים המחוברים יעברו כל הזמן בין מצב אודיו פעיל ללא פעיל בכל טלפון שבו המשחק פתוח.