استخدام تطبيق تجريبي لوحدة التحكّم في الوسائط

تطبيقات الوسائط التي تتفاعل من خلال الصوت مع "مساعد Google" على هواتف Android تكون السيارات وأجهزة التلفزيون وسماعات الرأس متوافقة مع واجهات برمجة التطبيقات لجلسات وسائط Android، كما أنّها تستخدم إجراءات الوسائط. قد يكون من الصعب متابعة مراحل النشاط على مستوى الوسائط. حتى التشغيل البسيط من البحث يحتوي الطلب على العديد من الخطوات الوسيطة التي يمكن أن يحدث فيها خطأ ما، كما هو موضح في الجدول الزمني المبسط:

الشكل 1. مراحل النشاط الإعلامي

اختبار مسؤول التحكّم في الوسائط (MCT) اختبار التفاصيل المعقدة لتشغيل الوسائط على Android للتحقق من تنفيذ جلسة الوسائط.

تعرض ميزة MCT معلومات عن MediaController لتطبيقك، مثل PlaybackState والبيانات الوصفية ويمكن استخدامها لاختبار عناصر التحكّم في الوسائط بين التطبيقات. تشمل عملية MCT أيضًا اختبار التحقّق من المعلنين. إطار عمل يتيح لك إجراء اختبار تأكيد الجودة بشكل تلقائي.

لاستخدام ميزة MCT، يجب أن يحتوي التطبيق على خدمة متصفّح وسائط. ويجب السماح لـ MCT بالاتصال بها. عرض إنشاء خدمة متصفّح وسائط لمزيد من المعلومات.

بدء اختبار MCT

الشكل 2. صفحة إطلاق MCT

عند إطلاق ميزة MCT، ستظهر لك قائمتان:

• Active MediaSessions: تكون هذه القائمة فارغة في البداية عند تشغيل MCT. وستظهر لك الرسالة "لم يتم العثور على تطبيقات وسائط. إشعار يجب منح إذن المستمِع للبحث عن جلسات الوسائط النشطة". انقر على الإعدادات من أجل انتقِل إلى شاشة الأذونات وفعِّل الإذن MCT.
• عمليات تنفيذ MediaBrowserService: تعرض هذه القائمة التطبيقات التي نفَّذت إحدى خدمات متصفِّح الوسائط. إذا نفذت إحدى خدمات متصفح الوسائط، فسيظهر التطبيق في هذه القائمة، ولكن لا يمكنك استخدام MCT إلا إذا ضبطت تطبيقك على قبول جميع اتصالات أو إضافة MCT إلى القائمة المسموح بها. راجع التحكم في اتصالات العملاء باستخدام onGetRoot() لمزيد من المعلومات.

اختبار تطبيق الهاتف يدويًا

إذا سمحت لخدمة MCT بالاتصال بخدمة متصفّح الوسائط في تطبيقك، سينطبق ذلك على في قائمة عمليات تنفيذ قائمة خدمات متصفِّح الوسائط. اعثر عليه هناك وانقر على Control لبدء تشغيل التطبيق في الخلفية.

وبخلاف ذلك، يجب تشغيل التطبيق بنفسك أولاً في الخلفية، ثم النقر على التحكّم في وقت ظهوره في قائمة جلسات الوسائط النشطة

الاستعداد للاختبارات والتشغيل

عندما تبدأ ميزة MCT تتحكّم في تطبيقك، تعرض الجلسة الحالية للتطبيق. البيانات الوصفية: الوسائط المحددة حاليًا والإجراءات التي يتم تنفيذها في الجلسة مستعد للتعامل معه.

الشكل 3. صفحة التحكّم

يحتوي أعلى صفحة عناصر تحكُّم MCT على قائمة منسدلة حيث يمكنك اختيار البحث أو عنوان URI أو معرّف الوسائط أو بدون، إلى جانب حقل نصي لتحديد بيانات الإدخال المرتبطة بالبحث أو معرف الموارد المنتظم (URI) أو معرّف الوسائط إذا حدِّد أحد هذه الخيارات.

يؤدي الزران إعداد وتشغيل أسفل حقل النص مباشرةً إلى تنفيذ المكالمات المناسبة (onPrepare()، onPrepareFromSearch()، onPrepareFromUri()، onPrepareFromMediaId()، onPlay()، onPlayFromSearch()، onPlayFromUri()، onPlayFromMediaId()) اعتمادًا على الإجراء الذي اخترته.

اختبار التركيز الصوتي

يجب أن يكون تطبيق الوسائط ذو الأداء الجيد قادرًا على معالجة الصوت التركيز. يمكنك اختبار تركيز الصوت من خلال تشغيل تطبيق صوتي آخر إلى جانب التطبيق. تتضمن صفحة عناصر تحكم MCT الذي يطلب التركيز الصوتي ويصدره.

لاختبار تركيز الصوت، اتّبِع الخطوات التالية:

1. استخدِم القائمة المنسدلة التركيز على الصوت لاختيار أحد تعديلات المدة الزمنية الثلاثة. AUDIOFOCUS_GAIN أو AUDIOFOCUS_GAIN_TRANSIENT أو AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK
2. اضغط على الزر لطلب التركيز.
3. اضغط على الزر مرة أخرى لتحرير التركيز.

جارٍ اختبار عناصر التحكّم في وسيلة النقل

الشكل 4 اختبار عناصر التحكّم في النقل

مرِّر سريعًا لليمين لعرض طريقة عرض واجهة المستخدم في MCT. طريقة العرض هذه على أزرار النقل القياسية لوحدة التحكم في الوسائط وتعرض صورة البرنامج وبياناته. محاط بأزرار النقل غير المفعّلة. برتقالية جميع التطبيقات الأخرى نشطة.

