בדף הזה מפורט מידע שימושי לשותפים לצורך תכנון פרויקט Fast Pair ושילוב המערכת.
חומרים ותהליך של התאמה מהירה
בקטע הזה מופיעים קישורים למידע כללי על שיווק ותהליכים.
שיווק, מיתוג והודעות
בPartner Marketing Hub שלנו אפשר למצוא הנחיות בנושא מיתוג ומסרים. שותפים חדשים צריכים להגיש בקשה לגישה, ואילו שותפים קיימים כבר יכולים לגשת לתוכן דרך חשבון הדומיין שלהם ב-Partner Portal.
מחזור החיים של פרויקט התאמה מהירה
במאמר תפקידים ואחריות של משלבי מערכות (SI) מופיע תיאור כללי של מחזור החיים של הפרויקט ותחומי האחריות של שותפים שמשלבים את Fast Pair במוצר.
תהליך ההסמכה
מכשירים שמטמיעים את התכונה 'התאמה מהירה' צריכים לעבור אישור לפני שניתן לשווק מוצר עם התכונה הזו. הנחיות ההסמכה של Fast Pair מתארות איך להתכונן להסמכה ולבצע בדיקות עצמיות לפני ההסמכה.
בשאלות הנפוצות בנושא אישורים מופיעות תשובות למגוון שאלות נפוצות, כולל תיאור כללי של המקרים שבהם נדרש אישור מלא (או אישור מחדש).
מכשירים שמטמיעים או משתמשים בתוספים של התאמה מהירה, כמו שינוי מקור האודיו, צריכים גם הם לעבור אישור. למתג האודיו יש הנחיות אישור נפרדות שמתארות את השלבים של הבדיקה העצמית ואת ההכנה לאישור של מעבדת צד שלישי.
מעבדות של צד שלישי יכולות לאשר את התכונות 'התאמה מהירה' ו'שינוי מקור אודיו' באופן עוקב. במאמר משלוח מכשירים למעבדות של צד שלישי מפורטות המעבדות שמציעות שירותי הסמכה שונים.
הערות טכניות
בקטע הזה מפורטות כמה הערות לגבי הטמעה טכנית שיעזרו לשותפים בתהליך הפיתוח והשילוב.
איך מפרסמים פרוטוקולים אחרים לצד התאמה מהירה
יכול להיות שבמכשירים מסוימים תרצו לתמוך בתכונות נוספות מעבר להתאמה מהירה, כמו Google Assistant או Eddystone, שדורשות מקום נוסף לפרסום. האפשרות הטובה ביותר במקרים כאלה היא להחליף את נתוני המודעה. עם זאת, המודעות של Fast Pair עדיין צריכות להיות מוצגות בפרק הזמן שמוגדר לפרסום, בהתאם למצב הגילוי ולמצב שלא ניתן לגלות.
הרוטציה של המודעות נבדקת במהלך שלב הבדיקה של צד שלישי בתהליך האישור. כדי למנוע עיכובים אפשריים באישור, בדיקות חוזרות ועלויות, חשוב לאמת את כל תוכניות הרוטציה באמצעות האפליקציה לאימות התאמה מהירה לפני קבלת האישור.
קיצור מרווח החיבור ב-BLE
כדי לשפר את ביצועי החיבור של GATT, הספק צריך לקצר ככל האפשר את מרווח החיבור. הערך האופטימלי הצפוי הוא 7.5 אלפיות השנייה, והוא חל על רוב המשתמשים בחיפוש.
פרסום ב-BLE ומצב החיבור של האוזניות
האם אוזניות עם התאמה מהירה משדרות את מזהה הדגם או את נתוני החשבון תלוי במצב הגילוי של BR/EDR באוזניות, ולא במצב המחובר או המנותק. בקישורים הבאים אפשר לעיין במפרט של שירות ההתאמה המהירה:
- כשמכשיר הספק נמצא במצב גילוי BR/EDR (כלומר, במצב התאמה), הוא ישדר נתוני מזהה מודל של התאמה מהירה באמצעות BLE. - link
- When not discoverable (that is, not in pairing mode), the Provider shall advertise Fast Pair Account Data" - link
TxPower
כפי שמוגדר במפרט, המאתר מעריך את המרחק לפי RSSI על סמך רמת TxPower שצוינה. המרחק המשוער הוא הגורם העיקרי שקובע אם להציג את ההתראה או לא.
התהליך לקביעת TxPower הוא:
- מודדים את הפלט בפועל של המכשיר באמצעות טלפון Android במרחק של מטר אחד, ואז מוסיפים 41dBm.
- צריך לכלול את הערך הזה בפרסום ה-BLE.
- צריך לכלול את הערך הזה בפרטי הטלפון של הבדיקה בדוח הבדיקה העצמית.
מדידה והגדרה של TxPower באמצעות אפליקציית האימות
אפליקציית האימות מספקת בדיקה להתאמה ידנית של TxPower לרמה המתאימה ב-DUT. שותפים יכולים להשתמש בבדיקה הזו כדי לקבוע את רמת ה-TxPower המתאימה ב-DUT לפני בדיקה עצמית או אישור.
הליך מדידה של TxPower
כדי למדוד את TxPower באמצעות אפליקציית האימות:
- פותחים את אפליקציית האימות ב-DUT.
- פותחים את תפריט האפשרויות הנוספות (3 נקודות) בחלק העליון של האפליקציה:
- מניחים את ה-DUT במרחק של מטר אחד מהטלפון ומקישים על הלחצן 'התחלה'.
- בוחרים את ה-DUT מרשימת המכשירים.
- כדי לרענן את רשימת המכשירים, מקישים על הלחצן 'ביטול' ובוחרים מחדש את הלחצן 'התחלה'.
- מזיזים את הקו האדום (שמייצג את TxPower) עד שהוא כמעט נוגע בחלק העליון של האזור הצהוב.
- משתמשים בלחצן '-1' כדי להזיז את הקו האדום לכיוון האזור הצהוב.
- כדי להרחיק את הקו האדום מהאזור הצהוב, לוחצים על הלחצן '+1'.
- הפרעות באותות עלולות לגרום לחוסר יציבות של הקו האדום. אם הקו האדום מתנהג בצורה לא יציבה, כדאי לעבור לאזור עם פחות הפרעות לאות.
- שומרים את הערך של TxPower ומעדכנים אותו גם ב-DUT וגם במסוף המכשיר.
התראות לגבי הסוללה
כפי שמוגדר במפרט, הספק יכול לכלול פרטי סוללה בפרסום. התכונה 'חיפוש' מחליטה אם להציג או להסתיר את ההתראה על הסוללה בהתאם לסוג, כלומר 0b0011 כדי להציג את ההתראה על הסוללה או 0b0100 כדי להסתיר אותה. ריכזנו כאן כמה הנחיות לגבי המקרים שבהם כדאי לכלול את פרטי הסוללה בפרסום, ואיזה סוג של פרטים כדאי לכלול:
- לכלול את פרטי הסוללה במודעה עם ההודעה על הסוללה
0b0011למשך 8 שניות לפחות כשפותחים את הנרתיק ושני האוזניות מחוברות. - כוללים את פרטי הסוללה בפרסום עם הסתרת ההתראה על הסוללה
0b0100למשך 5 שניות לפחות כשהמארז סגור ושני האוזניות מחוברות אליו. - כדי שההתראות על הסוללה יוצגו או יוסתרו במהירות, המצב האמיתי צריך להשתקף בפרסום בתוך 2 שניות.
- יש 2 דרכים להסתיר את ההתראה לגבי הסוללה:
- ההודעה לא תכלול יותר מידע על הסוללה, והמכשיר המחפש יסתיר את ההתראה אחרי זמן מה (שמוגדר כרגע ל-20 שניות).
- כדי לכלול את פרטי הסוללה בשידור עם הסתרת ההתראה על הסוללה
0b0100, המכשיר המחפש מסתיר את ההתראה מיד אחרי קבלת השידור.
- אם רק אוזנייה אחת מחוברת למארז כשהוא פתוח או סגור, אפשר לכלול את פרטי הסוללה בפרסום.
- אפשר לכלול את פרטי הסוללה בפרסום כשהאוזניות מוציאות מהנרתיק או כשהן מוכנסות לנרתיק.
- כדי למנוע מעקב, הספק צריך לכלול נתוני סוללה גולמיים בפרסום רק כשצריך (לא כל הזמן).
ההטמעה צריכה להיות מתוארת בתוצאת הבדיקה העצמית לצורך קבלת האישור.
איך מפעילים את רישום ההתאמה המהירה ביומן
לפני שמבצעים ניפוי באגים, צריך לוודא שהפעלתם את יומן Snoop Log של 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