הנחיות לאישור העברת אודיו

הכנה לקראת ההסמכה

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

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

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

קלאסי עם A2DP+HFP

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

BLE עם LE Audio

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

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

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

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

קלאסי עם A2DP+HFP

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

  • טלפון A=Android S (12) + טלפון B=Android T (13)
  • טלפון A=Android T (13) + טלפון B=Android S (12)

BLE עם LE Audio

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

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

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

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

מדריך לבדיקה

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

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

היקף

  • כל אוזניות הכפתור מריצים בדיקות מהכרטיסיות השונות תבנית בדיקה עצמית לשינוי מקור אודיו.
  • אוזניות שתומכות במצב SinglePoint (SP) בלבד מפעילות את הדברים הבאים:
    • הכרטיסייה Generic_test.
  • באוזניות שתומכות במצב MP פועלים הדברים הבאים:
    • הכרטיסייה Generic_test.
    • הכרטיסייה Multipoint_only.
  • באוזניות MP שאפשר להעביר למצב SP פועלים הדברים הבאים:
    • הכרטיסייה General_test עם MP מושבתת.
    • הכרטיסייה Generic_test עם MP מופעל.
    • הכרטיסייה Multipoint_only כש-MP מופעל.

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

קלאסי עם A2DP+HFP

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

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

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

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

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

    • הפעלה 1. מכשיר A=Samsung S10+ (12), מכשיר B=Pixel 7 pro (13) עמודה D: טלפון=Pixel 7 Pro, OS=Android 13
    • הפעלה 2. מכשיר A=Pixel 7 pro (13), מכשיר B=Pixel 6(12) עמודה E: טלפון=Pixel 6, OS=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) + מכשיר B=Android V (15)
  5. מכשיר ב' יהיה ה-DUT הראשי.
    • מזינים את הפרטים של מכשיר ב' ב'טלפון' ו-OS שדות בחלק העליון של התבנית.

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

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

    • מכשיר 1: Samsung‏ (Android 13)
    • מכשיר 2: Pixel (Android 15) ועוד.

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

    • [LEA+BT]: Device A= Pixel 8 (15), Device B=Pixel 7 pro (13) column D: Phone=Pixel 7 pro, OS=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) עמודה E: טלפון=Samsung S10+‏, מערכת הפעלה=Android 12
    • [LEA+LEA]: מכשיר א'=Pixel 8‏ (15), מכשיר ב'=Pixel 8‏ (15) עמודה E: טלפון=Pixel 8, מערכת הפעלה=Android 15

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

בתמונה הזו מוצגות התוצאות של בדיקה לדוגמה

אירועי אודיו:

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

    1. התקשרות:
      1. אפליקציית הטלפון המובנית.
    2. VoIP: כל אפליקציית VoIP תפעל, למשל:
      1. אפליקציית הבדיקה של שינוי מקור האודיו.
      2. FB Messenger.
      3. קו.
      4. WhatsApp.
      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. הנה כמה דוגמאות:

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

    איור 1: מוצגת 'ההודעה על המצב האחרון' הודעה.

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

    איור 2: מוצגת ההודעה 'ללא מתג נגישות' הודעה.

    • החלפת ההתרעה על זמן האחזור:

    איור 3: מוצגת 'ההודעה על זמן האחזור של מעבר' הודעה.

מדידת זמן האחזור

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

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

  • שימוש באפליקציה כדי להפעיל אירועי אודיו של VoIP/מדיה/משחק במהלך בדיקה עצמית פשוט יותר להגדרת הבדיקה וגם מפחית את זמן האחזור של האירוע ב-Seeker.
    • כאן אפשר להוריד את הגרסה העדכנית ביותר.
    • כדי לבדוק את ה-LE Audio VoIP צריך להפעיל מדיניות באופן ידני: > שורש adb > הגדרות מעטפת של adb; הצבת הגדרות גלובליות מוסתרות_api_policy 1 > הפעלה מחדש של adb
  • התקנת אפליקציה:
    • מעתיקים את ה-APK לטלפון הבדיקה ופותחים אותה.
    • לחלופין, אפשר להשתמש ב-adb install audio_test_app.apk.
  • אם מופיעה תיבת דו-שיח עם בקשה לגישה להתראות:
    1. לוחצים על 'אישור'.
    2. בוחרים באפשרות 'בדיקת 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 שניות.

BLE עם LE Audio

  • VoIP

    • בחירה במצב הזה תשנה את מצב האודיו ל-AudioManager.MODE_IN_COMMUNICATION ותפעיל את האודיו באמצעות USAGE_VOICE_COMMUNICATION.
    • סוג מקור הנתונים הוא 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 שניות.

  • הלחצנים 'הפעלה' ו'עצירה'

    • הלחצנים 'הפעלה' ו'עצירה' מפעילים או מפסיקים את האודיו.

  • תוצאת המעבר

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

זמן אחזור של ריקון

  • הפקודה הבאה מאפשרת למשתמש לתעד מדידות של זמן האחזור הרצת בדיקות ידניות: 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.

חומר עזר של תבניות יומנים:

דוגמאות ליומנים מבדיקת זמן האחזור

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

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

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