שאלות נפוצות על התאמה מהירה

במאמר הזה מפורטות תשובות לשאלות נפוצות בנושא Fast Pair.

כלים ושילובים

בקטע הזה מוסבר על המפרט של התאמה מהירה, על הכלים ועל בדיקות השילוב.

מפרט ההתאמה המהירה

אפליקציית אימות

התנהגות המכשיר

Device Console

הסמכה

בקטע הזה מפורטות תשובות לשאלות נפוצות לגבי תהליך ההסמכה.

הכנה

בדיקה עצמית

הסמכת מכשירים

אחרי קבלת האישור

שאלות כלליות

אילו תכונות נדרשות להטמעה עבור סוג מכשיר מסוים וגרסה מסוימת של התאמה מהירה?

בדפים של התכונות הנדרשות מוגדרות התכונות שנדרשות לסוג מסוים של מכשיר ולגרסה מסוימת של התאמה מהירה. שותפים יכולים לבקש פטורים, שנבדקים בהתאם לכל מקרה לגופו.

האם כדאי להטמיע את גרסת הקושחה באמצעות מאפיין גרסת הקושחה של GATT או באמצעות זרם ההודעות?

התאמה מהירה מקבלת דיווח על גרסת הקושחה באמצעות מאפיין Firmware Revision של GATT בתקן Bluetooth SIG או באמצעות Message Stream: Firmware version של התאמה מהירה. עם זאת, מומלץ מאוד להטמיע את מאפיין Firmware Revision של GATT (או את שניהם). בעזרת GATT, המכשיר המחפש יכול לקרוא את גרסת הקושחה בשלב הכי מוקדם, מיד אחרי ההתאמה דרך חיבור GATT קיים. הסתמכות רק על Message Stream גורמת לעיכוב באחזור של גרסת הקושחה עד שפרופילי ה-Bluetooth והחיבור של Message Stream מוגדרים באופן מלא.

