عرض بطاقة "التعرّف التلقائي على الموسيقى"

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

عند وجود نشاط MediaSession هو الآن، يعرض إطار عمل Android بطاقة جارٍ التشغيل الآن على الشاشة الرئيسية. البطاقة وتشمل البيانات الوصفية للوسائط، مثل صورة الألبوم والعنوان ورمز التطبيق. عندما يختار المستخدم البطاقة، يفتح النظام التطبيق.

بطاقة "التعرّف التلقائي على الموسيقى"

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

ملاحظة: لا تظهر بطاقة التعرّف التلقائي على الموسيقى إلا للوسائط فقط. جلسة مع FLAG_HANDLES_TRANSPORT_CONTROLS تعيين العلامات. تم إيقاف هذه العلامة نهائيًا في المستوى 26 من واجهة برمجة التطبيقات. ومع ذلك، قد تبقى هذه العلامة مطلوبة على الأجهزة القديمة للتوافق مع الأنظمة القديمة.

تتم إزالة البطاقة من شاشة مشغّل التطبيقات عند setActive(false) يؤدي الاتصال إلى إيقاف جلسة الوسائط أو عندما يبدأ تطبيق آخر تشغيل الوسائط. إذا كان التشغيل توقفت تمامًا ولا توجد وسائط نشطة، قم بإيقاف جلسة الوسائط فورًا. إذا تم إيقاف التشغيل مؤقتًا، يمكنك إيقاف جلسة الوسائط بعد انقضاء هذه المهلة، عادةً من 5 إلى 30 دقيقة.

تعديل البطاقة

عندما يعدِّل تطبيقك حالة التشغيل في "MediaSession"، يتم تعديل بطاقة التعرّف التلقائي على الموسيقى لعرض حالة الوسائط الحالية. لمعرفة كيفية إجراء ذلك، راجِع تعديل حالة التشغيل:

وبالمثل، يمكن لتطبيقك تحديث يجب توفير MediaMetadata. معلومات إلى بطاقة التعرّف التلقائي على الموسيقى حول الوسائط الحالية، مثل العنوان أو العنوان الفرعي وأيقونات متنوعة. لمعرفة كيفية إجراء ذلك، راجِع تعديل البيانات الوصفية للوسائط

الاستجابة لإجراء المستخدم

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

Kotlin

val pi: PendingIntent = Intent(context, MyActivity::class.java).let { intent ->
    PendingIntent.getActivity(
            context, 99 /*request code*/,
            intent,
            PendingIntent.FLAG_UPDATE_CURRENT
    )
}
session.setSessionActivity(pi)

Java

Intent intent = new Intent(context, MyActivity.class);
PendingIntent pi = PendingIntent.getActivity(context, 99 /*request code*/,
        intent, PendingIntent.FLAG_UPDATE_CURRENT);
session.setSessionActivity(pi);

حالات الاستخدام المقبولة

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