دليل المستخدم لتطبيق LE Audio Validator

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

ضبط إعدادات الجهاز

لتفعيل الاختبار في تطبيق Validator:

  • تأكَّد من أنّ الجهاز يعمل بالإصدار 23.37.xx أو إصدار أحدث من GmsCore.
  • تأكَّد من أنّ عناوين البريد الإلكتروني المخصّصة للاختبار هي جزء من مجموعة اختبار الشركاء في ميزة "الإقران السريع".
    • قد يستغرق الأمر من 6 إلى 24 ساعة لكي تتم مزامنة الأذونات على عناوين البريد الإلكتروني والهواتف المسجَّلة حديثًا.
    • قد يؤدي تسجيل الدخول إلى حساب Google المرتبط وتسجيل الخروج منه أيضًا إلى بدء مزامنة فورية.

يمكن العثور على إصدار "خدمات Google Play" في صفحة "معلومات التطبيق".

الأجهزة المطلوبة

يتطلب الاختبار استخدام هاتفَين على الأقل:

  • جهاز يعمل بالإصدار 15 من Android (U) متوافق مع تقنية LE Audio (مثل هاتف Pixel 7)
  • جهاز يعمل بالإصدار 6-13 من Android (M-T) ولا يتوافق مع تقنية LE Audio
    • يجب أن تستخدم الأجهزة المخصّصة للبيانات هاتفًا واحدًا فقط من هذه الهواتف.

الاتصال بملف LE Audio الشخصي على Android 15 (V)

لا تكون تقنية LE Audio مفعَّلة تلقائيًا على نظام التشغيل Android 15 (V). لتفعيل هذه الميزة:

  • انتقِل إلى صفحة "خيارات المطوّرين" على الهاتف.
    • لتفعيل "خيارات المطوّرين"، اتّبِع الخطوات التالية:
    • انتقِل إلى الإعدادات > النظام > لمحة عن الهاتف > رقم الإصدار.
    • انقر على "رقم الإصدار" 7 مرّات.
  • أوقِف خيار "إيقاف ميزة Bluetooth LE Audio".
  • فعِّل الخيار "استبعاد القائمة المسموح بها لتطبيق Bluetooth LE Audio".
  • أعِد تشغيل الهاتف.

يعرض هذا الخيار مفاتيح LEA ضمن صفحة "خيارات المطوّرين".

تفعيل اختبارات BLE للأجهزة المخصّصة للبيانات فقط

سيعرض تطبيق "أداة التحقّق" قائمة اختبار البيانات فقط إذا تم اختيار "الاتصال بالبيانات فقط" في معرّف طراز الجهاز في "وحدة تحكّم الجهاز" (ملاحظة: لا يتوفّر هذا الخيار في بعض أنواع الأجهزة). تظهر قائمة الاختبار لهذا الوضع على النحو التالي:

يعدّل التطبيق تلقائيًا قائمة الاختبار لجهاز البيانات فقط بعد تفعيل التبديل.

تفعيل مواصفات BLE واختبارات BT Classic للأجهزة غير المتوافقة مع تقنية LE Audio

على المختبِرين تبديل خيار "تفعيل اختبار مواصفات LE" للاطّلاع على اختبارات BLE. على المختبِر التأكّد من أنّ الجهاز الذي يخضع للاختبار لا يتوافق مع تقنية LE Audio من أجل الاطّلاع على اختبارات BT Classic، كما هو موضّح أدناه:

لا يتم تعديل قائمة الاختبارات إلا بعد تأكيد المختبِر أنّ الجهاز غير متوافق مع تقنية LE Audio.

تفعيل مواصفات BLE واختبارات LE Audio على هاتف Pixel يعمل بنظام التشغيل Android 14 (U) أو إصدار أحدث

على المختبِرين تبديل خيار "تفعيل اختبار مواصفات LE" للاطّلاع على اختبارات BLE. بعد ذلك، على المختبِرين الموافقة على الطلبات المتبقية للاطّلاع على شاشة الاختبار. سيملؤ التطبيق تلقائيًا الاختبارات المتاحة لهذا الإعداد، بما في ذلك اختبارات LE Audio، كما هو موضّح:

يمكن للتطبيق ملء قائمة الاختبار الصحيحة لأنّ هواتف Pixel هي إعدادات معروفة.

تفعيل مواصفات BLE واختبارات LE Audio على هاتف Pixel يعمل بنظام التشغيل Android 13 (T) أو إصدار أقدم

