مواد الإقران السريع والملاحظات الفنية

تصف هذه الصفحة المعلومات المفيدة التي يحتاجها الشركاء لكل من تخطيط مشروع "الإقران السريع" وتكامل النظام.

المواد والمعالجة التي يتم إجراؤها باستخدام ميزة "الإقران السريع"

يقدّم هذا القسم روابط إلى معلومات عامة عن التسويق والعمليات.

التسويق والعلامة التجارية والرسائل

انتقِل إلى Partner Marketing Hub للحصول على إرشادات حول العلامة التجارية والرسائل. على الشركاء الجدد تقديم طلب للوصول، في حين يمكن للشركاء الحاليين الوصول إلى المحتوى من خلال حسابهم على "نطاق الشريك".

مراحل مشروع مشروع "الإقران السريع"

راجِع صفحة الأدوار والمسؤوليات في شركة تكامل النظام (SI) للحصول على وصف دقيق لدورة حياة المشروع والمسؤوليات الخاصة بالشركاء الذين يدمجون ميزة "الإقران السريع" في أحد المنتجات.

عملية الحصول على شهادة الاعتماد

يجب أن تكون الأجهزة التي تستخدم ميزة "الإقران السريع" معتمَدة قبل أن يتم تسويق منتج يتضمّن هذه الميزة. يوضّح إرشادات الحصول على شهادة الاعتماد السريع كيفية الاستعداد للحصول على الشهادة وإجراء "اختبارات ذاتية" قبل الحصول على الشهادة.

تتناول الأسئلة الشائعة حول الشهادة مجموعة متنوعة من الأسئلة الشائعة، بما في ذلك وصف عام للحالات التي تتطلّب الحصول على الشهادة الكاملة (أو إعادة الحصول على الشهادة مجدّدًا).

ويجب أن تكون الأجهزة التي تنفّذ إضافات ميزة "الإقران السريع" أو تستخدمها، مثل ميزة "تبديل مصدر الصوت"، معتمَدة أيضًا. تشمل ميزة "تبديل الصوت" [إرشادات منفصلة للحصول على شهادة الاعتماد][ASGuideLink] توضِّح خطوات الاختبار الذاتي والتحضير للحصول على شهادة برنامج تابع لجهة خارجية.

يمكن للميزات الاختبارية التابعة لجهات خارجية اعتماد ميزة "الإقران السريع" و"تبديل الصوت" بشكل تسلسلي. يمكنك الاطّلاع على صفحة أجهزة شحن إلى مختبرات تابعة لجهات خارجية التي تقدّم لها البرامج خدمات شهادة.

ملاحظات فنية

يصف هذا القسم بعض ملاحظات التنفيذ الفني لمساعدة الشركاء في التطوير والدمج.

كيفية الإعلان عن البروتوكولات الأخرى إلى جانب ميزة "الإقران السريع"

قد تحتاج بعض الأجهزة إلى إتاحة ميزات إضافية إلى جانب ميزة "الإقران السريع"، مثل "مساعد Google" أو Eddystone، التي تتطلّب مساحة إعلانية إضافية. وأفضل خيار لهذه الحالات هو تدوير بيانات الإعلان. في المقابل، يجب الإعلان عن إعلانات "الإقران السريع" ضمن الفاصل الزمني للإعلانات وفقًا للوضع القابل للاكتشاف ووضع غير قابل للاكتشاف.

يتم اختبار عرض الإعلانات بالتناوب خلال مرحلة اختبار الجهات الخارجية من عملية الاعتماد. احرِص على التحقّق من أي مخططات لعرض الإعلانات بالتناوب باستخدام تطبيق أداة التحقّق من صحة الإقران باستخدام ميزة "الإقران السريع" قبل الحصول على الاعتماد لتجنُّب أي تأخير محتمل في الحصول على الشهادة وإعادة اختبارها والتكلفة.

تقليل الفاصل الزمني لاتصال BLE

لتحسين أداء اتصال GATT، من المتوقع أن يجعل موفّر الخدمة فاصل الاتصال قصيرًا قدر الإمكان. أمّا القيمة المثالية المتوقَّعة هي 7.5 ملي ثانية، وتُطبَّق على معظم المستخدمين الذين يبحثون عن مواضيع.

حالة اتصال سماعة الرأس وإعلانات تقنية BLE

وما إذا كانت سماعة الرأس التي يتم ربطها باستخدام ميزة "الإقران السريع" تُعلِن عن رقم تعريف الطراز أو بيانات الحساب على الوضع القابل للاكتشاف BR/EDR لسماعات الرأس، وليس على الحالة المتصلة أو غير المتصلة. راجع مواصفات خدمة "الإقران السريع" من الروابط أدناه:

• "عندما يكون جهاز الموفّر في وضع قابل للاكتشاف في BR/EDR (أي في وضع الإقران)، سيعلِن عن بيانات رقم تعريف طراز الإقران السريع عبر تقنية BLE". - الرابط
• "عندما لا يكون بالإمكان اكتشاف موفّر الخدمة (أي ليس في وضع الإقران)، عليه الإعلان عن بيانات الحساب التي يتم ربطها باستخدام ميزة "الإقران السريع"" - رابط

TxPower

كما هو موضّح في المواصفات، يقدّر Seeker المسافة حسب خلاصة RSSI بناءً على مستوى TxPower المحدَّد. المسافة المقدرة هي العامل الرئيسي لتحديد ما إذا كان سيتم عرض الإشعار أم لا.

عملية تحديد TxPower هي:

