टीवी ऐप्लिकेशन की क्वालिटी

इंस्टॉल होने के बाद, ऐप्लिकेशन Android TV Launcher में लॉन्चर आइकॉन दिखाता है. ज़्यादा जानकारी के लिए, टीवी पर की गई गतिविधि की जानकारी देना लेख पढ़ें.

ऐप्लिकेशन, Android TV लॉन्चर में लॉन्चर आइकॉन के तौर पर, 320x180 पिक्सल का फ़ुल-साइज़ बैनर और कम से कम 160x160 पिक्सल (xhdpi डेंसिटी पर) का ऐप्लिकेशन आइकॉन दिखाता है. ज़्यादा जानकारी के लिए, Android TV ऐप्लिकेशन के आइकॉन और बैनर के लिए दिशा-निर्देश देखें.

ऐप्लिकेशन लॉन्च करने वाले बैनर में ऐप्लिकेशन का नाम शामिल हो.

अगर ऐप्लिकेशन कोई गेम है, तो यह Android TV Launcher में गेम वाली लाइन में दिखता है.
ज़्यादा जानकारी के लिए, होम स्क्रीन पर अपना गेम दिखाना लेख पढ़ें.

ऐप्लिकेशन सही तरीके से काम करता है और इसमें गड़बड़ी के मैसेज नहीं दिखते. ऐसा इंस्टॉल करने, लोड करने, और टेस्टिंग के दौरान भी होता है. ज़्यादा जानकारी के लिए, टीवी ऐप्लिकेशन चलाना लेख पढ़ें.

ऐप्लिकेशन के सभी इंटरफ़ेस, लैंडस्केप ओरिएंटेशन में दिखाए जाते हैं. साथ ही, इनमें वर्टिकल लेटरबॉक्सिंग/पिलरबॉक्सिंग नहीं होती है. ओरिजनल फ़ॉर्मैट वाले वीडियो के बार के लिए, सिर्फ़ काले रंग का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, टीवी के लिए बुनियादी लेआउट बनाना लेख पढ़ें.

ऐप्लिकेशन में ऐसा कोई टेक्स्ट या सुविधा नहीं दिखनी चाहिए जो स्क्रीन के किनारों से कट गई हो. ज़्यादा जानकारी के लिए, ओवरस्कैन देखें.

ऐप्लिकेशन, दूसरे ऐप्लिकेशन को कुछ हद तक नहीं छिपाता है. ऐप्लिकेशन पूरी स्क्रीन पर दिखता हो और उसका बैकग्राउंड पारदर्शी न हो.

ऐप्लिकेशन में नेविगेट करने के लिए, पांच बटन वाले डी-पैड कंट्रोल का इस्तेमाल किया जा सकता है. हालांकि, अगर ऐप्लिकेशन के लिए गेम कंट्रोलर की ज़रूरत है, तो ऐसा नहीं किया जा सकता. इसकी जानकारी, यहां दी गई फ़ंक्शनैलिटी टेबल के कंट्रोलर सेक्शन में मौजूद टीवी-जीपी के मानदंड में दी गई है. ज़्यादा जानकारी के लिए, टीवी पर नेविगेशन देखें.

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

ऐप्लिकेशन, यूज़र इंटरफ़ेस कंट्रोल ऐक्सेस करने के लिए, रिमोट कंट्रोल डिवाइस पर मौजूद मेन्यू बटन पर निर्भर नहीं करता.

बैक बटन दबाने पर, Android TV की होम स्क्रीन पर वापस आ जाता है. ज़्यादा जानकारी के लिए, 'वापस जाएं' बटन के काम करने का सही तरीका बताएं लेख पढ़ें.

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

ऐप्लिकेशन में खोज क्वेरी, खोज बॉक्स में दिखती है. यह SearchFragment के यूज़र इंटरफ़ेस (यूआई) की तरह होती है. साथ ही, नतीजे उस क्वेरी के हिसाब से होते हैं. ज़्यादा जानकारी के लिए, टीवी ऐप्लिकेशन में खोजना लेख पढ़ें.

ऐप्लिकेशन मेनिफ़ेस्ट, ACTION_MAIN कैटगरी के साथ ACTION_MAIN का इंटेंट टाइप सेट करता है.CATEGORY_LEANBACK_LAUNCHER ज़्यादा जानकारी के लिए, टीवी पर की गई गतिविधि की जानकारी देना लेख पढ़ें.

