בדף הזה מפורט מידע שימושי ששותפים צריכים גם לתכנון פרויקט של התאמה מהירה וגם לשילוב מערכות.
החומרים והתהליך של ההתאמה המהירה
בקטע הזה יש קישורים למידע כללי על שיווק ועל התהליך.
שיווק, מיתוג והעברת מסרים
ב-Partner Marketing Hub שלנו יש הנחיות לגבי מיתוג והעברת מסרים. שותפים חדשים צריכים להגיש בקשה לגישה, ושותפים קיימים יכולים כבר לגשת לתוכן דרך החשבון שלהם בדומיין של השותף.
מחזור החיים של פרויקט התאמה מהירה
בדף תפקידים ותחומי אחריות של System Integrator (SI) מופיע תיאור כללי של מחזור החיים של הפרויקט ותחומי האחריות של שותפים שמשלבים את התכונה "התאמה מהירה" במוצר.
תהליך ההסמכה
מכשירים שבהם מוטמעת התכונה "התאמה מהירה" חייבים להיות מאושרים לפני שאפשר לשווק מוצר עם התכונה הזו. בהנחיות לאישור התאמה מהירה מתואר איך להתכונן לאישור ולבצע בדיקות עצמיות לפני האישור.
בשאלות הנפוצות בנושא אישורים יש מגוון שאלות נפוצות, כולל תיאור כללי של המקרים שבהם נדרש אישור מלא (או אישור מחדש).
מכשירים שמטמיעים תוספים של "התאמה מהירה" או משתמשים בהם, כמו שינוי מקור האודיו, חייבים גם להיות מאושרים. למעבר אודיו יש הנחיות נפרדות לאישור שמתארות את שלבי הבדיקה העצמית וההכנה לאישור מעבדה של צד שלישי.
מעבדות של צד שלישי יכולות לאשר את ההתאמה המהירה ואת שינוי מקור האודיו בזו אחר זו. בדף שליחת מכשירים למעבדות של צד שלישי מפורט אילו מעבדות מציעות אילו שירותי אישור.
הערות טכניות
בקטע הזה מפורטות כמה הערות טכניות לגבי ההטמעה, כדי לעזור לשותפים בפיתוח ובשילוב.
איך לפרסם פרוטוקולים אחרים לצד התאמה מהירה
יכול להיות שבמכשירים מסוימים תרצו לתמוך בתכונות נוספות מעבר להתאמה המהירה, כמו Google Assistant או Eddystone, שדורשות שטח פרסום נוסף. במקרים כאלה, האפשרות הטובה ביותר היא להחליף את נתוני הפרסום. עם זאת, עדיין צריך לפרסם את המודעות של "התאמה מהירה" בתוך מרווח הפרסום בהתאם למצב הגלוי ולמצב הלא גלוי.
סבב המודעות נבדק במהלך שלב הבדיקה של צד שלישי בתהליך האישור. כדי למנוע עיכובים אפשריים באישור, בדיקות חוזרות ועלויות, חשוב לאמת את כל סכימות הרוטציה באמצעות אפליקציית האימות של התאמה מהירה לפני האישור.
קיצור מרווח החיבור של BLE
כדי לשפר את ביצועי החיבור של GATT, הספק צריך להגדיר את מרווח החיבור הכי קצר שאפשר. הערך האופטימלי הצפוי הוא 7.5 אלפיות השנייה, והוא חל על רוב המכשירים.
פרסום ב-BLE ומצב החיבור של האוזניות
השאלה אם אוזניות עם התאמה מהירה מפרסמות את מזהה הדגם או את נתוני החשבון תלויה במצב הגילוי של BR/EDR באוזניות, ולא במצב החיבור או הניתוק. בקישורים הבאים מפורט המפרט של שירות ההתאמה המהירה:
- "כשהמכשיר של הספק נמצא במצב גילוי BR/EDR (כלומר, במצב התאמה), הוא יפרסם את נתוני מזהה המודל של ההתאמה המהירה באמצעות BLE". - קישור
- "כשהמכשיר לא ניתן לגילוי (כלומר, לא במצב התאמה), הספק צריך לפרסם את נתוני החשבון של ההתאמה המהירה" – קישור
TxPower
כפי שמוגדר במפרט, המכשיר המאתר מעריך את המרחק לפי ה-RSSI על סמך רמת ה-TxPower הנתונה. המרחק המשוער הוא הגורם העיקרי שקובע אם להציג את ההתראה או לא.
התהליך לקביעת TxPower הוא:
- מודדים את הפלט בפועל של המכשיר באמצעות טלפון Android במרחק של מטר אחד, ואז מוסיפים לזה 41dBm.
- צריך לכלול את הערך הזה בפרסום ה-BLE.
- צריך לכלול את הערך הזה עם פרטי הטלפון לבדיקה בדוח הבדיקה העצמית.
מדידה והגדרה של TxPower באמצעות אפליקציית Validator
אפליקציית Validator מספקת בדיקה לכוונון ידני של TxPower לרמה המתאימה בטלפון לבדיקה. השותפים יכולים להשתמש בבדיקה הזו כדי לקבוע את רמת ה-TxPower המתאימה ב-DUT שלהם לפני הבדיקה העצמית או האישור.
הליך מדידת TxPower
כדי למדוד את TxPower באמצעות אפליקציית האימות:
- פותחים את אפליקציית האימות בטלפון לבדיקה.
- פותחים את תפריט הנקודות בחלק העליון של האפליקציה:
- מניחים את המכשיר הנבדק במרחק של מטר אחד מהטלפון ולוחצים על הכפתור "התחלה".
- בוחרים את ה-DUT מרשימת המכשירים.
- כדי לרענן את רשימת המכשירים, לוחצים על הכפתור "ביטול" ואז שוב על הכפתור "התחלה".
- מכווננים את הקו האדום (שמייצג את TxPower) עד שהוא כמעט נוגע בחלק העליון של האזור הצהוב.
- משתמשים בכפתור "-1" כדי להזיז את הקו האדום לכיוון האזור הצהוב.
- כדי להזיז את הקו האדום מהאזור הצהוב, לוחצים על הכפתור "+1".
- הפרעות באות עלולות לגרום לקו האדום להיות לא יציב. אם הקו האדום לא יציב, כדאי לעבור לאזור עם פחות הפרעות לאות.
- שומרים את הערך של TxPower ומעדכנים אותו גם ב-DUT וגם במסוף המכשירים.
התראות לגבי הסוללה
כפי שמוגדר במפרט, הספק יכול לכלול מידע על הסוללה בפרסום. המכשיר המבקש מחליט אם להציג או להסתיר את ההתראה על הסוללה בהתאם לסוג, 0b0011 כדי להציג את ההתראה על הסוללה או 0b0100 כדי להסתיר אותה. ריכזנו כאן כמה הנחיות לגבי המקרים שבהם צריך לכלול את פרטי הסוללה במודעה, ואיזה סוג של פרטים צריך לכלול:
- לכלול את פרטי הסוללה בפרסום עם הצגת התראה על הסוללה
0b0011למשך 8 שניות לפחות כשהנרתיק נפתח ושתי האוזניות מחוברות. - צריך לכלול את פרטי הסוללה בפרסום עם התראה על הסתרת הסוללה
0b0100למשך 5 שניות לפחות כשהנרתיק סגור ושתי האוזניות מונחות בתוכו. - כדי להציג או להסתיר התראות על הסוללה באופן רספונסיבי, המודעה צריכה לשקף את המצב האמיתי תוך 2 שניות.
- יש שתי דרכים להסתיר את ההתראה לגבי הסוללה:
- אם המכשיר מפסיק לכלול את פרטי הסוללה בפרסום, ההתראה מוסתרת במכשיר המאתר אחרי זמן מה (שמוגדר כרגע ל-20 שניות).
- אם המידע על הסוללה נכלל בפרסום עם התראה על הסתרת הסוללה
0b0100, המכשיר המחפש מסתיר את ההתראה מיד אחרי קבלת הפרסום.
- אם רק אוזנייה אחת מחוברת כשהנרתיק פתוח או סגור, אפשר לכלול את פרטי הסוללה במודעה, אבל לא חובה.
- אפשר לכלול את פרטי הסוללה בפרסום כשאוזניות ה-Buds מוצאות מהנרתיק או מונחות בו.
- כדי למנוע מעקב, הספק צריך לכלול נתוני סוללה גולמיים בפרסום רק כשצריך (לא כל הזמן).
צריך לתאר את ההטמעה בתוצאות הבדיקה העצמית לצורך קבלת האישור.
איך מפעילים את רישום ההתאמה המהירה ביומן
לפני ניפוי הבאגים, ודאו שהפעלתם במכשיר את יומן ה-snoop של Bluetooth HCI. בנוסף, כדי למנוע צנזור של יומני מפתחות של התאמה מהירה מסיבות אבטחה, הצטרפו לקבוצת Google לבדיקת שותפים של התאמה מהירה (fast-pair-partner-test@googlegroups.com) באמצעות חשבונות Google לבדיקה.
כדי לתעד הודעות של "התאמה מהירה" ביומני ניפוי הבאגים, מריצים את הפקודה:
$ adb logcat -G 16M
$ adb shell setprop log.tag.NearbyMessages VERBOSE
$ adb shell setprop log.tag.NearbyDiscovery VERBOSE
$ adb shell setprop log.tag.FastPair VERBOSE
Google ממליצה להריץ את הפקודות הקודמות בכל רצף אתחול.
איך לחלץ יומן ניפוי באגים
מריצים את הפקודה $ adb bugreport כדי ליצור קובץ ZIP שמכיל את כל הנתונים. יצירת קובץ ה-ZIP עשויה להימשך כמה דקות.
בהתאם לגרסת Android, מריצים אחת מהפקודות הבאות כדי לקבל את btsnoop_hic.log:
- ב-Android מגרסה 8.x ואילך:
shell $ adb pull data/misc/bluetooth/logs logs - ב-Android 7.x:
shell $ adb pull sdcard/btsnoop_hci.log