جفت سریع مواد و نکات فنی

این صفحه اطلاعات مفیدی را که شرکا برای برنامه‌ریزی پروژه Fast Pair و یکپارچه‌سازی سیستم به آن نیاز دارند، شرح می‌دهد.

مواد و فرآیند جفت‌سازی سریع

این بخش پیوندهایی به اطلاعات عمومی بازاریابی و فرآیند ارائه می‌دهد.

بازاریابی، برندسازی و پیام‌رسانی

برای راهنمایی در مورد برندسازی و پیام‌رسانی، از مرکز بازاریابی شرکای ما دیدن کنید. شرکای جدید باید برای دسترسی درخواست دهند، در حالی که شرکای فعلی می‌توانند از طریق حساب دامنه شریک خود به محتوا دسترسی داشته باشند.

چرخه حیات پروژه جفت‌سازی سریع

برای شرح کامل چرخه حیات پروژه و مسئولیت‌های شرکایی که Fast Pair را در یک محصول ادغام می‌کنند، به صفحه نقش‌ها و مسئولیت‌های یکپارچه‌ساز سیستم (SI) مراجعه کنید.

فرآیند صدور گواهینامه

دستگاه‌هایی که از Fast Pair پشتیبانی می‌کنند، قبل از اینکه بتوانند محصولی را با این ویژگی به بازار عرضه کنند، باید گواهینامه بگیرند. دستورالعمل صدور گواهینامه Fast Pair نحوه آماده شدن برای صدور گواهینامه و انجام Self Testهای قبل از صدور گواهینامه را شرح می‌دهد.

سوالات متداول در مورد صدور گواهینامه، طیف وسیعی از سوالات رایج، از جمله شرح کلی زمان نیاز به صدور گواهینامه کامل (یا صدور گواهینامه مجدد) را پوشش می‌دهد.

دستگاه‌هایی که از افزونه‌های Fast Pair مانند Audio switch استفاده می‌کنند یا آنها را پیاده‌سازی می‌کنند، نیز باید گواهی شوند. Audio switch یک راهنمای گواهی جداگانه دارد که مراحل خودآزمایی و آماده‌سازی برای گواهی آزمایشگاه شخص ثالث را شرح می‌دهد.

آزمایشگاه‌های شخص ثالث می‌توانند اتصال سریع و سوئیچ صوتی را به ترتیب تأیید کنند. برای اطلاع از اینکه کدام آزمایشگاه‌ها کدام خدمات صدور گواهینامه را ارائه می‌دهند، به صفحه ارسال دستگاه‌ها به آزمایشگاه‌های شخص ثالث مراجعه کنید.

نکات فنی

این بخش برخی نکات فنی پیاده‌سازی را شرح می‌دهد تا به شرکا در توسعه و ادغام کمک کند.

چگونه پروتکل‌های دیگر را در کنار Fast Pair تبلیغ کنیم؟

برخی از دستگاه‌ها ممکن است بخواهند از ویژگی‌های اضافی علاوه بر Fast Pair، مانند Google Assistant یا Eddystone، که به فضای تبلیغاتی بیشتری نیاز دارند، پشتیبانی کنند. چرخش داده‌های تبلیغاتی بهترین گزینه برای این موارد است. با این حال، تبلیغات Fast Pair همچنان باید در بازه تبلیغاتی (Advertising Interval) مطابق با حالت قابل کشف (discoverable mode ) و حالت غیر قابل کشف (discoverable mode ) نمایش داده شوند.

چرخش تبلیغات در طول مرحله آزمایش شخص ثالث فرآیند صدور گواهینامه آزمایش می‌شود. حتماً قبل از صدور گواهینامه، هرگونه طرح چرخش را با برنامه Fast Pair Validator تأیید کنید تا از تأخیرهای احتمالی صدور گواهینامه، آزمایش مجدد و هزینه جلوگیری شود.

فاصله اتصال BLE را کوتاه کنید

برای بهبود عملکرد اتصال GATT در ساخت، از ارائه دهنده انتظار می‌رود که فاصله اتصال را تا حد امکان کوتاه کند. مقدار بهینه مورد انتظار 7.5 میلی‌ثانیه است که برای اکثر جستجوگران اعمال می‌شود.