ऐप्लिकेशन मेनिफ़ेस्ट, हार्डवेयर की सुविधा android.hardware.touchscreen और "टीवी के लिए हार्डवेयर से जुड़ी ज़रूरी शर्तों के बारे में जानकारी देना" में दी गई अन्य सुविधाओं को 'ज़रूरत नहीं है' के तौर पर सेट करता है. ज़्यादा जानकारी के लिए, टीवी के लिए हार्डवेयर से जुड़ी ज़रूरी शर्तों के बारे में जानकारी देना लेख पढ़ें.

अगर ऐप्लिकेशन में गेम कंट्रोलर का इस्तेमाल इनपुट के मुख्य तरीके के तौर पर किया जाता है, तो वह <uses-feature> मेनिफ़ेस्ट टैग का इस्तेमाल करके, ज़रूरी शर्तों का एलान करता है. ज़्यादा जानकारी के लिए, गेम कंट्रोलर के साथ काम करने की सुविधा के बारे में जानकारी देना लेख पढ़ें.

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

ऐप्लिकेशन में, डी-पैड कंट्रोल का इस्तेमाल करके विज्ञापनों के साथ इंटरैक्ट करने की सुविधा मिलती है. ज़्यादा जानकारी के लिए, डी-पैड नेविगेशन चालू करना लेख पढ़ें.

फ़ुलस्क्रीन पर दिखने वाले नॉन-वीडियो विज्ञापनों के लिए, ऐप्लिकेशन लोगों को डी-पैड या गेमपैड कंट्रोल से विज्ञापन को तुरंत खारिज करने की अनुमति देता है.

क्लिक किए जा सकने वाले, नॉन-फ़ुलस्क्रीन, और नॉन-वीडियो विज्ञापनों का इस्तेमाल करने वाले विज्ञापन के लिए, ऐप्लिकेशन विज्ञापनों को वेब यूआरएल से लिंक करने की अनुमति नहीं देता.

क्लिक किए जा सकने वाले, फ़ुलस्क्रीन पर नहीं दिखने वाले, और वीडियो के अलावा अन्य विज्ञापनों का इस्तेमाल करने वाले ऐप्लिकेशन में, विज्ञापनों को ऐसे अन्य ऐप्लिकेशन से लिंक करने की अनुमति नहीं होती जो टीवी डिवाइसों पर उपलब्ध नहीं है.

वेब कॉन्टेंट के लिए, ऐप्लिकेशन सिर्फ़ WebView कॉम्पोनेंट का इस्तेमाल कर सकता है. ऐप्लिकेशन, किसी वेब ब्राउज़र ऐप्लिकेशन को लॉन्च करने की कोशिश नहीं कर सकता.

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

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

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

अगर ऐप्लिकेशन वीडियो या संगीत से जुड़ा कॉन्टेंट चलाता है, तो प्लेबैक के दौरान चलाएं या रोकें बटन का इवेंट भेजे जाने पर, ऐप्लिकेशन मीडिया प्लेबैक को चलाने और रोकने के बीच टॉगल करता है. ज़्यादा जानकारी के लिए, KEYCODE_MEDIA_PLAY_PAUSE देखें.

वीडियो या ऑडियो चलाने के दौरान, डी-पैड के बीच वाले बटन को दबाने से, चल रहा मीडिया रुक जाता है. वीडियो रुकने पर, डी-पैड के बीच वाले बटन को दबाने से वीडियो फिर से चलने लगता है. डी-पैड पर मौजूद लेफ़्ट और राइट बटन का इस्तेमाल करके, मौजूदा ट्रैक को तेज़ी से आगे और पीछे किया जा सकता है. ज़्यादा जानकारी के लिए, मीडिया इवेंट देखें.

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

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

अगर कोई व्यक्ति वीडियो या ऐनिमेशन नहीं चलाता है, तो ऐप्लिकेशन डिवाइस को ऐंबियंट मोड में जाने से नहीं रोकता है.

सिर्फ़-ऑडियो वाले मोड में वीडियो चलाने के मामले में, ऐप्लिकेशन डिवाइस को ऐंबियंट मोड पर जाने से नहीं रोकता है. हालांकि, ऐसा तब होता है, जब ऐप्लिकेशन में संगीत चलने के दौरान, स्थिर इमेज के बजाय संगीत वीडियो या इमेज जैसी कोई अन्य सुविधा लागू की गई हो.

