होम स्क्रीन पर कॉन्टेंट का सुझाव देना

Android TV की होम स्क्रीन पर, चैनल और प्रोग्राम का इस्तेमाल करके, सुझाया गया कॉन्टेंट दिखाया जाता है. चैनल, होम स्क्रीन पर अलग-अलग लाइनों में दिखते हैं. इनमें कार्ड भी होते हैं जो उस चैनल के लिए उपलब्ध सभी प्रोग्राम दिखाते हैं.

आपके ऐप्लिकेशन में कम से कम एक चैनल होना चाहिए. आपका ऐप्लिकेशन जो पहला चैनल बनाता है वह उसका डिफ़ॉल्ट चैनल बन जाता है. Android TV, उस चैनल को होम स्क्रीन पर अपने-आप दिखाता है. आपका ऐप्लिकेशन अन्य चैनल ऑफ़र कर सकता है. हालांकि, उपयोगकर्ता को होम स्क्रीन पर जोड़े जाने से पहले, उन चैनलों को चुनना और मंज़ूरी देना ज़रूरी है.

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

यह पक्का करना कि आपका ऐप्लिकेशन, Android 14 के साथ काम करता हो

होम स्क्रीन पर, Android के वर्शन के हिसाब से दो अलग-अलग तरीकों से सुझाव दिखाए जाते हैं:

• Android 8.0 (एपीआई लेवल 26) और इसके बाद के वर्शन में, ऐप्लिकेशन एक या इससे ज़्यादा चैनलों में सुझाव दिखा सकते हैं. ये सुझाव अलग-अलग लाइनों में दिखते हैं. एक चैनल (डिफ़ॉल्ट चैनल) हमेशा दिखता है. उपयोगकर्ता, अन्य चैनलों को खोजकर उन्हें अपनी होम स्क्रीन पर जोड़ सकता है. होम स्क्रीन पर सुझाव वाले चैनल बनाने का तरीका जानें.
• Android 8.0 से पहले के वर्शन में, Android TV सभी सुझावों को एक ही पंक्ति में दिखाता है. यह पंक्ति हमेशा स्क्रीन पर दिखती है. होम स्क्रीन पर सुझाव वाली लाइन बनाने का तरीका जानें.

Android TV के सभी वर्शन पर सुझाव दिखाने के लिए, आपके ऐप्लिकेशन में सुझाव देने वाले दोनों एपीआई लागू होने चाहिए. सिस्टम के मौजूदा एपीआई लेवल की जांच करें. साथ ही, सुझाव वाली लाइन या चैनल बनाने के लिए सही एपीआई का इस्तेमाल करें.

if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    // Use the home screen recommendation channels API.
} else {
    // Use the recommendations row API.
}
Recommendations.kt

अगर आपके ऐप्लिकेशन को एपीआई लेवल 25 या उससे पहले के लेवल का इस्तेमाल करके कंपाइल किया गया था, तो वह अब भी Android TV पर लेवल 26 में काम कर सकता है. सुझावों का पुराना तरीका, आगे के वर्शन के साथ काम करता है. हालांकि, इसमें कुछ पाबंदियां हैं:

• सुझावों की लाइन अपने-आप बदल जाती है और होम स्क्रीन पर नए चैनल के तौर पर दिखती है.
• बदले गए चैनल पर मौजूद प्रोग्राम, सुझाव देने वाली सेवा से मिलने वाले अपडेट के हिसाब से काम करते हैं. हालांकि, उपयोगकर्ता टीवी के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, चैनल पर मौजूद प्रोग्राम में बदलाव नहीं कर सकता. जैसे, प्रोग्राम जोड़ना/हटाना, प्रोग्राम को 'अगला वीडियो' चैनल पर कॉपी करना.
• अगर ऐप्लिकेशन को एपीआई लेवल 26 पर अपडेट किया जाता है, तो बदला गया चैनल अब भी एपीआई 26 पर चलने वाले टीवी पर दिखता है. जब आपका ऐप्लिकेशन पहली बार नए एपीआई से बनाए गए चैनल को दिखाता है, तब टीवी स्क्रीन से कन्वर्ट किए गए चैनल को हटा देता है. ऐसा तब होता है, जब ऐप्लिकेशन कोई डिफ़ॉल्ट चैनल बनाता है या बाद में जब उपयोगकर्ता आपके ऐप्लिकेशन से बनाए गए किसी अन्य चैनल को चुनता है और जोड़ता है.

ध्यान दें: फ़ॉरवर्ड-कंपैटिबल होने की यह सुविधा कुछ समय के लिए है. इसे आने वाले समय में हटा दिया जाएगा. यह पक्का करने के लिए कि आपका ऐप्लिकेशन सभी डिवाइसों पर काम करे, सबसे सही तरीका यह है कि दोनों एपीआई लागू किए जाएं. इस बारे में इस सेक्शन में बताया गया है.