على المختبِرين تبديل خيار "تفعيل اختبار مواصفات LE" للاطّلاع على اختبارات BLE. بعد ذلك، على المختبِرين الموافقة على الطلبات المتبقية للاطّلاع على شاشة الاختبار. سيعبئ التطبيق تلقائيًا الاختبارات المتاحة لهذا الإعداد، بما في ذلك اختبارات BT الكلاسيكية، كما هو موضّح:

يمكن للتطبيق تعبئة قائمة الاختبار الصحيحة لأنّ هواتف Pixel هي إعدادات معروفة.

تفعيل مواصفات BLE واختبارات LE Audio على هاتف غير هاتف Pixel متوافق مع تقنية LE Audio

على المختبِرين تبديل خيار "تفعيل اختبار مواصفات LE" للاطّلاع على اختبارات BLE. على المختبِرين إبلاغ تطبيق التحقّق بما إذا كان الهاتف والجهازقيد الاختبار (المُستخدِم) يتيحان الاتصال باستخدام تقنية LE Audio أم لا. لا يمكن للتطبيق معرفة هذه المعلومات لهواتف غير Pixel، لأنّ المصنّع الأصلي للجهاز هو من يتحكّم في مدى توفّر الميزات. سيؤدي اختيار إتاحة تقنية LE Audio في النافذة المنبثقة إلى تفعيل اختبارات تقنية LE Audio، على النحو التالي:

يتم عرض اختبارات LE Audio إذا أكّد المستخدم أنّ الهاتف غير التابع لشركة Pixel متوافق مع LE Audio.

تفعيل مواصفات BLE واختبارات LE Audio على هاتف غير هاتف Pixel متوافق مع A2DP وHFP

على المختبِرين تبديل خيار "تفعيل اختبار مواصفات LE" للاطّلاع على اختبارات BLE. على المختبِرين إبلاغ تطبيق التحقّق بما إذا كان الهاتف والجهازقيد الاختبار (المُستخدِم) يتيحان الاتصال باستخدام تقنية LE Audio أم لا. لا يمكن للتطبيق معرفة هذه المعلومات لهواتف غير Pixel، لأنّ المصنّع الأصلي للجهاز هو من يتحكّم في مدى توفّر الميزات. سيؤدي اختيار إتاحة A2DP + HFP في النافذة المنبثقة إلى تفعيل اختبارات BT Classic، على النحو التالي:

يتم عرض اختبارات البلوتوث الكلاسيكي إذا اختار المستخدم إتاحة A2DP + HFP للهاتف غير Pixel.

الاختبارات الإلزامية

اطّلِع على قسم الاختبارات الإلزامية لمعرفة الاختبارات التي يجب إجراؤها لإصدار معيّن من ميزة "الإقران السريع" ونوع جهاز معيّن. يُرجى العِلم أنّ الجدول يحتوي على علامات تبويب منفصلة للأجهزة المخصّصة للبيانات فقط، والهواتف التي تعمل بنظام التشغيل Android 13 أو الإصدارات الأقدم، والهواتف التي تعمل بنظام التشغيل Android 14 أو الإصدارات الأحدث.

التحقّق من رقم تعريف UUID للخدمة الصوتية المشتركة

يتحقّق هذا الاختبار من أنّ الإعلان القابل للاتصال عبر بروتوكول LE يتضمّن معرّف UUID لوحدة التحكّم في الوصول (CAS)، على النحو المطلوب في متطلبات ملفّ Bluetooth Adapter Profile (BAP 1.0.1) وملفّ Common Audio Profile.

سيظهر الاختبار الناجح على النحو التالي:

يعرض الاختبار الناجح نتائج "اجتياز" في السجلّ.

يتحقق هذا الاختبار من أنّ مقدّم الخدمة يستخدم نوع العنوان الصحيح (بيانات الخدمة Fast Pair‏ (0xFE2C)) عند الإعلان أثناء محاولات الإقران الأولي (عنوان الهوية) والإقران اللاحق (الاستجابة الآلية للطلبات).

  • يجب أن تعلن الأجهزة المتوافقة مع CTKD من Classic إلى LE عن RPA أثناء الإقران الأولي.
  • يجب أن تعلن جميع الأجهزة الأخرى المتوافقة مع بروتوكول CTKD من LE إلى Classic عن عنوان الهوية أثناء الإقران الأولي.
  • يجب أن تعلن جميع الأجهزة عن RPA أثناء الإقران اللاحق، بغض النظر عن توفّر CTKD.