कम रैम वाले डिवाइसों के लिए, फ़ोरग्राउंड ऐप्लिकेशन के लिए मेमोरी का ज़्यादा से ज़्यादा इस्तेमाल (Anon+Swap + Graphics + File Memory) तय की गई सीमाओं के अंदर होना चाहिए. कम रैम वाले डिवाइसों के लिए, ActivityManager.isLowRamDevice() फ़ंक्शन, true वैल्यू दिखाता है. इन सीमाओं में, मेज़रमेंट के खास तरीके और चेतावनियां भी शामिल हैं. इनके बारे में [मेमोरी के इस्तेमाल को ऑप्टिमाइज़ करें.][optimize-memory-usage] लेख में बताया गया है

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

ज़्यादा जानकारी के लिए, टीवी पर मल्टीटास्किंग लेख पढ़ें.

पिक्चर-इन-पिक्चर मोड में, ऐप्लिकेशन ऐसा प्रमोशन वाला कॉन्टेंट या विज्ञापन नहीं दिखाता जो कॉन्टेंट सोर्स का हिस्सा न हो.

पिक्चर-इन-पिक्चर मोड में, ऐप्लिकेशन से फ़ुलस्क्रीन में चल रही किसी दूसरी गतिविधि पर कोई असर नहीं पड़ता.

ऐप्लिकेशन को बहुत ज़्यादा संसाधनों का इस्तेमाल नहीं करना चाहिए, ऑडियो फ़ोकस पर कब्ज़ा नहीं करना चाहिए, चालू MediaSession में दख़ल नहीं देना चाहिए या डिकोडर सेशन की ज़रूरत से ज़्यादा संख्या का अनुरोध नहीं करना चाहिए.

पिक्चर इन पिक्चर मोड में, ऐप्लिकेशन कोई यूज़र इंटरफ़ेस (यूआई) कंट्रोल या नेविगेट किए जा सकने वाले एलिमेंट नहीं दिखाता है. ऐप्लिकेशन, कुछ उपयोगकर्ता कंट्रोल को सीधे तौर पर PiP विंडो में दिखा सकते हैं.

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

अगर किसी डिवाइस पर पिक्चर में पिक्चर मोड बंद है, तो ऐप्लिकेशन को पीआईपी मोड में जाने के लिए कोई यूज़र इंटरफ़ेस (यूआई) नहीं दिखाना चाहिए.

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

Google Play Store पर मौजूद सभी नए और मौजूदा टीवी ऐप्लिकेशन के लिए, Android ऐप्लिकेशन बंडल का इस्तेमाल करना ज़रूरी है.

आपके ऐप्लिकेशन को Play Developer Policy Center की ज़रूरी शर्तों का पालन करना होगा.

आपका ऐप्लिकेशन, 1 अगस्त, 2026 से 64-बिट आर्किटेक्चर के साथ काम करना चाहिए.

आपका ऐप्लिकेशन, 1 अगस्त, 2026 से 16 केबी वाले पेज साइज़ के साथ काम करना चाहिए.

ऐप्लिकेशन की सुविधाएं, उम्मीद के मुताबिक काम करती हैं या Google Play Store पर ऐप्लिकेशन के स्टोर पेज में दी गई जानकारी के मुताबिक काम करती हैं.

ऐप्लिकेशन सबमिट करने वाले व्यक्ति ने, बिना बदलाव किए, हाई रिज़ॉल्यूशन वाला कम से कम एक ऐसा स्क्रीनशॉट अपलोड किया हो जिसमें टीवी ऐप्लिकेशन के मौजूदा वर्शन की पूरी जानकारी दिख रही हो.

पैसे चुकाकर इस्तेमाल की जाने वाली सुविधाओं वाले ऐप्लिकेशन के लिए, आपको Google Play Console में लॉगिन क्रेडेंशियल देने होंगे. इससे, ऐप्लिकेशन की सभी सुविधाओं को टेस्ट किया जा सकेगा. ज़्यादा जानकारी के लिए, ऐप्लिकेशन को समीक्षा के लिए तैयार करने के दौरान ऐप्लिकेशन का ऐक्सेस लेख पढ़ें.