הכנה לקראת ההסמכה
- מכינים את מכשירי הבדיקה.
- נדרשים 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.
- בתרגיל הבדיקה 2.8 של Multipoint (MP) נדרש מכשיר ללא מתג אודיו, בנוסף ל-5 הטלפונים לבדיקה.
- כל מכשיר iPhone, PC, מחשב נייד עם Bluetooth (BT) או טלפון Android שבו מתג האודיו מושבת.
- נדרשים 5 מכשירי Android.
כדי להציג התראות לניפוי באגים בטלפונים לבדיקה, צריך להצטרף לקבוצת הבדיקה של מתג האודיו באמצעות חשבונות הבדיקה.
- כך Google יכולה גם לאסוף נתוני בדיקה דרך Google Analytics.
קלאסי עם A2DP+HFP
- מוודאים שבכל מכשירי Android מותקנת גרסת GmsCore
23.xx.xx
ואילך.
BLE עם LE Audio
- לפחות שניים מהטלפונים לדוגמה חייבים לתמוך ב-LE Audio.
- לדוגמה, טלפון Samsung אחד וטלפון Pixel אחד שתומכים ב-LE Audio.
- מוודאים שבכל מכשירי Android מותקנת גרסת GmsCore
24.33.xx
ואילך.
קריטריונים לקבלת אישור
- שיעור ההצלחה של החלפת היעד צריך להיות גבוה מ-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
ספקים שתומכים בחיבורי Dual LE Audio צריכים לבדוק את האפשרויות הבאות:
- טלפון א': LE Audio, טלפון ב': LE Audio
מדריך לבדיקה
הכנה של המכשיר לבדיקה (DUT)
- מוודאים שמכשיר BT לא צורף בעבר לטלפון כלשהו שמחובר לחשבון Google לבדיקה.
- אם המכשיר מותאם לחשבון Google לבדיקה, מבצעים את הפעולות הבאות כדי לבטל את ההתאמה:
- ברשימת המכשירים המותאמים:
- עוברים להגדרות ה-Bluetooth.
- בוחרים באפשרות 'הסרת המכשיר'.
- מפעילים את מצב הטיסה ולאחר מכן מכבים אותו.
- ברשימת המכשירים המותאמים:
- מוודאים שהאפשרות 'שמירה אוטומטית של מכשירים' מופעלת.
- המתג הזה מושבת כברירת מחדל.
- אפשר למצוא את האפשרות הזו בקטע 'הגדרות' > 'Google' > 'מכשירים' > 'מכשירים שמורים' (מכשיר אחד לכל מכשיר DUT).
- מעבירים את מכשיר ה-Bluetooth למצב התאמה.
- מתאימים את מכשיר ה-Bluetooth הראשוני (A).
- מתאימים מכשירי Bluetooth נוספים למכשירים אחרים (B, C, D וכו').
- אם המכשיר מותאם לחשבון Google לבדיקה, מבצעים את הפעולות הבאות כדי לבטל את ההתאמה:
היקף
- כל האוזניות מריצות בדיקות מהכרטיסיות השונות בדוח הבדיקה העצמית של 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
- מכשיר א' = Android V (15) + מכשיר ב' = Android T (13)
- מכשיר א' = Android T (13) + מכשיר ב' = Android V (15)
- מכשיר א' = Android T (13) + מכשיר ב' = Android S (12)
- מכשיר א' = Android T (15) + מכשיר ב' = Android V (15)
- מכשיר ב' יהיה מכשיר ה-DUT הראשי.
- מזינים את הפרטים של מכשיר ב'טלפון' ו'מערכת הפעלה' בחלק העליון של התבנית.
דוגמה לתרגיל בדיקה:
טלפונים לבדיקה:
- מכשיר 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]: מכשיר א'=Pixel 7 (13), מכשיר ב'=Pixel 8 (Android 15) עמודה E: טלפון=Pixel 8, מערכת הפעלה=Android 15
- [BT+BT]: מכשיר א'=Pixel 7 pro (13), מכשיר ב'=Samsung S10+ (12) עמודה E: טלפון=Samsung S10+, מערכת הפעלה=Android 12
- [LEA+LEA]: Device A=Pixel 8 (15), Device B=Pixel 8(15) column E: Phone=Pixel 8, OS=Android 15
דוגמה לבדיקה שהושלמו בתבנית הבדיקה העצמית:
אירועי אודיו:
4 סוגי אירועי האודיו שנבדקו והאפליקציות המומלצות לבדיקה הם:
- התקשרו:
- אפליקציית הטלפון המובנית.
- VoIP: כל אפליקציית VoIP תפעל, למשל:
- אפליקציית הבדיקה של שינוי מקור האודיו.
- FB Messenger.
- קו.
- WhatsApp.
- Google Meet.
- Google Meet.
- מדיה: כל נגן אודיו יתאים, למשל:
- אפליקציית הבדיקה של שינוי מקור האודיו.
- YouTube Music.
- Apple Music.
- Spotify.
- Google Podcasts)
- משחק:
- אפליקציית הבדיקה של שינוי מקור האודיו.
- התקשרו:
מידע על ניפוי באגים:
ההתראות מופעלות אחרי שמצטרפים לקבוצה fp-sass-partner-test. הנה כמה דוגמאות:
- ההתראה האחרונה על המצב:
- ללא התראה על החלפת מצב:
- התראה על זמן אחזור של מעבר:
מדידת זמן אחזור
- יש שני סוגים של זמן אחזור למעבר:
- חיבור פרופיל Bluetooth למכשיר Seeker מנותק.
- הבעיה הזו כוללת את כל בקשות התמיכה מסוג SinglePoint, וחלק מבקשות התמיכה מסוג MP שבהן מכשיר החיפוש היעד (מכשיר ב') מנותק.
- החלפת המכשיר המחובר הפעיל שמחפש.
- הנתון הזה כולל מקרים מסוימים של מודעות MP שבהם המשתמש שמחפש את המוצר או השירות (מכשיר ב') כבר מחובר.
- חיבור פרופיל Bluetooth למכשיר Seeker מנותק.
- יש שתי דרכים לאחזר את פרטי זמן האחזור:
- אפשר להפיק דוח של כל זמני האחזור באמצעות הפקודה adb.
- פרטים נוספים זמינים בקטע זמן האחזור של יצירת גרסת dump.
- הפקודה הזו יכולה לספק ולתעד את זמן האחזור אחרי סיום של לפחות מקרה בדיקה אחד.
- באמצעות אפליקציית הבדיקה של שינוי מקור האודיו.
- באפליקציה שפועלת ב-Seeker היעד יוצג זמן אחזור אחרי המעבר.
- אם לא היה מעבר, באפליקציה תוצג הסיבה 'no switch'.
- אפשר להפיק דוח של כל זמני האחזור באמצעות הפקודה adb.
אפליקציית הבדיקה של שינוי מקור האודיו:
- שימוש באפליקציה כדי להפעיל אירועי אודיו של VoIP/מדיה/משחק במהלך בדיקה עצמית פשוט יותר להגדרת הבדיקה וגם מפחית את זמן האחזור של האירועים ב-Seeker.
- כאן אפשר להוריד את הגרסה האחרונה.
- כדי להפעיל את הבדיקה של LE Audio VoIP, צריך להפעיל מדיניות באופן ידני: > adb root > adb shell settings put global hidden_api_policy 1 > adb reboot
- התקנת אפליקציה:
- מעתיקים את קובץ ה-apk לטלפון לבדיקה ופותחים אותו.
- לחלופין, אפשר להשתמש ב-
adb install audio_test_app.apk
.
- אם מוצגת תיבת דו-שיח עם בקשה לגישה להתראות:
- לוחצים על 'אישור'.
- בוחרים באפשרות 'FP SASS test' ברשימת האפליקציות.
- נותנים גישה להתראות.
סקירה כללית של האפליקציה:
ספק היעד
- כשלוחצים על הלחצן הזה, מוצגת רשימה של מכשירי 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. סוג השימוש באודיו הוא:
משחק
- בחירה במצב הזה מאפשרת להפעיל אודיו שלא תומך ב-AVRCP. סוג השימוש באודיו הוא:
USAGE_GAME
. - סטטוס החיבור של הספק אמור לעבור ל-
CONNECTED_A2DP_ONLY
תוך 5 שניות.
- בחירה במצב הזה מאפשרת להפעיל אודיו שלא תומך ב-AVRCP. סוג השימוש באודיו הוא:
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 מחובר או Notify multipoint-switch.
- מעברים שמופעל על ידי ספק מודדים את זמן האחזור מתחילת האודיו.
זמן האחזור של ה-dump
- הפקודה הבאה מאפשרת למשתמש לתעד מדידות זמן אחזור בזמן ריצה של בדיקות ידניות:
adb shell dumpsys activity service com.google.android.gms/.nearby.discovery.service.DiscoveryService
- מדידות זמן האחזור מוצגות בקטע
NearbyDeviceManager
'sSwitchHistory
:
- מדידות זמן האחזור מוצגות בקטע
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:
- מעבר שגוי של אודיו במשחק.
- טלפונים של Samsung יגדירו את מצב החיבור ל-
CONNECTED_A2DP_WITH_AVRCP
במקום ל-CONNECTED_A2DP_ONLY
כשמשחקים. - משחקים מסוימים (כמו Candy Crush) עשויים להפעיל מחדש מוזיקה ברקע ולהפעיל אירוע אודיו חדש ללא קלט מהמשתמש. יכול להיות שהטלפונים המקושרים ישנו את מקור האודיו כל הזמן בכל טלפון שבו נפתח המשחק.
- טלפונים של Samsung יגדירו את מצב החיבור ל-