إرشادات اعتماد التبديل الصوتي

التحضير للحصول على الاعتماد

• تجهيز الأجهزة الاختبارية
  • ستحتاج إلى 5 أجهزة Android.
    • يجب أن تتضمّن هذه الأجهزة ما يلي:
      • إصدار Android T (13) واحد على الأقل وإصدار Android V (15) واحد على الأقل
      • هاتف Samsung واحد على الأقل وهاتف Pixel واحد على الأقل
      • على سبيل المثال:
        • ‫1 OnePlus (Android 10)
        • ‫3 أجهزة Samsung (الإصدار 11 أو 12 أو 13 من نظام التشغيل Android)
        • ‫1 Pixel (الإصدار 15 من Android)
  • جهاز واحد بدون ميزة "تبديل مصدر الصوت":
    • أي جهاز iPhone أو كمبيوتر شخصي أو كمبيوتر محمول مزوّد بتقنية Bluetooth (BT) أو هاتف Android مع إيقاف مفتاح التحكّم في الصوت
      • يمكنك إيقاف "تبديل الصوت" من إعدادات تفاصيل جهاز البلوتوث.
    • يتطلب اختبار نقطة الاتصال المتعددة (MP) 2.8 جهازًا بدون مفتاح تبديل الصوت بالإضافة إلى الهواتف الاختبارية الخمسة.

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

  • ويسمح ذلك أيضًا لشركة Google بجمع بيانات الاختبار من خلال "إحصاءات Google".

تقنية A2DP+HFP الكلاسيكية

• تأكَّد من تثبيت الإصدار 23.xx.xx أو إصدار أحدث من GmsCore على جميع أجهزة Android.

تقنية BLE مع تقنية LE Audio

• يجب أن يكون اثنان على الأقل من الهواتف المرجعية متوافقَين مع LE Audio.
  • على سبيل المثال، هاتف Samsung وهاتف Pixel متوافقان مع LE Audio.
• تأكَّد من تثبيت الإصدار 24.33.xx أو إصدار أحدث من GmsCore على جميع أجهزة Android.

معايير الاعتماد

• يجب أن يتجاوز معدّل نجاح تبديل الاستهداف% 95 في جميع حالات الاختبار.

• في الاختبارات التي تتطلّب التبديل، يجب أن تكتمل عملية ربط الملف الشخصي وحالة التبديل النشطة في غضون 3 ثوانٍ بعد بدء أحداث الصوت في ‎75% على الأقل من الحالات.

تقنية A2DP+HFP الكلاسيكية

يجب إجراء الاختبارات الذاتية بالتركيبات التالية:

• الهاتف "أ" = Android S (12) + الهاتف "ب" = Android T (13)
• الهاتف "أ" = Android T (13) + الهاتف "ب" = Android S (12)

تقنية BLE مع تقنية LE Audio

يجب إجراء الاختبارات الذاتية بالتركيبات التالية:

• الهاتف "أ": BT Classic، الهاتف "ب": BT Classic
• الهاتف "أ": LE Audio، الهاتف "ب": البلوتوث الكلاسيكي
• الهاتف "أ": تقنية البلوتوث الكلاسيكية، الهاتف "ب": تقنية LE Audio

اختياريًا، على مقدّمي الخدمات الذين يتيحون عمليات الربط المزدوج عبر تقنية LE Audio اختبار ما يلي:

• الهاتف "أ": تقنية LE Audio، الهاتف "ب": تقنية LE Audio

دليل الاختبار

تحضير الجهاز الذي يتم اختباره (DUT)

