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

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

مواد "الإقران السريع" والعملية

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

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

يُرجى الانتقال إلى مركز التسويق التعاوني بين الشركاء للحصول على إرشادات حول العلامة التجارية و المراسلة. على الشركاء الجدد تقديم طلب للوصول إلى المحتوى، بينما يمكن للشركاء الحاليين الوصول إليه من خلال حساب نطاق الشريك.

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

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

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

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

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

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

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

ملاحظات فنية

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

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

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

يتم اختبار تدوير الإعلانات خلال مرحلة الاختبار من جهة خارجية في عملية الحصول على شهادة الاعتماد. يُرجى التحقّق من أي أنظمة تغيير دوري باستخدام تطبيق Fast Pair Validator قبل الحصول على شهادة الاعتماد لتجنُّب التأخيرات المحتملة في الحصول على شهادة الاعتماد وإعادة الاختبار والتكاليف.

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

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

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

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

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

TxPower

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

في ما يلي عملية تحديد TxPower:

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

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

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

إجراء قياس TxPower

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

  1. افتح تطبيق Validator على الجهاز قيد الاختبار.
  2. افتح قائمة النقاط الثلاث في أعلى التطبيق:
    اسم الاختبار هو "أداة معايرة مستوى طاقة الإرسال".
  3. ضَع الجهاز قيد الاختبار على بُعد متر واحد من الهاتف وانقر على الزر "بدء".
    تعرض صفحة الاختبار المسافة المستهدَفة المقدَّرة باللون الأصفر.
  4. اختَر الجهاز قيد الاختبار من قائمة الأجهزة.
    يتم إدراج الأجهزة حسب عنوان MAC.
    1. يمكنك إعادة تحميل قائمة الأجهزة من خلال النقر على الزر "إلغاء" ثم إعادة النقر على الزر "بدء".
  5. عدِّل الخط الأحمر (الذي يمثّل TxPower) إلى أن يلامس بالكاد أعلى المنطقة الصفراء.
    يؤدي التعديل الصحيح إلى وضع الخط الأحمر في أعلى المنطقة الصفراء.
    1. استخدِم الزر "-1" لنقل الخط الأحمر نحو المنطقة الصفراء.
    2. استخدِم الزر "+1" لنقل الخط الأحمر بعيدًا عن المنطقة الصفراء.
    3. قد يؤدي تداخل الإشارات إلى عدم استقرار الخط الأحمر. إذا كان الخط الأحمر يتصرف بشكل غير منتظم، جرِّب الانتقال إلى منطقة تتضمّن تداخلاً أقل في الإشارات.
  6. احفظ قيمة TxPower وعدِّلها في كلّ من الجهاز قيد الاختبار و"وحدة تحكّم الأجهزة".
    يظهر الرقم في أعلى الشاشة.

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

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

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

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

كيفية تفعيل تسجيل "الإقران السريع"

تأكَّد من تفعيل سجلّ التتبُّع لواجهة تحكّم مضيف البلوتوث على الجهاز قبل تصحيح الأخطاء. بالإضافة إلى ذلك، لمنع إخفاء سجلّات "الإقران السريع" الرئيسية لأسباب أمنية، انضم إلى مجموعة اختبار الشركاء في "الإقران السريع" على 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