اختبار اللاعب باستخدام أزرار النقل حالة أزرار النقل كما هو متوقع. على سبيل المثال، عند الضغط على زر PLAY، إيقاف، كما يتم تمكين زري "الإيقاف المؤقت" و"إيقاف".

التمرير سريعًا لليمين مرة أخرى للوصول إلى طريقة عرض تعرض إجراءات اختيارية كل إجراء عنصر تحكم يوضح ما إذا كان نشطًا أم لا. إذا كانت نشطة، يمكنك لتنفيذ الإجراء من خلال النقر فوقه.

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

اختبار تطبيق فيديو يدويًا

يمكنك استخدام وضع تقسيم الشاشة لاختبار وحدات تحكّم تطبيقات الفيديو. أولاً، افتح تطبيق الفيديو في نافذة واحدة، ثم افتح MCT في وضع تقسيم الشاشة.

جارٍ إجراء اختبارات التحقّق من الهوية

يقدّم إطار عمل اختبار إثبات الملكية الاختبارات بنقرة واحدة التي يمكنك إجراؤها من أجل تأكَّد من استجابة تطبيق الوسائط لطلب التشغيل بشكل صحيح.

اختبار تطبيق هاتف

الشكل 5 زر الاختبار

للوصول إلى اختبارات التحقّق من الهوية، انقر على الزر اختبار بجانب الوسائط. التطبيق.

حالة MCT

الشكل 6. حالة التحكّم في الوسائط

تُظهِر طريقة العرض التالية معلومات تفصيلية عن حساب MCT MediaController على سبيل المثال، PlaybackState والبيانات الوصفية وقائمة المحتوى التالي. يوجد زران في أعلى يمين شريط الأدوات. الزر على اليسار يبدِّل بين الروابط القابلة للتحليل. وتنسيقها. يعمل الزر الموجود على اليسار على تحديث العرض لعرض أحدث المعلومات.

اختيار اختبار

الشكل 7 صفحة الاختيار التجريبي

من خلال التمرير سريعًا إلى اليمين، ستصل إلى عرض اختبارات التحقق، حيث يمكنك ستظهر لك قائمة قابلة للتمرير للاختبارات المتاحة. إذا كان الاختبار يستخدم استعلامًا، مثل من اختبار البحث الموضح في الشكل 7، فهناك حقل نصي لإدخال سلسلة الاستعلام.

يتضمن MCT اختبارات لإجراءات الوسائط التالية، ويتم إجراء المزيد من الاختبارات المضافة باستمرار إلى المشروع:

• تشغيل
• التشغيل من "بحث Google"
• التشغيل من معرّف الوسائط
• التشغيل من معرّف الموارد المنتظم (URI)
• إيقاف مؤقت
• إيقاف
• التخطّي إلى التالي
• التخطّي إلى السابق
• التخطّي إلى قائمة المحتوى التالي
• الترجيع

نتائج الاختبار

الشكل 8 نتيجة اختبار ناجحة

تكون منطقة النتائج في أسفل العرض فارغة في البداية. وسيعرض لك النتائج عند إجراء اختبار. على سبيل المثال، لإجراء التشغيل من اختبار البحث، إدخال طلب بحث في حقل النص والنقر على تشغيل الاختبار ما يلي: لقطة الشاشة تعرض نتيجة اختبار ناجحة.

اختبار تطبيق Android TV

عند تشغيل ميزة MCT على Android TV، ستظهر لك قائمة بتطبيقات الوسائط المثبَّتة. لاحظ أن التطبيق لن يظهر في هذه القائمة إلا إذا كان يستخدم متصفح وسائط خدمة ما.

الشكل 9. صفحة إطلاق قناة MCT على التلفزيون

ينقلك اختيار تطبيق إلى شاشة الاختبار التي تعرض قائمة باختبارات التحقّق على يسار الشاشة.

الشكل 10. صفحة اختبارات إثبات الهوية على التلفزيون

عند إجراء اختبار، يعرض الجانب الأيسر من الشاشة معلومات عن تم تحديد MediaController. لمزيد من التفاصيل، راجِع سجلّات MCT في Logcat.

الشكل 11. صفحة معلومات الاختبار على التلفزيون

يظهر رمز لوحة مفاتيح على الاختبارات التي تتطلب طلب بحث. يؤدي النقر على أحد فهذه الاختبارات تفتح حقل إدخال للاستعلام. انقر على Enter لإجراء الاختبار.

لتسهيل إدخال النص، يمكنك أيضًا استخدام الأمر adb:

adb shell input text your-query

يمكنك استخدام "%s" لإضافة مسافة بين الكلمات. على سبيل المثال، ما يلي يضيف الأمر "hello world" إلى حقل الإدخال.

adb shell input text hello%sworld

إنشاء اختبار

يمكنك إرسال طلب سحب مع مزيد من الاختبارات التي تعتقد أنها مفيدة. للتعرّف على كيفية إنشاء اختبارات جديدة، يُرجى الانتقال إلى MCT GitHub Wiki وشاهد اختبار التحقق التعليمات.

يُرجى مراجعة تعليمات المساهمة.

مصادر إضافية

تم تصميم ميزة MCT جنبًا إلى جنب مع التطبيقات التي تنفِّذ واجهات برمجة تطبيقات الوسائط. يمكنك الاطّلاع على مشغِّل موسيقى Android العالمي للحصول على مثال لمثل هذا التطبيق.

نرحّب دائمًا بإصلاح الأخطاء وإجراء التحسينات. يُرجى الاطّلاع على تعليمات المساهمة.