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

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

  • تجهيز الأجهزة الاختبارية
    • ستحتاج إلى 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: تعرِض هذه الصورة رسالة "إشعار الحالة الأخيرة".

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

    الشكل 2: تعرِض هذه الصورة رسالة "عدم إرسال إشعار بالتبديل".

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

    الشكل 3: تعرِض هذه الصورة رسالة "إشعار وقت استجابة التبديل".

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

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