وضعیت اتصال هدست و تبلیغات BLE

اینکه یک هدست Fast Pair شناسه مدل یا اطلاعات حساب را اعلام کند یا خیر، به حالت قابل کشف BR/EDR هدست بستگی دارد، نه به حالت متصل یا قطع شده. برای مشاهده مشخصات سرویس Fast Pair به لینک‌های زیر مراجعه کنید:

• «وقتی دستگاه ارائه‌دهنده در حالت BR/EDR قابل شناسایی است (یعنی در حالت جفت‌سازی)، باید داده‌های شناسه مدل جفت‌سازی سریع را از طریق BLE منتشر کند.» - لینک
• «وقتی قابل شناسایی نباشد (یعنی در حالت جفت‌سازی نباشد)، ارائه‌دهنده باید داده‌های حساب جفت‌سازی سریع را تبلیغ کند» - لینک

تی‌اکس‌پاور

همانطور که در مشخصات تعریف شده است، جستجوگر فاصله را بر اساس RSSI و بر اساس سطح TxPower داده شده تخمین می‌زند. فاصله تخمینی عامل کلیدی برای تعیین نمایش یا عدم نمایش اعلان است.

فرآیند تعیین TxPower به شرح زیر است:

1. خروجی واقعی دستگاه را با استفاده از یک تلفن اندروید در فاصله ۱ متری اندازه‌گیری کنید و سپس ۴۱ دسی‌بل به آن اضافه کنید.
2. این مقدار را در تبلیغات BLE لحاظ کنید.
3. این مقدار را به همراه اطلاعات گوشی در حال آزمایش در گزارش خودآزمایی وارد کنید.

توجه: مقدار TxPower ذخیره شده در کنسول دستگاه به شرکا اجازه می‌دهد تا مقدار TxPower را در دستگاه‌های ارسال شده به‌روزرسانی کنند. ارسال مقدار TxPower به کنسول دستگاه الزامی نیست و هر مقداری در کنسول دستگاه، تمام تنظیمات TxPower دستگاه را لغو می‌کند.

اندازه‌گیری و تنظیم TxPower با اپلیکیشن اعتبارسنج

اپلیکیشن اعتبارسنج، آزمایشی برای تنظیم دستی TxPower به سطح مناسب در DUT ارائه می‌دهد. شرکا می‌توانند از این آزمایش برای تعیین سطح مناسب TxPower در DUT خود، قبل از خودآزمایی یا صدور گواهینامه، استفاده کنند.

نکته: به یاد داشته باشید که پس از اتمام آزمایش، سطح TxPower را روی DUT و در کنسول دستگاه تنظیم کنید.

روش اندازه‌گیری TxPower

برای اندازه‌گیری TxPower با برنامه Validator:

1. برنامه اعتبارسنجی را روی DUT باز کنید.
2. منوی نقطه‌ای بالای برنامه را باز کنید:

   

3. DUT را در فاصله ۱ متری از گوشی قرار دهید و روی دکمه «شروع» ضربه بزنید.

   

4. DUT را از لیست دستگاه‌ها انتخاب کنید.

   

   1. شما می‌توانید با لمس دکمه «لغو» و انتخاب مجدد دکمه «شروع»، لیست دستگاه‌ها را به‌روزرسانی کنید.
5. خط قرمز (که نشان‌دهنده‌ی TxPower است) را تا جایی تنظیم کنید که به سختی به بالای ناحیه‌ی زرد برسد.

   

   1. از دکمه‌ی «-1» برای حرکت دادن خط قرمز به سمت ناحیه‌ی زرد استفاده کنید.
   2. برای دور کردن خط قرمز از ناحیه زرد، از دکمه «+۱» استفاده کنید.
   3. تداخل سیگنال ممکن است خط قرمز را ناپایدار کند. اگر خط قرمز رفتار نامنظمی دارد، سعی کنید به منطقه‌ای با تداخل سیگنال کمتر نقل مکان کنید.
6. مقدار TxPower را ذخیره کنید و آن را هم در DUT و هم در کنسول دستگاه به‌روزرسانی کنید.

   

