عناصر التحكّم في الوسائط في واجهة مستخدم النظام

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

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

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

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

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

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

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

واجهة برمجة التطبيقات Remote playback API

لتقديم تجربة وسائط متماسكة على مجموعة متنوعة من الأسطح، بدءًا من 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

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

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

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

ليس على الشركات المصنّعة للأجهزة الأصلية إجراء أي تغييرات ويمكنها استخدام التنفيذ التلقائي في مشروع Android مفتوح المصدر (AOSP).

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

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

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

لاختبار عناصر التحكّم في الوسائط في واجهة مستخدم النظام، نفِّذ اختبارًا يدويًا للتحقّق من ما يلي:

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

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

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