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

הכנה להסמכה

  1. הכנת מכשירי בדיקה.
    • יהיה צורך ב-5 מכשירי Android.
      • המכשירים האלה חייבים לכלול:
        • לפחות מכשיר Android T (13) ו-Android S אחד (12).
        • לפחות מכשיר Samsung אחד ו-Pixel אחד.
        • לדוגמה:
          • 1 OnePlus (Android 10).
          • 3 Samsung (Android 11, 12, 13).
          • פיקסל אחד (Android 13).
    • מכשיר אחד בלי מתג אודיו:
      • כל מחשב נייד עם תמיכה ב-Bluetooth (BT) או טלפון Android , iPhone, PC איזה מתג אודיו מושבת.
        • אפשר להשבית את שינוי מקור האודיו דרך פרטי מכשיר Bluetooth הגדרה אישית.
      • לתרחיש הבדיקה של Multipoint (MP) 2.8 נדרש מכשיר ללא מתג אודיו בנוסף ל-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, מפעילים:
    • הכרטיסייה General_test עם MP מושבתת.
    • הכרטיסייה General_test עם MP מופעלת.
    • הכרטיסייה 'Multipoint_only' עם 'MP'.

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

  • מריצים את כל מקרי הבדיקה לפחות פעמיים.
  • את הבדיקות צריך לבצע בצורה הבאה:
  1. מכשיר א'=Android S (12) + מכשיר B=Android T (13)
  2. מכשיר A=Android T (13) + מכשיר B=Android S (12)
  3. מכשיר ב' יהיה ה-DUT הראשי.
    • מזינים את הפרטים של מכשיר ב' בקטע 'טלפון' ו-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. וואטסאפ.
      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 שהיעד שלהם הוא המחפש (מכשיר ב) מנותק.
    2. החלפת ה-Finder המחובר הפעיל.
      • הנתון הזה כולל כמה מקרי MP, שהיעד המחפש (מכשיר ב') כבר מחובר.
  • יש שתי דרכים לאחזר מידע על זמן האחזור:
    1. אפשר לשנות את זמן האחזור באמצעות פקודת adb.
      • פרטים נוספים זמינים בקטע זמן אחזור של קובץ dump.
      • פקודה זו יכולה לספק ולתעד את זמן האחזור לאחר שהיא תסתיים לפחות מקרה בדיקה אחד.
    2. באמצעות אפליקציית הבדיקה של החלפת האודיו.
      • זמן האחזור של האפליקציה שפועלת ב'מחפש היעד' יופיע אחרי בהחלפה.
      • אם לא היה מתג, האפליקציה תציג את ההודעה 'ללא מתג'. סיבה.

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

  • שימוש באפליקציה להפעלת אירועי אודיו של VoIP/מדיה/משחק במהלך בדיקה עצמית יגרום מפשטים את הגדרת הבדיקה ומקצרים את זמן האחזור של האירוע של המחפש.
  • התקנת אפליקציה:
    • מעתיקים את ה-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 שניות.
הלחצנים 'הפעלה' ו'עצירה'
ניתן להפעיל או להפסיק את האודיו באמצעות הלחצנים PLAY ו-STOP.
החלפת תוצאה

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

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

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

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

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

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

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

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

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