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

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

• تحضير الأجهزة الاختبارية
  • ستحتاج إلى 5 أجهزة Android.
    • ويجب أن تتضمّن هذه الأجهزة ما يلي:
      • إصدار Android T واحد على الأقل (13) وAndroid V (15) على الأقل
      • هاتف Samsung واحد على الأقل وهاتف Pixel واحد على الأقل
      • على سبيل المثال:
        • هاتف OnePlus 1 (نظام التشغيل Android 10)
        • 3 Samsung (Android 11 و12 و13).
        • هاتف Pixel واحد (نظام التشغيل Android 15)
  • جهاز واحد بدون ميزة "تبديل مصدر الصوت":
    • أي جهاز 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

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

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

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

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

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

إذا أردت، يمكنك اختيار ما يلي إذا كان مقدّمو الخدمات يتيحون استخدام اتصالات Dual LE Audio:

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

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

الاستعداد للجهاز قيد الاختبار (DUT)

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

النطاق

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

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

• إنشاء نسخة من تقرير الاختبار الذاتي لتبديل الصوت
• إجراء جميع حالات الاختبار مرتين على الأقل.

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

تقنية 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- إجراء عملية الربط الجهاز A=Pixel 7 pro (13)، الجهاز B=Pixel 6(12) العمود E: الهاتف=Pixel 6، نظام التشغيل=Android 12

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

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

1. الجهاز "أ" = الإصدار V من Android (15) + الجهاز "ب" = الإصدار T من Android (13)
2. الجهاز A=Android T (13) + الجهاز B=Android V (15)
3. الجهاز A=Android T (13) + الجهاز B=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) عمود E: الهاتف = Samsung S10+، نظام التشغيل = Android 12
  • [LEA+LEA]: الجهاز أ=Pixel 8 (15)، الجهاز ب=Pixel 8(15) العمود هـ: الهاتف=Pixel 8، نظام التشغيل=Android 15

مثال على اختبار مكتمل في قالب الاختبار الذاتي:

الأحداث الصوتية:

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

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

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

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

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

  • أحدث إشعار للحالة:

  

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

  

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

  

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• نوع الباحث

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

نوع الصوت

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

• بروتوكول الصوت على الإنترنت
  • سيؤدي اختيار هذا الوضع إلى تغيير وضع الصوت إلى 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 ثوانٍ.

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

  • يبدأ الزران "تشغيل" و"إيقاف" من تشغيل الصوت أو إيقافه.

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

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

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

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

            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) تشغيل الموسيقى في الخلفية وتؤدي إلى بدء حدث صوتي جديد بدون تدخل المستخدم. قد تقوم الهواتف المتصلة بتبديل الصوت باستمرار على كل هاتف يفتح اللعبة.