'अभी चल रहा है' कार्ड दिखाना

उपयोगकर्ता के होम स्क्रीन पर वापस आने के बाद भी, उन टीवी ऐप्लिकेशन पर ऑडियो चलाया जा सकता है जिनमें ऑडियो चलता है किसी अन्य ऐप पर स्विच करता है. ऐसा करने के लिए, ऐप्लिकेशन को होम पेज पर अभी चल रहा है कार्ड देना होगा स्क्रीन. इस कार्ड से, लोगों को यह समझने में मदद मिलती है कि ऑडियो कहां से आ रहा है. इसके बाद, वे आपके ऐप्लिकेशन पर वापस आ सकते हैं मीडिया प्लेबैक को कंट्रोल कर सकता है.

जब कोई चालू हो 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);

इस्तेमाल के मान्य उदाहरण

अभी चल रहा है कार्ड का इस्तेमाल सिर्फ़ तब किया जाना चाहिए, जब लोगों को लगता हो कि ऑडियो चलता रहेगा ऐप्लिकेशन से बाहर निकलते समय बैकग्राउंड में वीडियो चलाएं. गेम का वीडियो चलाने या उसकी आवाज़ हमेशा को भी रोकें, जब तक कि आपका ऐप्लिकेशन 'पिक्चर में पिक्चर' सुविधा के साथ इंटिग्रेट न हो जाए.