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

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

المواد والعمليات المتعلّقة بميزة "الإقران السريع"

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

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

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

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

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

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

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

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

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

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

ملاحظات فنية

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

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

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

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

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

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

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

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

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

TxPower

وفقًا لما هو محدّد في المواصفات، يقدّر جهاز البحث المسافة حسب مؤشر قوة الإشارة المستقبَلة (RSSI) استنادًا إلى مستوى طاقة الإرسال (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 وعدِّلها في كل من الجهاز قيد الاختبار وDevice Console.
    يظهر الرقم في أعلى الشاشة.

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

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