ضوابط الوسائط في واجهة مستخدم النظام

بدءًا من Android 13 ، تحتوي عناصر التحكم في الوسائط في System UI على تحديثات لأزرار الإجراءات والتشغيل عن بُعد. تدعم هذه التغييرات تجربة تحكم أكثر صقلًا في الوسائط على الهواتف والأجهزة اللوحية ، وتوفر نقلًا سلسًا للوسائط عبر الأجهزة.

تحديثات لعناصر التحكم في الوسائط

يصف هذا القسم التحديثات التي تم إجراؤها على عناصر التحكم في الوسائط في Android 13 لأزرار الإجراءات والتشغيل عن بُعد.

يتغير زر الإجراء

للتأكد من أن المستخدمين يمكنهم الوصول إلى مجموعة غنية من عناصر التحكم في الوسائط للتطبيقات التي تقوم بتشغيل الوسائط ، يتم اشتقاق أزرار الإجراءات الموجودة في عناصر التحكم في الوسائط لنظام Android 13 من حالات إجراء PlaybackState . مع هذا التغيير ، تقوم الوظيفة MediaDataManager#createActionsFromState بإنشاء معلومات زر الإجراء بناءً على حالة إجراء PlaybackState . يتماشى هذا مع كيفية عرض عناصر التحكم في الوسائط في أنظمة Android الأساسية الأخرى مثل Auto و Assistant و Wear.

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

للحصول على ملخص بالتغييرات المتوافقة مع التطبيق لتحديثات زر الإجراء ، راجع StatusBarManager .

التشغيل عن بعد API

لتقديم تجربة وسائط متماسكة عبر مجموعة متنوعة من الأسطح ، بدءًا من Android 13 ، تمت إضافة Notification#setRemotePlaybackInfo لتمييز إشعارات الوسائط على واجهة مستخدم نظام التحكم في الوسائط للتشغيل عن بُعد. تتيح واجهة برمجة التطبيقات هذه لتطبيقات النظام التي تنشر الإشعارات القيام بما يلي:

• قم بتوفير المعلومات والوظائف للوسائط التي تنشأ على جهاز بعيد لمحول الإخراج الافتراضي في التحكم في الوسائط.
• استبدل قدرة محول الإخراج إذا لزم الأمر.

يجب أن تحصل تطبيقات النظام التي تستخدم هذا الإشعار على إذن MEDIA_CONTENT_CONTROL .

تضيف Notification#setRemotePlaybackInfo API أيضًا extras التالية لتحديد الاسم والأيقونة والغرض من جهاز التشغيل عن بُعد:

• Notification#EXTRA_MEDIA_REMOTE_DEVICE
• Notification#EXTRA_MEDIA_REMOTE_ICON
• Notification#EXTRA_MEDIA_REMOTE_INTENT

باستخدام هذه المعلومات ، يمكن لـ System UI استبدال معلومات جهاز رقاقة محول الإخراج الافتراضي وإضافة التحكم في الوسائط للتشغيل عن بُعد إلى نهاية قائمة عناصر التحكم في الوسائط المحلية.

تنفيذ مراقبة وسائل الإعلام

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

لا يُطلب من مصنعي المعدات الأصلية إجراء أي تغييرات ويمكنهم استخدام التنفيذ الافتراضي في AOSP.

تخصيص التشغيل عن بعد

في الحالات التي يكون فيها لدى OEM تطبيق نظام ينشر إشعارات تشغيل الوسائط عن بُعد ، يمكن للتطبيق اختياريًا الاتصال بـ setRemotePlaybackInfo طالما تم منحه إذن MEDIA_CONTENT_CONTROL . ومع ذلك ، هذا ليس مطلبًا ويمكن للشريك اختيار عدم التخصيص.

التحقق من صحة التحكم في الوسائط

لاختبار التحكم في الوسائط في واجهة مستخدم النظام ، قم بإجراء اختبار يدوي للتحقق من صحة ما يلي:

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

استخدم الاختبارات التالية للتحقق من صحة واجهة برمجة تطبيقات التشغيل عن بُعد:

• اختبارات CTS في NotificationManagerTest ، مثل testMediaStyleRemotePlayback_noPermission و testMediaStyleRemotePlayback_hasPermission .
• اختبارات الوحدة تحت com.android.systemui.media .

راجع متطلبات التحريات المسبقة عن العمالقة الجديدة [3.8.3.1/H-1-SR] للحصول على توصيات.