سيظهر الاختبار الناجح على النحو التالي:

يعرض الاختبار الناجح نتائج "اجتياز" في السجلّ.

اختبار التغييرات في وضع مواصفات BLE

ستتغيّر بعض الاختبارات بعد تفعيل مفتاح التبديل "تفعيل اختبارات مواصفات LE". على سبيل المثال، ستتغيّر اختبارات "تعديل مستوى البطارية" إلى "تعديل مستوى البطارية عند الاتصال بملف التعريف الكلاسيكي للصوت" و "تعديل مستوى البطارية عند الاتصال بملف التعريف الكلاسيكي للصوت". ولن تظهر الاختبارات المعدَّلة إلا على إصدارات Android المعنيّة.

يجب اختبار أي اختبار يتغيّر بهذه الطريقة على هاتفَين لضمان proper functionality، هاتف بدون LE Audio وهاتف آخر مزوّد بتقنية LE Audio. بالنسبة إلى هواتف Pixel، يعني ذلك إجراء الاختبار على هاتف يعمل بالإصدار 14 (U) من نظام التشغيل Android أو إصدار أحدث وعلى هاتف يعمل بالإصدار 13 (T) من نظام التشغيل Android أو إصدار أقدم. بالنسبة إلى الهواتف غير التابعة لشركة Pixel، يعني ذلك إجراء الاختبار على هاتف مزوّد بتقنية LE Audio وهاتف مزوّد بتقنية A2D وHFP فقط.

مثال على التغيير:

يتغيّر الاختبار إلى LE Audio على Android 14 أو الإصدارات الأحدث، بينما يستخدم BLE CLassic على Android 13 أو الإصدارات الأقدم.

كيفية تحميل النتائج إلى "وحدة تحكّم الجهاز"

كيفية إرسال النتائج

سيعرض الزر "إرسال النتيجة" ملخّصًا لنتائج الاختبار، ولكنه لن يُرسِل النتائج إلى Google.

تبدأ عملية الإرسال بالضغط على الزر "إرسال النتيجة".

بعد مراجعة جميع النتائج، اضغط على الزر "إرسال" في أسفل صفحة النتائج لإرسال النتائج إلى Google.

يتم إرسال النتائج بعد الانتقال إلى أسفل صفحة النتائج والضغط على

عرض النتائج المحمَّلة في "وحدة تحكّم الجهاز"

يمكن العثور على نتائج الاختبار التي تم إرسالها في Nearby Console. (سيتمّت إزالة مقاييس المسافة ومقاييس المدّة لحالات اختبار التبديل بين الصوت). على سبيل المثال:

يتم عرض نتائج الاختبارات في جدول في Nearby Console.

تحديد المشاكل وحلّها

حاوِل إيقاف البلوتوث وتفعيله إذا تعذّر إكمال جميع الاختبارات.

يمكن تفعيل البلوتوث وإيقافه من الزر في القائمة المنسدلة.

عدم تلقّي KeyBasedPairingResponse

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

توضّح لقطات الشاشة التالية كيفية ظهور هذا الخطأ في اختبارات مختلفة.

يعرض التطبيق خطأ KeyBasedPairingResponse في اختبار الدمج من طرف إلى طرف. يعرض التطبيق خطأ KeyBasedPairingResponse في اختبارَي "الإقران التلقائي" و"الإقران التلقائي اللاحق".

نوع KeyBasedPairingResponse غير صحيح

يمكن أن يرجع ذلك إلى أنّ مقدّم الخدمة أرسل نوع الرسالة غير الصحيح. يجب أن يتلقّى جهاز التحكّم عن بُعد الذي يتوافق مع LE Audio نوع الرسالة 2، بينما تتلقّى جميع الحالات الأخرى نوع الرسالة 1.

توضّح لقطات الشاشة التالية كيفية ظهور هذا الخطأ في اختبارات مختلفة.

يعرض التطبيق خطأ KeyBasedPairingResponseType في اختبار الدمج من طرف إلى طرف. يعرض التطبيق خطأ KeyBasedPairingResponseType في اختبارَي "الإقران التلقائي" و"الإقران التلقائي اللاحق".

KeyBasedPairingExtensionResponse Wrong Address Length

