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

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

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

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

تغييرات زر العمل

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

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

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

واجهة برمجة التطبيقات للتشغيل عن بعد

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

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

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

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

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

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

تنفيذ السيطرة على وسائل الإعلام

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

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

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

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

التحقق من صحة السيطرة على وسائل الإعلام

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

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

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

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

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