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

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

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

معايير الشهادة

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

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

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

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

النطاق

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

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

• قم بتشغيل جميع حالات الاختبار مرتين على الأقل.
• يجب إجراء الاختبارات بالصيغة التالية:

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

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

• الهواتف التجريبية:

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

• الاختبارات المنفّذة:

  • قم بتشغيل 1. الجهاز A=Samsung S10+ (12)، الجهاز B=Pixel 7 pro (13) العمود D: الهاتف=Pixel 7 pro، نظام التشغيل=Android 13
  • قم بتشغيل 2. الجهاز A=Pixel 7 pro (13)، الجهاز B=Pixel 6(12) العمود E: الهاتف=Pixel 6، نظام التشغيل=Android 12

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

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

• في ما يلي الأنواع الأربعة للأحداث الصوتية التي يتم اختبارها وتطبيقات الاختبار المقترَحة:
  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. أحدث إشعار حالة:

  2. ما مِن إشعار بشأن مفتاح التبديل:

ملاحظة: "أحدث حالة" هي حالة الاتصال عند وقوع الحدث الصوتي، وليس آخر حدث حالي.

1. تبديل إشعار وقت الاستجابة:

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

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

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

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

• سيؤدي استخدام التطبيق لتشغيل أحداث الصوت عبر بروتوكول الصوت على الإنترنت (VoIP)/الوسائط/الألعاب أثناء إجراء الاختبار الذاتي إلى تبسيط عملية إعداد الاختبار وتقليل وقت استجابة الحدث لـ "الباحث".
  • يمكن تنزيل الإصدار 1.03 من هنا.

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

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

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

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

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

المزوِّد المستهدف

سيؤدي هذا الزر إلى عرض قائمة بالأجهزة المقترنة التي تتضمّن بلوتوث عند النقر عليها. حدد المنصة التي تريد اختبارها.

يعمل زرَّي "الاتصال" و"قطع الاتصال" بالطريقة نفسها التي يظهر فيها زر "الاتصال" و"قطع الاتصال" في تفاصيل الجهاز.

الوضع الحالي

يعرض هذا الحقل آخر حالة اتصال حصل عليها "الباحث" من مقدّم الخدمة باستخدام إعلان تقنية BLE أو بث الأحداث.

تظهر هنا أيضًا إشعارات تصحيح أخطاء تبديل مصدر الصوت.

نوع الباحث

يتم استخدام هذا الخيار لتبديل الجهاز بين عمليات البث الصوتي.

نوع الصوت

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 ثوانٍ.

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

يؤدي النقر على زرَّي "التشغيل" و"إيقاف" إلى بدء الصوت أو إيقافه.

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

يعرض هذا الحقل وقت الاستجابة النشط للاتصال والتبديل. وتعرِض أيضًا سبب رفض التبديل إذا تم تشغيل حدث صوتي ولكن لم يحدث.

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

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

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