اعلان‌های باتری

همانطور که در مشخصات تعریف شده است، ارائه دهنده می‌تواند اطلاعات باتری را در تبلیغات قرار دهد. جستجوگر تصمیم می‌گیرد که آیا اعلان باتری را بر اساس نوع نمایش دهد یا پنهان کند، یا 0b0011 برای نمایش اعلان باتری یا 0b0100 برای پنهان کردن آن. در اینجا چند دستورالعمل در مورد زمان قرار دادن اطلاعات باتری در تبلیغات و نوع مورد استفاده ارائه شده است:

1. اطلاعات باتری را در تبلیغات بگنجانید و هنگام باز شدن قاب و قرار گرفتن هر دو ایرباد در جایگاه خود، حداقل به مدت ۸ ثانیه اعلان باتری 0b0011 را نمایش دهید.
2. اطلاعات باتری را در تبلیغات قرار دهید و اعلان باتری 0b0100 را حداقل به مدت 5 ثانیه، زمانی که قاب بسته است و هر دو ایرباد در جایگاه خود قرار دارند، مخفی کنید.
3. برای اینکه تبلیغات در نمایش یا پنهان کردن اعلان‌های باتری واکنش‌گرا باشند، باید وضعیت واقعی را ظرف ۲ ثانیه منعکس کنند.
4. دو راه برای پنهان کردن اعلان باتری وجود دارد:
   1. اطلاعات باتری را در تبلیغات قرار ندهید، جستجوگر پس از مدتی (که فعلاً روی ۲۰ ثانیه تنظیم شده است) اعلان را پنهان می‌کند.
   2. اطلاعات باتری را در تبلیغات با اعلان مخفی کردن باتری 0b0100 قرار دهید، جستجوگر بلافاصله پس از دریافت تبلیغ، اعلان را پنهان می‌کند.
5. اگر در حالت باز یا بسته بودن قاب، فقط یک هدفون به آن متصل باشد، درج اطلاعات باتری در آگهی اختیاری است.
6. درج اطلاعات باتری در تبلیغات، هنگام خارج کردن هدفون‌ها از قاب یا اتصال آنها به قاب، اختیاری است.
7. برای جلوگیری از ردیابی، ارائه‌دهنده خدمات باید فقط در صورت نیاز (نه همیشه) داده‌های خام باتری را در تبلیغات خود قرار دهد.

پیاده‌سازی باید در نتیجه خودآزمایی برای صدور گواهینامه شرح داده شود.

نحوه فعال کردن ثبت سریع جفت‌سازی

قبل از اشکال‌زدایی، مطمئن شوید که Bluetooth HCI snoop log را روی دستگاه فعال کرده‌اید. علاوه بر این، برای جلوگیری از حذف شدن گزارش‌های کلیدی Fast Pair به دلایل امنیتی، با حساب‌های گوگل آزمایشی خود به گروه گوگل Fast Pair Partner Test ( [e-mail] ) بپیوندید.

برای ثبت پیام‌های Fast Pair در گزارش‌های اشکال‌زدایی خود، دستور زیر را اجرا کنید:

$ 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

گوگل توصیه می‌کند که دستورات قبلی را در هر مرحله از بوت اجرا کنید.

نکته: لاگ‌های VERBOSE ممکن است در نسخه‌های نهایی حذف شوند.

نحوه استخراج گزارش اشکال‌زدایی

دستور $ adb bugreport اجرا کنید تا یک فایل زیپ حاوی تمام داده‌ها ایجاد شود. تولید فایل زیپ ممکن است چند دقیقه طول بکشد.

بسته به نسخه اندروید، یکی از دستورات زیر را برای دریافت btsnoop_hic.log اجرا کنید:

• برای اندروید ۸.x و بالاتر: shell $ adb pull data/misc/bluetooth/logs logs
• برای اندروید ۷.x: shell $ adb pull sdcard/btsnoop_hci.log

توجه: گوگل توصیه می‌کند قبل از اقدام به دانلود فایل زیپ گزارش اشکال، تلفن را برای چند دقیقه کنار دستگاه بلوتوث قرار دهید.