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

הכנה להסמכה

  1. הכנת מכשירי הבדיקה.
    • צריך להיות לך 5 מכשירי Android.
      • המכשירים צריכים לכלול:
        • גרסה אחת לפחות של Android T (13) וגרסה אחת של Android S (12).
        • לפחות Samsung אחד ו-Pixel אחד.
        • לדוגמה:
          • 1 OnePlus (Android 10).
          • 3 Samsung (Android 11, 12, 13).
          • פיקסל אחד (Android 13).
    • מכשיר אחד ללא שינוי מקור אודיו:
      • כל מחשב נייד עם תמיכה ב-iPhone, מחשב, Bluetooth (BT) או טלפון Android שמתג האודיו שלו מושבת.
        • ניתן לכבות את שינוי מקור האודיו מהגדרת הפרטים של מכשיר ה-Bluetooth.
      • לתרחיש הבדיקה 2.8 (MP) Multipoint (MP) נדרש מכשיר ללא מתג אודיו בנוסף ל-5 הטלפונים לבדיקה.
  2. כדי להציג התראות על ניפוי באגים בטלפונים לבדיקה, הצטרפו אל קבוצת הבדיקה של שינוי מקור האודיו עם חשבונות הבדיקה.
    • הקישור הזה גם מאפשר ל-Google לאסוף נתוני בדיקות דרך Google Analytics.
  3. ודאו שבכל מכשירי Android מותקנת גרסה 23.xx.xx ואילך של GmsCore.

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

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

מדריך לבדיקה

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

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

היקף

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

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

  • מריצים את כל מקרי הבדיקה לפחות פעמיים.
  • יש לבצע את הבדיקות בצורה הבאה:
  1. מכשיר A=Android S (12) + מכשיר B=Android T (13)
  2. מכשיר A=Android T (13) + מכשיר B=Android S (12)
  3. מכשיר B יהיה ה-DUT הראשי.
    • מזינים את הפרטים של מכשיר B בשדות Phone ו-OS בחלק העליון של התבנית.

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

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

    • מכשיר 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

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

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

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

  • 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. ההודעה האחרונה על המצב: איור 1: מוצגת ההודעה 'הודעת המצב האחרונה'.

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

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

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

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

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

  • השימוש באפליקציה להפעלת אירועי אודיו של VoIP/Media/Game במהלך בדיקה עצמית יפשט את הגדרת הבדיקה ויקצר את זמן האחזור של האירועים.
    • כאן אפשר להוריד את גרסה 1.03.
  • התקנת האפליקציה:
    • מעתיקים את ה-APK לטלפון הבדיקה ופותחים אותו.
    • לחלופין, אפשר להשתמש ב-adb install audio_test_app.apk.
  • אם מופיעה תיבת דו-שיח שמבקשת גישה להתראות:
    1. לוחצים על "אישור"
    2. בוחרים באפשרות 'בדיקת FP SASS' ברשימת האפליקציות.
    3. אישור הגישה להתראות.

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

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

ספק היעד
כשלוחצים על הלחצן הזה, תוצג רשימה של מכשירי Bluetooth מותאמים. בוחרים את התוסף שרוצים לבדוק.
הלחצנים 'חיבור' ו'ניתוק' פועלים כמו הלחצן שמופיע בפרטי המכשיר בהגדרות ה-Bluetooth.
המצב הנוכחי
בשדה הזה מוצג מצב החיבור האחרון שהמחפש קיבל מספק באמצעות פרסום באמצעות BLE או זרם אירועים.
גם ההתראות על תוצאות ניפוי הבאגים בשינוי מקור האודיו מוצגות כאן.
סוג המחפש
האפשרות הזו משמשת להעברת המכשיר בין שידורי אודיו.
סוג אודיו
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 שניות.
הלחצנים 'הפעלה' ו'עצירה'
הלחצנים 'הפעלה' ו'עצירה' מפעילים או מפסיקים את האודיו.
החלפת התוצאה

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

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

זמן אחזור לקובצי Dump

  • הפקודה הבאה מאפשרת למשתמש לתעד מדידות של זמן האחזור כשמבצעים בדיקות ידניות: adb shell dumpsys activity service com.google.android.gms/.nearby.discovery.service.DiscoveryService
    • מדידות זמן האחזור מוצגות בקטע SwitchHistory של NearbyDeviceManager:
            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) יוקלט עם זמן אחזור של 0 אלפיות שנייה.

חומר עזר של דפוסי יומן:

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

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

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

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