• تأكَّد من أنّه لم يتم إقران جهاز BT سابقًا بأي هاتف سجّلت الدخول منه إلى حساب Google التجريبي.
  • إذا تم إقران الجهاز بحساب Google للاختبار، عليك تنفيذ الخطوات التالية لإزالة عملية الإقران:
    • في الأجهزة المقترنة:
      • انتقِل إلى إعدادات البلوتوث.
      • اختَر "نسيان الجهاز".
      • فعِّل "وضع الطيران" ثم أوقِفه.
  • تأكَّد من تفعيل خيار "حفظ الأجهزة تلقائيًا".
    • يكون هذا الخيار غير مفعَّل تلقائيًا.
    • يمكنك العثور على هذا الخيار في الإعدادات > Google > الأجهزة > الأجهزة المحفوظة (جهاز واحد لكل جهاز DUT).
  • فعِّل وضع الإقران على جهاز البلوتوث.
  • إقران جهاز البلوتوث الأوّلي (أ).
  • إقران الأجهزة اللاحقة التي تتضمّن بلوتوث بالأجهزة الأخرى (ب و ج و د وما إلى ذلك)

النطاق

• تُجري جميع سماعات الرأس الاختبارات من علامات التبويب المختلفة في تقرير الفحص الذاتي لميزة BT Classic أو BT LE Audio.
• تعمل سماعات الرأس التي تتيح وضع SinglePoint (SP) فقط على ما يلي:
  • علامة التبويب Generic_test
• تعمل سماعات الرأس المتوافقة مع وضع MP على تنفيذ ما يلي:
  • علامة التبويب Generic_test
  • علامة التبويب Multipoint_only
• تعمل سماعات الرأس المزوّدة بتقنية MP والتي يمكن تبديلها إلى وضع SP على تنفيذ ما يلي:
  • علامة التبويب Generic_test مع إيقاف ميزة "المعالجة المتعددة"
  • علامة التبويب Generic_test مع تفعيل ميزة "المعالجة المتقدّمة"
  • علامة التبويب Multipoint_only مع تفعيل ميزة "الاتصال المتعدّد النقاط"

إكمال تقرير "الاستراحة الذاتية" و"الاختبار الذاتي"

• أنشئ نسخة من تقريرَي الفحص الذاتي لبروتوكول البلوتوث الكلاسيكي أو لصوت البلوتوث منخفض الطاقة.
• شغِّل جميع حالات الاختبار مرّتين على الأقل.

• يجب تنفيذ الاختبارات بالشكل التالي:

تقنية A2DP+HFP الكلاسيكية

• سيكون الجهاز "ب" هو جهاز DUT الرئيسي.
  • أدخِل تفاصيل الجهاز "ب" في حقلَي "الهاتف" و"نظام التشغيل" في أعلى القالب.

مثال على حالة اختبارية:

• هواتف الاختبار:

  • الجهاز 1: Samsung (الإصدار 13 من نظام التشغيل Android)
  • الجهاز 2: هواتف Pixel (الإصدار 12 أو 13 من Android) وغيرها

• الاختبارات التي تم تنفيذها:

  • إجراء 1. الجهاز "أ"‏=Samsung S10+ (12)، الجهاز "ب"‏=Pixel 7 pro (13) العمود "د": الهاتف=Pixel 7 pro، نظام التشغيل=Android 13
  • 2- إجراء عملية الربط الجهاز "أ"‏=Pixel 7 Pro (13)، الجهاز "ب"‏=Pixel 6(12) العمود "هـ": الهاتف=Pixel 6، نظام التشغيل=Android 12

مثال على اختبار مكتمل في نموذج الاختبار الذاتي:

تقنية BLE مع تقنية LE Audio

1. الجهاز "أ" = الإصدار V من Android (15) + الجهاز "ب" = الإصدار T من Android (13)
2. الجهاز "أ" = Android T (13) + الجهاز "ب" = Android V (15)
3. الجهاز "أ" = Android T (13) + الجهاز "ب" = Android S (12)
4. الجهاز "أ" = Android T (15) + الجهاز "ب" = Android V (15)
5. سيكون الجهاز "ب" هو جهاز DUT الرئيسي.
   • أدخِل تفاصيل الجهاز "ب" في حقلَي "الهاتف" و"نظام التشغيل" في أعلى القالب.

مثال على حالة اختبارية:

• هواتف الاختبار:

  • الجهاز 1: Samsung (الإصدار 13 من نظام التشغيل Android)
  • الجهاز 2: هواتف Pixel (الإصدار 15 من Android) والأجهزة الأخرى