قد يرجع السبب في ذلك إلى اختيار نوع غير صحيح من ميزات CSIP لجهاز LE Audio. يجب أن تتلقّى الأجهزة المتوافقة مع CSIP وLE Audio طول عنوان يبلغ 2، بينما تتلقّى جميع الحالات الأخرى طول عنوان يبلغ 1.

توضّح لقطات الشاشة التالية كيفية ظهور هذا الخطأ في اختبارات مختلفة.

يعرض التطبيق خطأ في طول عنوان KeyBasedPairingExtensionResponse في اختبار الدمج من طرف إلى طرف. يعرض التطبيق خطأ في طول عنوان KeyBasedPairingExtensionResponse في اختبارَي "الإقران التلقائي" و"الإقران التلقائي اللاحق".

خطأ في الحالة

ويحدث ذلك عادةً بسبب تعذُّر اتصال الموفِّر (الجهاز). بالنسبة إلى أجهزة CSIP ، يجب أن يكون هناك حدثان للاتصال.

توضّح لقطات الشاشة التالية كيفية ظهور هذا الخطأ في اختبارات مختلفة.

يعرض التطبيق خطأ في الحالة في اختبار الدمج من خلال واجهة برمجة التطبيقات. يعرض التطبيق خطأ في الحالة في اختبارَي "الإقران التلقائي" و"الإقران التلقائي اللاحق".

تلقّي حدث الربط من عنوان واحد فقط

يحدث ذلك عندما يتلقّى جهاز البحث عنوانًا واحدًا فقط من جهاز CSIP. يجب أن تقدّم الأجهزة المزوّدة بتقنية CSIP عنوانَين دائمًا.

توضّح لقطات الشاشة التالية كيفية ظهور هذا الخطأ في اختبارات مختلفة.

يعرض التطبيق حدث الاستقبال الوحيد للاتصال من خطأ عنوان واحد في اختبارَي "الإقران التلقائي" و"الإقران التلقائي اللاحق".

عدم تلقّي المعرّف الفريد العالمي (UUID)

لم يتلقّى "المُستخدِم الباحث" معرّفًا فريدًا عالميًا (UUID) من أي نوع.

توضّح لقطات الشاشة التالية كيفية ظهور هذا الخطأ في اختبارات مختلفة.

يعرض التطبيق خطأ في معرّف UUID في اختبار الدمج من طرف إلى طرف. يعرض التطبيق خطأ في معرّف UUID في اختبارَي "الإقران التلقائي" و"الإقران التلقائي اللاحق".

عدم استلام معرّف UUID المتوقّع

يتوقّع "المستخدِم الباحث" تلقّي نوع معيّن من معرّفات UUID لسيناريوهات مختلفة. يحدّد الجدول التالي القيمة التي يجب أن يكون عليها معرّف UUID في هذه الحالات المختلفة.

يتيح مقدّم المحتوى استخدام LE Audio عدم توفّر تقنية LE Audio لدى مقدّم الخدمة مقدّم الخدمة هو جهاز مخصّص للبيانات فقط
جهاز التحكّم عن بُعد غير متوافق مع تقنية البلوتوث المنخفض الطاقة (BLE) ‫110B أو 1108 أو 111E ‫110B أو 1108 أو 111E لا ينطبق
إتاحة تقنية البلوتوث المنخفض الطاقة (BLE) في أداة البحث ‫110B أو 1108 أو 111E ‫110B أو 1108 أو 111E 1812
يتوافق جهاز Seeker مع تقنية البلوتوث المنخفض الطاقة (BLE) وLEA 184E ‫110B أو 1108 أو 111E 1812

توضّح لقطات الشاشة التالية كيفية ظهور هذا الخطأ في اختبارات مختلفة.

يعرض التطبيق خطأ UUID غير متوقّع في اختبار الدمج من طرف إلى طرف. يعرض التطبيق خطأ UUID غير المتوقّع في اختبارَي "الإقران التلقائي" و"الإقران التلقائي اللاحق".

لا يمكن استلام المعرّف الفريد العالمي الصحيح إلا من عنوان واحد

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

توضّح لقطات الشاشة التالية كيفية ظهور هذا الخطأ في اختبارات مختلفة.

يعرض التطبيق خطأً واحدًا فقط في اختبار الدمج من طرف إلى طرف، وهو خطأ UUID. يعرض التطبيق خطأً واحدًا فقط في معرّف UUID في اختبارَي "الإقران التلقائي" و"الإقران التلقائي اللاحق".