1. يمكنك قياس الناتج الفعلي للجهاز باستخدام هاتف Android على بُعد متر واحد، ثم إضافة 41 ديسيبل ملي واط إلى ذلك.
2. أدرِج هذه القيمة في إعلان تقنية BLE.
3. أدرِج هذه القيمة عند اختبار معلومات الهاتف في تقرير الاختبار الذاتي.

ملاحظة: إنّ قيمة TxPower المخزّنة في Device Console تسمح للشركاء بتعديل قيمة TxPower في الأجهزة التي يتم شحنها. ليس مطلوبًا إرسال قيمة TxPower إلى وحدة التحكّم في الجهاز، وأي قيمة في وحدة التحكّم في الجهاز تلغي جميع إعدادات TxPower للجهاز.

قياس TxPower وضبطها باستخدام تطبيق Authenticator

يوفر تطبيق المدقّق اختبارًا لضبط TxPower يدويًا على المستوى المناسب على DUT. يمكن للشركاء استخدام هذا الاختبار لتحديد مستوى TxPower المناسب في DUT قبل إجراء الاختبار الذاتي أو الحصول على الشهادة.

ملاحظة: لا تنسَ ضبط مستوى TxPower على DUT وفي وحدة تحكُّم الجهاز بعد الانتهاء من الاختبار.

إجراء قياس TxPower

لقياس TxPower باستخدام تطبيق Authenticator:

1. افتح تطبيق Authenticator في DUT.
2. افتح قائمة النقاط في أعلى التطبيق:

   

3. يجب وضع جهاز DUT على بُعد متر واحد من الهاتف وانقر على زر "البدء".

   

4. اختَر DUT من قائمة الأجهزة.

   

   1. يمكنك تحديث قائمة الأجهزة من خلال النقر على الزر "إلغاء" وإعادة تحديد زر "بدء".
5. اضبط الخط الأحمر (يمثل TxPower) حتى يصل بالكاد إلى أعلى المنطقة الصفراء.

   

   1. استخدم الزر "-1" لتحريك الخط الأحمر باتجاه المنطقة الصفراء.
   2. استخدِم الزر "+1" لتحريك الخط الأحمر بعيدًا عن المنطقة الصفراء.
   3. قد يؤدي تداخل الإشارة إلى عدم استقرار الخط الأحمر. حاول الانتقال إلى منطقة بها تداخل أقل في الإشارة إذا كان الخط الأحمر يعمل بشكل غير صحيح.
6. احفظ قيمة TxPower وحدِّثها في كل من DUT وDevice Console.

   

إشعارات البطارية

على النحو المحدّد في المواصفات، يمكن لموفّر الخدمة تضمين معلومات البطارية في الإعلان. يقرر الباحث ما إذا كان سيتم إظهار إشعار البطارية أو إخفاؤه وفقًا للنوع، إما 0b0011 لإظهار إشعار البطارية أو 0b0100 لإخفائه. في ما يلي بعض الإرشادات المتعلّقة بحالات تضمين معلومات البطارية في الإعلان والنوع الذي سيتم استخدامه:

1. يُرجى إدراج معلومات البطارية في الإعلان الذي يتضمّن إشعار عرض البطارية 0b0011 لمدة 8 ثوانٍ على الأقل عندما يتم فتح الحافظة وفي حال تثبيت كلتا السمّاعتَين.
2. عليك إدراج معلومات البطارية في الإعلان الذي يتضمّن إشعار إخفاء البطارية 0b0100 لمدة 5 ثوانٍ على الأقل عندما يتم إغلاق الحافظة وفي حال تثبيت السمّاعتَين.
3. للاستجابة عند عرض إشعارات البطارية أو إخفائها، يجب أن يعكس الإعلان الحالة الحقيقية في غضون ثانيتين.
4. هناك طريقتان لإخفاء إشعار البطارية:
   1. عند التوقف عن تضمين معلومات البطارية في الإعلان، يخفي الباحث الإشعار بعد فترة (يتم ضبطه على 20 ثانية في الوقت الحالي).
   2. عليك تضمين معلومات البطارية في الإعلان الذي يتضمّن إشعار إخفاء البطارية 0b0100، يخفي "الباحث" الإشعار على الفور عند ظهور الإعلان.
5. ويكون تضمين معلومات البطارية في الإعلان اختياريًا إذا كانت هناك براعة واحدة مثبَّتة عندما تكون الحافظة مفتوحة أو مغلقة.
6. ويمكن اختيار تضمين معلومات البطارية في الإعلان عند إزالة السمّاعتَين من الحافظة أو عند وضعها على الحافظة.
7. لمنع التتبّع، يجب أن يُدرج مقدّم الخدمة بيانات البطارية الأولية في الإعلان عند الحاجة فقط (وليس طوال الوقت).

يجب وصف عملية التنفيذ في نتيجة الاختبار الذاتي للشهادة.

كيفية تفعيل تسجيل الإقران باستخدام ميزة "الإقران السريع"

تأكَّد من تفعيل سجلّ Bluetooth HCI snoop على الجهاز قبل تصحيح الأخطاء.

لالتقاط رسائل ميزة "الإقران السريع" في سجلّات تصحيح الأخطاء، شغِّل:

$ 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
• للإصدار 7.x من نظام التشغيل Android: shell $ adb pull sdcard/btsnoop_hci.log

ملاحظة: تنصح Google بترك الهاتف بجانب الجهاز الذي يتضمّن بلوتوث لبضع دقائق قبل محاولة تنزيل ملف ZIP لتقرير الخطأ.