• الاختبارات التي تم تنفيذها:

  • [LEA+BT]: الجهاز "أ" = Pixel 8 (15)، الجهاز "ب" = Pixel 7 pro (13) العمود "د": الهاتف=Pixel 7 pro، نظام التشغيل=Android 13
  • [BT+LEA]: العمود "الجهاز أ"‏=Pixel 7 (13)، العمود "الجهاز ب"‏=Pixel 8 (Android 15) هـ: الهاتف=Pixel 8، نظام التشغيل=Android 15
  • ‫[BT+BT]: الجهاز "أ"‏=Pixel 7 pro (13)، الجهاز "ب"‏=Samsung S10+ (12) عمود هـ: الهاتف=Samsung S10+، نظام التشغيل=Android 12
  • ‫[LEA+LEA]: الجهاز "أ"‏=Pixel 8 (15)، الجهاز "ب"‏=Pixel 8(15) العمود "هـ": الهاتف=Pixel 8، نظام التشغيل=Android 15

مثال على اختبار مكتمل في نموذج الاختبار الذاتي:

أحداث الصوت:

• في ما يلي الأنواع الأربعة لأحداث الصوت التي تم اختبارها وتطبيقات الاختبار المقترَحة:

  1. الاتصال:
     1. تطبيق الهاتف المضمّن
  2. بروتوكول الصوت على الإنترنت (VoIP): يمكن استخدام أي تطبيق VoIP، مثل:
     1. تطبيق اختبار ميزة "تبديل مصدر الصوت"
     2. ‫FB Messenger
     3. سطر.
     4. WhatsApp
     5. Google Meet
     6. Google Meet
  3. الوسائط: يمكن استخدام أي مشغّل صوت، مثل:
     1. تطبيق اختبار ميزة "تبديل مصدر الصوت"
     2. YouTube Music
     3. Apple Music
     4. Spotify
     5. Google بودكاست)
  4. اللعبة:
     1. تطبيق اختبار ميزة "تبديل مصدر الصوت"

ملاحظة: يُرجى الرجوع إلى قسم تطبيق اختبار تبديل الصوت للحصول على المزيد من التفاصيل.

معلومات تصحيح الأخطاء:

• يتم تفعيل الإشعارات بعد الانضمام إلى مجموعة fp-sass-partner-test. وإليك بعض الأمثلة:

  • آخر إشعار بالحالة:

  

  • في حال عدم تلقّي إشعار بالتبديل:

  

  ملاحظة: "أحدث حالة" هي حالة الاتصال عند حدوث الحدث الصوتي، وليس أحدث حدث حالي.
  • إشعار وقت استجابة التبديل:

  

قياس وقت الاستجابة

ملاحظة: يشير "جهاز البحث" إلى الهاتف أو الجهاز اللوحي الذي تستخدمه للاتصال بسماعة الرأس في الاختبار، ويُعرف أيضًا باسم الجهاز "أ" أو "ب" أو "ج" أو "د" أو "هـ" في حالات الاختبار.

• هناك نوعان من وقت استجابة التبديل:
  1. ربط ملف شخصي على البلوتوث بجهاز Seeker غير متصل
     • ويشمل ذلك جميع حالات SinglePoint وبعض حالات MP التي انقطع فيها اتصال جهاز العميل (الجهاز B) بالجهاز المستهدف.
  2. تبديل جهاز Seeker المتصل والنشط
     • ويشمل ذلك بعض حالات MP التي يكون فيها "المُستخدِم المستكشِف" المستهدَف (الجهاز "ب") متصلاً.
• هناك طريقتان لاسترداد معلومات وقت الاستجابة:
  1. يمكن تفريغ جميع أوقات الاستجابة باستخدام الأمر adb.
     • يُرجى الرجوع إلى قسم وقت استجابة تفريغ الذاكرة للاطّلاع على التفاصيل.
     • يمكن لهذا الأمر توفير وقت الاستجابة وتسجيله بعد الانتهاء من ملف اختبار واحد على الأقل.
  2. باستخدام تطبيق اختبار ميزة "تبديل مصدر الصوت":
     • سيعرض التطبيق الذي يعمل على جهاز البحث المستهدَف وقت الاستجابة بعد التبديل.
     • إذا لم يتم إجراء تبديل، سيعرض التطبيق السبب "بدون تبديل".