האם התכונה 'התאמה מהירה' משולבת בתכונה ספציפית (LE Audio וכו')?

‫Google משלבת כל הזמן תכונות ויכולות חדשות ב-Fast Pair. כדי לקבל פרטים על בקשות ספציפיות, אפשר לפנות לשותף SI או לאיש הקשר ב-Google.

איך אפשר לדעת אם הפרויקט שלי (לא מזהה המודל) פעיל?

סטטוס הפרויקט מסומן בסמל בדף הפרויקט במסוף המכשירים.

פרויקט לא פעיל יסומן בסמל הזה: alt_text

פרויקט פעיל יסומן בסמל הזה: alt_text

איך אפשר לדעת אם מזהה הדגם של המכשיר פעיל?

אם עדיין לא עשיתם זאת, ודאו שהמכשיר רשום בפרויקט Google Cloud כמו שמתואר בדף מזהה הדגם.

מזהי המודלים מופעלים באופן מלא אחרי הסמכה, ובדף המכשיר שלהם במסוף המכשירים יופיע הלחצן הזה:

במכשירים ללא מזהי דגם, הלחצן הזה יופיע בדף המכשיר במסוף המכשירים:

למכשיר מוקצה מזהה מודל אחרי ששולחים את הטיוטה שלו באמצעות לחצן האישור. אפשר להשתמש במזהה הדגם הזה לשילוב ולבדיקה אחרי שמכשיר מקבל מ-Google את הסטטוס 'בהמתנה', אבל צריך להפעיל אותו באופן מלא באמצעות תהליך האישור כדי שהוא יפעל עם מוצרים סופיים.

אפשר למצוא את מזהה הדגם של מכשיר בדף המכשיר במסוף המכשירים:

איך משתמשים באפליקציית התיקוף במכשיר?

שותפים צריכים ליצור חשבון Google ולבקש מהאדמין של Device Console להוסיף את החשבון שלהם לפרויקט ב-Device Console כדי שיוכלו להעלות תוצאות בדיקה ל-Device Console.

במדריך למשתמש של Validator App מוסבר על תרחישים ספציפיים לשימוש.

איך פותרים בעיות שקשורות לכשלים בפענוח הודעות?

השגיאות האלה נגרמות בדרך כלל מבעיות בבלוק ההצפנה של החומרה. כדאי לנסות להגדיר את המכשיר כדי לראות את הקלט, הפלט והקריאות ל-API של המנוע. כדי לפתור בעיות, אפשר להיעזר בתרחישי הבדיקה הקריפטוגרפיים הקיימים.

מה המשמעות של קוד השגיאה DF-DFERH-01 כשמנסים להוריד את האפליקציה הנלווית?

בדרך כלל, הסיבה לכך היא רווח לבן לפני שם החבילה.

מוודאים שאין רווחים מובילים בשם החבילה בDevice Console.

איך אפשר לראות במכשיר חצי גיליונות והתראות לפני שהמכשיר מאושר?

מודעות (והתראות) במכשירים לא מאושרים מוצגות רק אם ההתראות על ניפוי באגים מופעלות במכשיר.

כדי להפעיל התראות על ניפוי באגים:

  1. הגדרות > אפליקציות והתראות > שירותי Google Play > התראות
  2. הגדרות > Google > מכשירים ושיתוף (או חיבורי מכשירים) > מכשירים > סמל האפשרויות הנוספות (3 נקודות) > הכללת תוצאות ניפוי הבאגים

למה ההתראה על ההתאמה הבאה לא מוצגת במכשיר השני?

יכול להיות שיעברו כמה שעות עד שהמידע הזה יסונכרן עם המכשיר.

כדי לאלץ סנכרון ידני:

  1. עוברים אל הגדרות > Google > מכשירים ושיתוף > מכשירים.
  2. בוחרים את המכשיר בקטע 'מכשירים שמורים'.
  3. בוחרים את חשבון Google המתאים.

האוזניות המשויכות אמורות להופיע עכשיו ברשימה.

למה המכשיר שלי הפסיק להציג התראות על חצי דף?

ההתראות בגודל חצי דף מושבתות למשך 5 דקות אחרי שסוגרים אותן בלחיצה על לחצן הסגירה. כדי לאלץ את הופעתם מחדש של חצאי הדפים, אפשר:

  • ממתינים חמש (5) דקות עד שהאפשרות של חצי דף תופעל מחדש.
  • מפעילים מחדש את הטלפון.

מה המשמעות של short time banned?

המצב short time banned, שמוצג ביומן של דוח הבאגים, מתרחש כשסוגרים את אותו חצי גיליון של הודעה בלחיצה על לחצן הסגירה. כתוצאה מכך, מקרים עתידיים של חצי הגיליון הזה לא יוצגו במשך 5 הדקות הבאות.

כדי לאלץ את הופעתם מחדש של חצאי הדפים, אפשר:

  • ממתינים חמש (5) דקות עד שהאפשרות של חצי דף תופעל מחדש.
  • מפעילים מחדש את הטלפון.

איפה אפשר למצוא את מזהה המודל ואת מפתחות ההגנה מפני זיוף?

המפתחות גלויים רק לפרויקטים שרשומים בקונסולת המכשירים.

האם אפשר להשתמש בכתובת ציבורית של מכשיר לפרסום במצב התאמה במקום ב-RPA?

באופן כללי, לא.

‫Google לא בודקת את תרחיש השימוש הזה, והוא עלול להוביל להתנהגות לא רצויה.

שותף שרוצה לעשות זאת צריך לפחות:

  1. כדי לוודא שההטמעה בוצעה בצורה נכונה, צריך לבצע בדיקה עצמית מלאה של כל התכונות.
  2. שליחת בקשה ל-Google לקבלת פטור.

יכול להיות שנאשר בקשות לוויתור על עמלות על בסיס כל מקרה לגופו.

למה דף ההתאמה המהירה לא מופיע במכשיר שלי כשהאפליקציה הנלווית שלו כבר פתוחה בחזית?

הגיליון החלקי של ההתאמה המהירה לא מוצג כשהמערכת מזהה שאפליקציית הניהול (שמזוהה לפי שם החבילה שלה ב-Nearby Console, בקטע Companion App Package Name (שם החבילה של אפליקציית הניהול) עבור המכשיר הספציפי הזה) כבר פועלת בחזית. האמצעי הזה מונע התראות מיותרות.

לדוגמה, אם משתמש יפעיל את האפליקציה הנלווית לאוזניות שלו בחזית במכשיר הנייד, לא יוצג לו חצי הגיליון של 'צימוד מהיר'.

למה אי אפשר ליצור פרויקט במסוף המכשיר?

כדי ליצור פרויקט, צריך חשבון Google. אפשר לשייך כתובת אימייל שלא שייכת ל-Google לחשבון Google.

הבעיה הזו מתבטאת גם בהודעת השגיאה "Request had insufficient authentication scopes" (לבקשה לא היו מספיק היקפי הרשאות לאימות).

האם נדרש לרשום שם חברה ב-Bluetooth SIG?

כן, כל מכשיר חדש שנוצר במרכז השליטה למכשירים חייב להיות רשום עם שם חברה ב-Bluetooth SIG.

איך מעלים נתונים באופן ידני אל מסוף המכשירים?

שותפים צריכים ליצור חשבון Google ולהוסיף אותו לקבוצת הבדיקה של Fast Pair לפני שהם יכולים להעלות באופן ידני תוצאות בדיקה אל מסוף המכשירים.

שותפים שמשתמשים באפליקציית האימות צריכים לפעול לפי ההוראות שבקטע הגדרת אפליקציית האימות.

alt_text

כמה זמן לוקח עד שהשינויים ב-Device Console מסתנכרנים עם מכשיר מסוים?

25 שעות.

איך אפשר לסנכרן בכוח שינויים במסוף ניהול המכשירים עם מכשיר?

כל מכשיר מרענן את המטמון המקומי שלו פעם ביום. כדי לכפות רענון של המטמון, אפשר:

  1. שינוי שפת המערכת:
    • עוברים אל הגדרות > מערכת > שפה וקלט > שפות.
      • בגרסאות קודמות של Android, יכול להיות שהנתיב יהיה הגדרות > מערכת > שפה > שפות מערכת.
    • עוברים לשפה אחרת במערכת.
  2. מגדירים את שעון המערכת 25 שעות קדימה.

הרבה הגדרות של Device Console, כמו TxPower, קיימות במטמון של המכשיר.

איך מעלים נתונים של בדיקה עצמית ל-Device Console?

שותפים חייבים לפעול לפי הנתיבים של אפליקציית האימות והבדיקה הידנית כדי להעלות נתוני בדיקה עצמית אל Device Console. יכול להיות שנאחד את הנתיבים האלה בעתיד.

האפליקציה Validator מאפשרת לשלוח תוצאות של בדיקות כיול ושל בדיקות מקצה לקצה (E2E), ואילו Manual Test מאפשרת לבצע בדיקות של התאמה, מרחק ותכונות של תוספים. בשני המסלולים אפשר להעלות תוצאות ראשוניות של שיוך.

כדי להעלות נתונים של אפליקציית האימות:

  1. חשוב לוודא שפעלתם לפי כל השלבים שמפורטים בתשובה בנושא הגדרת אפליקציית כלי התיקוף.
  2. חשוב להשאיר את המכשיר מחובר לאינטרנט למשך כל הבדיקות.
  3. אחרי שתסיימו את הבדיקה, לחצו על לחצן השליחה.

כדי להעלות נתונים של בדיקה ידנית:

  1. ממלאים את כל השדות של הבדיקה הידנית שמופיעים בטופס הדוח של הבדיקה העצמית של BT Classic או של BT LE Audio.
    1. חלק מהתוספים, כמו שינוי מקור אודיו, כוללים דוחות נוספים של בדיקה עצמית (BT Classic או BT LE Audio).
  2. שולחים את כל דוחות הבדיקה העצמית לשותף ה-SI או למנהל החשבון.
  3. משאירים את המכשיר מחובר לאינטרנט למשך:
    1. משך כל הבדיקות.
    2. 25 שעות אחרי סיום הבדיקה.
      1. מוודאים שהטלפון מחובר למקור מתח כדי שלא יאבד את החשמל במהלך תהליך ההעלאה.

אילו פעולות צריך לבצע לפני ששולחים דוגמאות לאישור?

  1. חשוב לוודא שפעלתם לפי כל השלבים שמפורטים בתשובות להגדרות של כלי התיקוף ושל בדיקה ידנית.
  2. פועלים לפי ההוראות שמפורטות בדף Certification Process Preparing for Certification (תהליך ההסמכה הכנה להסמכה).

איך בודקים את התכונה 'כתיבה רטרואקטיבית של מפתח החשבון' באוזניות עם LE Audio?

בהתחשב בכך שחבילת פרוטוקולי ה-Bluetooth מטפלת בחיבורים לפרופילים. הבדיקה צריכה להתמקד באימות של התאמה רטרואקטיבית מוצלחת, ללא קשר להגדרת המתג של LE Audio בטלפון.

אם המתג של LE Audio מושבת אחרי ההתאמה, צריך לרשום את התוצאה בעמודה 'מושבת' ולסמן את העמודה 'מופעל' כ'לא רלוונטי'. הפעולה ההפוכה נכונה גם כן.

איך שולחים את הקושחה לאישור הסמכה?

המטרה העיקרית של מנגנון ניהול הקושחה היא לקשר בין תכונות של התאמה מהירה לבין גרסאות קושחה ספציפיות ומאומתות של ספקים. כדי לוודא תאימות, השותפים צריכים לשלוח את גרסת הקושחה של המכשיר המועמד להסמכה אל Device Console באמצעות האפליקציה Fast Pair Validator, ולעבור את כל מקרי הבדיקה הנדרשים. פרטים נוספים זמינים בנספח של הנחיות האישור של התכונה לניהול קושחה.

כמה דוגמאות צריך לשלוח כדי לקבל אישור?

צריך לשלוח שלוש (3) דוגמאות למעבדת האישורים של הצד השלישי. במאמר שליחת מכשירים למעבדות של צד שלישי מופיעים פרטי הקשר של מעבדה ספציפית.

יכול להיות ש-Google תבקש משותפים של התאמה מהירה לשלוח דוגמאות ל-Google לפי הצורך. מידע על משלוח של Google מופיע בדף משלוח מכשירים ל-Google.

איך מנהלים משלוח בינלאומי של מכשירי דוגמה?

לכל מעבדה של צד שלישי יש תהליכים ייחודיים לניהול משלוחים בינלאומיים, מכסי יבוא ותהליכים. צריך לתאם את התהליך הזה עם המעבדה.

הפרטים ליצירת קשר עם מעבדה ספציפית מופיעים בדף שליחת מכשירים למעבדות של צד שלישי. הדבר נכון גם לגבי מכשירים שנשלחים אל Google.

  1. נרשמים לחשבון שותף.
  2. אפשר לעיין בתהליך בדף תהליך השיווק של מוצרים.
  3. מומלץ לעיין בדף הנחיות לשימוש בלוגו של התאמה מהירה.
  4. יוצרים את האריזה ואת חומרי השיווק.
  5. שולחים את העיצובים לבדיקה שיווקית בכרטיסייה 'אישור נכסים'.

האם שותפים נדרשים לשלוח מראש נתוני מכשירים לפני הבדיקה?

לא.

לפני ששולחים את דוח הבדיקה העצמית ל-Google, צריך להזין בו את כל הפרטים הדרושים, כמו מזהה הדגם וגרסת ה-FW.

האם אפשר להשתמש באותם טלפונים ובאותן גרסאות של Android בדוח הבדיקה העצמית?

לא.

בנוסף למכשיר שלכם, אתם צריכים להשתמש בשלושה (3) טלפונים ממותגים שונים עם גרסאות Android שונות. אחד (1) מתוך שלושת (3) הטלפונים חייב להיות טלפון Pixel.

לא חובה להשתמש בדיוק בטלפונים ובמספרי הגרסה של Android שמפורטים בדוח הבדיקה העצמית.

איך מודדים ידנית את זמן ההתאמה?

זמן ההתאמה נמדד כך:

  1. ברגע שמקישים על הכפתור 'צימוד' בממשק המשתמש.
  2. ברגע שממשק המשתמש 'ההתאמה בוצעה בהצלחה' מוצג בטלפון.

איך מנהלים בדיקה עצמית למכשירים שנבדלים רק בצבע?

  1. מבצעים בדיקה עצמית מלאה בדגם אחד.
  2. מריצים את אפליקציית התיקוף על כל שאר המודלים ומוודאים שהם עוברים את הבדיקה.

אילו תכונות נדרש מהרמקולים לבדוק ולהטמיע?

הדרישות לשימוש בתכונה מפורטות במפרט.

האם בדיקות ההתאמה הבאות דורשות שהטלפון א' ישכח את המכשיר הנבדק?

לא.

בבדיקה העצמית לצימודים הבאים לא נדרש שהטלפון א' ישכח את המכשיר הנבדק ויבצע מחדש את הצימוד הראשוני. לדוגמה, כשמריצים את הבדיקה 30x Subsequent Pairing לבדיקה עצמית, רק טלפון ב' צריך לשכוח את ה-DUT.

באיזה סוג מכשיר (EVT, ‏ DVT, ‏ PVT, ‏ Released) אפשר להשתמש לבדיקה עצמית ולאישור?

המכשיר צריך להיות ברמה של בדיקת אימות עיצוב (DVT) לפחות.

באופן כללי, כל שינוי בתוכנה או בקושחה אחרי בדיקה עצמית או אישור מחייב בדיקה מחדש. פרטים נוספים זמינים בקטע בנושא סף האישור.

איך שותפים מציינים גרסאות שונות של צבעים לאותו מכשיר בתהליך האישור?

התכונה 'סדרות' במסוף המכשירים מאפשרת לשותפים לציין משפחות של מכשירים בדיוק לתרחיש הזה.

מוסכמות מתן השמות נקבעות על ידי השותף. מומלץ להוסיף סיומת לשם המוצר שמציינת את הצבע (למשל, '_green').

איך אפשר לראות את כרטיסי ההסמכה ש-Google מנפיקה?

כדי לצפות ברכיב למעקב אחר פרויקטים של Google, צריך חשבון דומיין של שותף Google (PDA). לשותף ה-SI שלכם צריך להיות PDA כדי לראות את הסימונים האלה, והוא יכול לספק עדכוני סטטוס.

אם אין לכם SI, תוכלו לפנות לשותף של Google כדי לקבל עזרה בהכנת PDA.

מה עושים עם כרטיס האישור ש-Google מנפיקה אחרי שמסיימים את הבדיקה העצמית?

השותפים צריכים לבצע את הפעולות הבאות עם הכרטיס הזה:

  1. צריך להודיע ל-Google באיזו מעבדת צד שלישי אתם מתכוונים להשתמש.
  2. צריך לספק את מספר הכרטיס ישירות למעבדה של הצד השלישי.

האם צריך לבצע את האישור באמצעות אותן גרסאות של תוכנה וקושחה ששימשו לבדיקה העצמית?

כן.

באופן כללי, כל שינוי בתוכנה או בקושחה אחרי בדיקה עצמית או אישור מחייב בדיקה מחדש. פרטים נוספים זמינים בקטע בנושא סף האישור.

איך מנהלים קבוצה של מוצרים דומים במסוף המכשירים?

אפשר להוסיף כל קבוצת מוצרים שמשתפים את אותה תמונת מוצר, שם, תוכנה וגרסת קושחה כ 'סדרה' במרכז השליטה למכשירים.

לכל מכשיר צריך להיות רשומה.

רק מכשיר אחד מהקבוצה הזו צריך להיות מאושר, וכל שאר המכשירים בסדרה מקבלים אישור כשהאישור הושלם. כשמעדכנים את התוכנה או את הקושחה של המכשיר, צריך לשלוח ל-Google רק דוח אחד של בדיקה עצמית.

איך משתפים עם מעבדות של צד שלישי שלבים מותאמים אישית לבדיקה?

באופן כללי, שותפים לא צריכים להטמיע שלבים מותאמים אישית לבדיקה לצורך קבלת אישור לתכונה 'התאמה מהירה'. הסתמכות על שלבים מותאמים אישית עלולה להוביל להפרה של תקן ההתאמה המהירה ולפגוע בביצועים של המכשיר.

במהלך שלב הצעת הפרויקט, צריך לדון עם Google בכל השלבים המותאמים אישית או בדרישות המיוחדות.

למה מצב שינוי מקור האודיו של הספק לא מראה CONNECTED_A2DP_ONLY כשמפעילים משחק?

זו בעיה מוכרת שנגרמת בגלל Seeker, שקשורה למעבר שגוי בין אודיו של משחקים. בטלפונים של סמסונג, מצב החיבור מוגדר ל-CONNECTED_A2DP_WITH_AVRCP במקום ל-CONNECTED_A2DP_ONLY בזמן משחק.

מידע נוסף מפורט בקטע בעיות מוכרות באישור של Audio Switch.

מתי נדרש לבצע מחדש אישור של מכשיר או תוכנה?

כל שינוי בתוכנה או בקושחה מחייב שליחה של דוח בדיקה עצמית, גם אם לא משנים את הקוד של Fast Pair.

באופן כללי, צריך לבצע אישור מחדש מלא במקרים הבאים:

  • השקנו קובץ בינארי עם תכונות חדשות של התאמה מהירה.
    • תכונות חדשות צריכות לקבל אישור ממעבדות צד שלישי, ותכונות קיימות אפשר לאמת באמצעות דוח בדיקה עצמית.
  • השקה של קובץ בינארי עם הסרת התכונות של התאמה מהירה.
  • שינוי הגרסה של התכונה 'התאמה מהירה' שהוטמעה (לדוגמה, 3.0 -> 3.1).
    • יכול להיות ששינויים מסוימים בגרסה ידרשו אישור נוסף.
      • לדוגמה, כדי לעבור מגרסה 3.1 לגרסה 3.2 צריך אישור של שינוי מקור אודיו.
  • פרסום קובץ בינארי בחומרה חדשה, במיוחד עם אנטנות חדשות.

השותף שלכם או איש הקשר שלכם ב-Google יכולים לספק את ההנחיות הטובות ביותר למקרים ספציפיים, כולל בקשות לפטור או לויתור.

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

עדכוני תוכנה וקושחה אחרי האישור דורשים:

  1. מתבצעת בדיקה עצמית.
  2. שליחת תוצאות הבדיקה העצמית אל Google.
  3. הצלחה בבדיקת השילוב מקצה לקצה באפליקציית האימות.

הטמעה של תוספים חדשים של התאמה מהירה או שינוי של גרסת ההתאמה המהירה מחייבים אישור נוסף, כמו שמתואר בקטע סף האישור.

לאן שולחים את דוח הבדיקה העצמית לעדכוני קושחה?

כדי לקבל פרטים על התהליך, פנו לשותף ה-SI שלכם.

אם אין לכם שותף SI, אתם יכולים לשלוח דוחות של בדיקות עצמיות לצוות הבדיקה של דוחות הבדיקות העצמיות.

האם צריך ליצור מזהי דגם שונים למכשירים עם הבדלים קלים (כמו צבע)?

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

איך מוסיפים את המכשיר שלי לדף ערכות השבבים הנתמכות?

הדף ערכות השבבים הנתמכות מתעדכן אחרי שערכת שבבים עוברת אישור. ערכות שבבים חדשות מתווספות לרשימה אם מתקיים אחד מהתנאים הבאים:

  1. לוח פיתוח עובר אישור.
  2. מוצר שמשתמש בערכת השבבים עובר אישור.