اعتبارًا من Android 13، تحتوي عناصر التحكّم في الوسائط في واجهة مستخدم النظام على تعديلات على أزرار الإجراءات والتشغيل عن بُعد. تساهم هذه التغييرات في توفير تجربة أكثر سلاسة للتحكّم في الوسائط على الهواتف والأجهزة اللوحية، وتتيح نقل الوسائط بسلاسة بين الأجهزة.
تعديلات على عناصر التحكّم في الوسائط
يصف هذا القسم التعديلات التي تم إجراؤها على عناصر التحكّم في الوسائط في Android 13 لأزرار الإجراءات والتشغيل عن بُعد.
تغييرات على أزرار الإجراءات
لضمان إمكانية وصول المستخدمين إلى مجموعة متنوعة من عناصر التحكّم في الوسائط للتطبيقات التي تشغّل
الوسائط، يتم استخلاص أزرار الإجراءات في عناصر التحكّم في الوسائط لنظام Android 13
من PlaybackState
حالات إجراءات.
باستخدام هذا التغيير، تنشئ الدالة MediaDataManager#createActionsFromState
معلومات زر الإجراء استنادًا إلى حالة إجراء PlaybackState.
يتوافق ذلك مع طريقة عرض عناصر التحكّم في الوسائط في منصّات Android الأخرى، مثل Auto و"مساعد Google" وWear.
في المقابل، في Android 12، تم تحديد أزرار الإجراءات في عناصر التحكّم في الوسائط
من خلال إجراءات الإشعارات
التي تمت إضافتها إلى إشعار MediaStyle.
للاطّلاع على ملخّص للتغييرات المتوافقة مع التطبيقات لتحديثات أزرار الإجراءات، يُرجى الاطّلاع على
StatusBarManager.
واجهة برمجة التطبيقات للتشغيل عن بُعد
لتقديم تجربة وسائط متماسكة على مجموعة متنوعة من الأسطح، بدءًا
من Android 13، تمت إضافة واجهة برمجة تطبيقات نظام جديدة Notification#setRemotePlaybackInfo
لوضع علامة على إشعارات الوسائط في واجهة مستخدم النظام للتحكّم في الوسائط من أجل التشغيل عن بُعد. تتيح واجهة برمجة التطبيقات هذه لتطبيقات النظام التي تنشر الإشعارات إجراء ما يلي:
- توفير معلومات ووظائف للوسائط التي يتم تشغيلها على جهاز بعيد إلى أداة التبديل بين أجهزة التشغيل التلقائية في أدوات التحكّم في الوسائط
- استبدال أداة تبديل الإخراج إذا لزم الأمر
يجب أن تحصل تطبيقات النظام التي تستخدم هذا الإشعار على إذن MEDIA_CONTENT_CONTROL.
تضيف واجهة برمجة التطبيقات Notification#setRemotePlaybackInfo أيضًا
extras
التالية لتحديد اسم جهاز التشغيل عن بُعد ورمزه وهدفه:
Notification#EXTRA_MEDIA_REMOTE_DEVICENotification#EXTRA_MEDIA_REMOTE_ICONNotification#EXTRA_MEDIA_REMOTE_INTENT
باستخدام هذه المعلومات، يمكن لواجهة مستخدم النظام استبدال معلومات الجهاز في شريحة أداة تبديل الإخراج التلقائية وإضافة عنصر التحكّم في الوسائط للتشغيل عن بُعد إلى نهاية قائمة عناصر التحكّم في الوسائط المحلية.
تنفيذ عنصر التحكّم في الوسائط
على الشركات المصنّعة للمعدات الأصلية أن تكون على دراية بهذا التغيير في السلوك التلقائي، لأنّه يؤثر في طريقة إنشاء عناصر التحكّم في الوسائط للتطبيقات. على الشركات المصنّعة للمعدات الأصلية أيضًا التأكّد من أنّ واجهة برمجة تطبيقات النظام الجديدة تعمل حسب الاقتضاء في أداة تبديل الإخراج.
ليس على الشركات المصنّعة للمعدات الأصلية إجراء أي تغييرات ويمكنها استخدام ال تنفيذ التلقائي في AOSP.
تخصيص التشغيل عن بُعد
في الحالات التي يكون لدى الشركة المصنّعة للمعدات الأصلية تطبيق نظام ينشر إشعارات تشغيل الوسائط عن بُعد، يمكن للتطبيق اختياريًا استدعاء setRemotePlaybackInfo للإشعار طالما تم منحه إذن MEDIA_CONTENT_CONTROL. ومع ذلك، هذا ليس شرطًا ويمكن للشريك اختيار عدم التخصيص.
التحقّق من عنصر التحكّم في الوسائط
لاختبار عنصر التحكّم في الوسائط في واجهة مستخدم النظام، يمكنك إجراء اختبار يدوي للتحقّق من ما يلي:
- تعمل الأزرار على النحو المطلوب أثناء تشغيل الوسائط من أحد التطبيقات.
- تعرض أداة التبديل بين أجهزة التشغيل معلومات الجهاز الصحيحة.
استخدِم الاختبارات التالية للتحقّق من واجهة برمجة التطبيقات للتشغيل عن بُعد:
- اختبارات مجموعة أدوات اختبار التوافق (CTS) في
NotificationManagerTest، مثلtestMediaStyleRemotePlayback_noPermissionوtestMediaStyleRemotePlayback_hasPermission. - اختبارات الوحدة ضمن
com.android.systemui.media.
يُرجى الرجوع إلى متطلبات CDD الجديدة [3.8.3.1/H-1-SR] للحصول على اقتراحات.