تطبيق اختبار ميزة "تبديل مصدر الصوت":

• سيؤدي استخدام التطبيق لتشغيل أحداث الصوت في بروتوكول الصوت على الإنترنت (VoIP)/الوسائط/الألعاب أثناء الاختبار الذاتي إلى تبسيط إعداد الاختبار وتقليل وقت استجابة حدث Seeker.
  • يمكن تنزيل أحدث إصدار من هنا.
  • يحتاج اختبار LE Audio VoIP إلى سياسة لتفعيلها يدويًا: > adb root > adb shell settings put global hidden_api_policy 1 > adb reboot

ملاحظة: ستحتاج إلى حساب على Google لطلب الوصول إلى رابط التنزيل. إنّ منح إذن الوصول عملية يدوية وقد تستغرق عدة أيام.

• تثبيت التطبيق:
  • انسخ حزمة apk إلى هاتف الاختبار وافتحها.
  • يمكنك بدلاً من ذلك استخدام adb install audio_test_app.apk.

تحذير: عليك السماح بجميع الأذونات عند فتح التطبيق للمرة الأولى.

• إذا ظهر لك مربّع حوار يطلب منك الوصول إلى الإشعارات:
  1. انقر على "حسنًا".
  2. اختَر "اختبار FP SASS" في قائمة التطبيقات.
  3. عليك السماح بالوصول إلى الإشعارات.

نظرة عامة على التطبيق:

• موفّر الاستهداف

  • سيعرض هذا الزر قائمة بأجهزة البلوتوث المقترنة عند النقر عليه. اختَر الميزة التي تريد اختبارها.
  • يعمل الزرّان "الاتصال" و"قطع الاتصال" مثل الزرّ في تفاصيل الجهاز ضمن إعدادات البلوتوث.

• الحالة الحالية

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

• نوع الباحث

  • يُستخدَم هذا الخيار لتبديل الجهاز بين مصادر الصوت.

نوع الصوت

تقنية A2DP+HFP الكلاسيكية

• VoIP
  • سيؤدي اختيار هذا الوضع إلى تغيير وضع الصوت إلى AudioManager.MODE_IN_COMMUNICATION وإلى الاتصال بالرقم AudioManager.startBluetoothSco، ثم تشغيل الصوت باستخدام USAGE_VOICE_COMMUNICATION.
  • نوع البث هو STREAM_VOICE_CALL.
  • من المفترض أن تتغيّر حالة الاتصال بالموفّر إلى CONNECTED_HFP في غضون 5 ثواني.
• الوسائط
  • سيؤدي اختيار هذا الوضع إلى تشغيل محتوى صوتي متوافق مع بروتوكول AVRCP. نوع استخدام المحتوى الصوتي هو: USAGE_MEDIA.
  • من المفترض أن تتغيّر حالة الاتصال بالموفّر إلى CONNECTED_A2DP_WITH_AVRCP في غضون 5 ثوانٍ.
  • قد تتغيّر حالة الاتصال مؤقتًا إلى CONNECTED_A2DP_ONLY عند بدء الاتصال أو إيقافه.
• اللعبة
  • يؤدي اختيار هذا الوضع إلى تشغيل الصوت الذي لا يتوافق مع بروتوكول AVRCP. نوع استخدام المحتوى الصوتي هو: USAGE_GAME.
  • من المفترض أن تتغيّر حالة الاتصال بالموفّر إلى CONNECTED_A2DP_ONLY خلال 5 ثوانٍ.

تقنية BLE مع تقنية LE Audio

