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

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

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

Google Play पर अपने टीवी ऐप्लिकेशन पब्लिश करने के तरीके के बारे में जानने के लिए, Android TV पर ऐप्लिकेशन उपलब्ध कराना लेख पढ़ें.

विज़ुअल डिज़ाइन और यूज़र इंटरैक्शन

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

टाइप टेस्ट ब्यौरा
लॉन्चर TV-LM

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

TV-LB

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

TV-BN

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

TV-LG

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

TV-LS

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

लेआउट TV-LO

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

TV-OV

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

TV-TR

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

TV-DP

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

TV-DK

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

TV-DM

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

TV-DB

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

TV-DL

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

TV-SB

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

सुविधाएं और परफ़ॉर्मेंस

इन शर्तों से यह पक्का किया जाता है कि आपका ऐप्लिकेशन सही तरीके से कॉन्फ़िगर किया गया है और उम्मीद के मुताबिक काम कर रहा है.

टाइप टेस्ट ब्यौरा
SDK टूल TV-PS ऐप्लिकेशन की परफ़ॉर्मेंस और स्थिरता से जुड़ी ज़रूरी शर्तों के अलावा, ऐप्लिकेशन में Android TV डिवाइसों पर काम करने की सुविधा होनी चाहिए. इसके लिए, minSdkVersion वैल्यू सेट करके, Android SDK का कम से कम वर्शन 31 या इससे कम सेट करना होगा.
मेनिफ़ेस्ट TV-ML

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

TV-MT

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

गेम कंट्रोलर TV-GP

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

TV-GC

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

विज्ञापन TV-AP

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

TV-AD

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

TV-AU

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

TV-AA

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

वेब कॉन्टेंट TV-WB

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

मीडिया प्लेबैक TV-NP

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

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

TV-PA

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

TV-PP

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

TV-PC

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

TV-PN

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

ऐंबियंट मोड TV-BU

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

TV-BY

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

TV-BA

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

मेमोरी
TV-ME

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

Google Play

Google Play पर अन्य लिस्टिंग और क्लासिफ़िकेशन के साथ अपने ऐप्लिकेशन को एक जैसा कॉन्फ़िगर करने के लिए, इन ज़रूरी शर्तों का पालन करें:

टाइप टेस्ट ब्यौरा
पिक्चर में पिक्चर TV-IC

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

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

TV-IP

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

TV-IQ

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

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

TV-IH

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

TV-IE

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

TV-IS

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

TV-IX

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

Play की नीतियां TV-G1

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

TV-G2

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

ऐप्लिकेशन की ज़्यादा जानकारी वाला पेज TV-G3

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

TV-G4

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

लॉगिन क्रेडेंशियल TV-G5

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

अक्सर पूछे जाने वाले सवाल

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

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

चेतावनी: पक्का करें कि आपके ऐप्लिकेशन में, टीवी डिवाइसों के लिए मेनिफ़ेस्ट की ज़रूरी एंट्री शामिल हों. ऐसा न करने पर, आपके ऐप्लिकेशन को टीवी ऐप्लिकेशन नहीं माना जाएगा. साथ ही, टीवी पर इस्तेमाल करने से जुड़ी ज़रूरी शर्तों के लिए, इसकी समीक्षा नहीं की जाएगी.

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

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

अगर मेरा ऐप्लिकेशन पब्लिश करने की ज़रूरी शर्तें पूरी करता है, तो यह टीवी डिवाइसों पर Google Play Store में कब उपलब्ध होगा?

टीवी के लिए ज़रूरी शर्तें पूरी करने वाले ऐप्लिकेशन, टीवी डिवाइसों पर Play Store में तुरंत दिखने लगेंगे.