• VoIP

  • سيؤدي اختيار هذا الوضع إلى تغيير وضع الصوت إلى AudioManager.MODE_IN_COMMUNICATION وتشغيل الصوت باستخدام USAGE_VOICE_COMMUNICATION.
  ملاحظة: بالنسبة إلى إصدارات Android الأقدم من Tiramisu (Android 13)، يُطلِق تطبيق الاختبار AudioManager.startBluetoothSco لبدء اتصال صوتي عبر SCO باستخدام البلوتوث. بخلاف ذلك، يتصل تطبيق الاختبار AudioManager.setCommunicationDevice لاختيار جهاز الصوت المستخدَم للتواصل.
  • نوع البث هو STREAM_VOICE_CALL.
  • من المفترض أن تتغيّر حالة الاتصال بالموفّر إلى CONNECTED_LE_AUDIO_CALL خلال 5 ثوانٍ.

• الوسائط

  • سيؤدي اختيار هذا الوضع إلى تشغيل الصوت بنوع البث STREAM_MUSIC. نوع استخدام المحتوى الصوتي هو: USAGE_MEDIA.
  • من المفترض أن تتغيّر حالة الاتصال بالموفّر إلى CONNECTED_LE_AUDIO_MEDIA_WITH_CONTROL في غضون 5 ثوانٍ.
  • قد تتحول حالة الاتصال مؤقتًا إلى CONNECTED_LE_AUDIO_MEDIA_WITHOUT_CONTROL عند بدء الاتصال أو إيقافه.

• اللعبة

  • يؤدي اختيار هذا الوضع إلى تشغيل محتوى صوتي لا يمكن للمستخدم التحكّم فيه مباشرةً. نوع استخدام المحتوى الصوتي هو: USAGE_GAME.
  • من المفترض أن تتغيّر حالة الاتصال بالموفّر إلى CONNECTED_LE_AUDIO_MEDIA_WITHOUT_CONTROL في غضون 5 ثوانٍ.

• زرّا التشغيل والإيقاف

  • يؤدي الضغط على زرَّي التشغيل والإيقاف إلى تشغيل الصوت أو إيقافه.

• تبديل النتيجة

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

وقت استجابة تفريغ البيانات

• يسمح الأمر التالي للمستخدم بتسجيل قياسات وقت الاستجابة عند إجراء اختبارات يدوية: adb shell dumpsys activity service com.google.android.gms/.nearby.discovery.service.DiscoveryService
  • يتم عرض قياسات وقت الاستجابة ضمن قسم NearbyDeviceManager's SwitchHistory:

            NearbyDeviceManager
              Nearby Sass device count: 1
                Sass device - address:XX:XX:XX:XX:XX:XX, name:Googler's Pixel Buds, accountKey:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX, modelId:6edaf7
                  SwitchHistory
                    15:30:21:166 - 15:30:25:201, latency 3035ms, Succeed, SASS_TRIGGERED_CONNECT, SASS switch, A2DP
                    15:34:58:568 - 15:34:58:568, latency 0ms, Succeed, SWITCH_ACTIVE_TO_SELF, SASS switch, HFP
                    15:36:26:615 - 15:36:31:603, latency 1988ms, Succeed, SASS_TRIGGERED_CONNECT, SASS switch, A2DP
                    15:37:56:108 - 15:37:56:250, latency 142ms, Succeed, SWITCH_ACTIVE_TO_SELF, SASS switch, A2DP"

• سيتم تسجيل أي تبديل لا يمكن لـ GmsCore قياسه (مثل التبديل النشط لبروتوكول HFP) باستخدام وقت استجابة يبلغ 0 مللي ثانية.

مرجع أنماط السجلّات:

المشاكل المعروفة:

في ما يلي الأخطاء المعروفة التي يتسبب فيها "المستكشف":

1. تبديل الصوت في اللعبة غير صحيح
   • ستضبط هواتف Samsung حالة الاتصال على CONNECTED_A2DP_WITH_AVRCP بدلاً من CONNECTED_A2DP_ONLY عند تشغيل الألعاب.
   • قد تعيد بعض الألعاب (مثل Candy Crush) تشغيل الموسيقى في الخلفية وتؤدي إلى بدء حدث صوتي جديد بدون تدخل المستخدم. قد تبدِّل الهواتف المتصلة باستمرار الصوت على كل هاتف يفتح اللعبة.