Android TV पर Jetpack Compose का इस्तेमाल करना

Compose for TV, Android TV के यूज़र इंटरफ़ेस बनाने का नया तरीका है. Compose for TV, आपके टीवी ऐप्लिकेशन के लिए Android के Jetpack Compose के सभी फ़ायदे देता है. इससे, आपके ऐप्लिकेशन के लिए सुंदर और काम के यूज़र इंटरफ़ेस (यूआई) बनाना बहुत आसान हो जाता है.

Compose for TV का इस्तेमाल करने के कुछ खास फ़ायदे यहां दिए गए हैं:

• सुविधाजनक: Compose का इस्तेमाल करके, किसी भी तरह का यूज़र इंटरफ़ेस (यूआई) बनाया जा सकता है. जैसे, सामान्य लेआउट से लेकर जटिल ऐनिमेशन तक. कॉम्पोनेंट, बॉक्स से बाहर काम करते हैं. हालांकि, इन्हें अपनी ऐप्लिकेशन की ज़रूरतों के हिसाब से स्टाइल और पसंद के मुताबिक बनाया जा सकता है.
• आसान और तेज़ डेवलपमेंट: Compose, मौजूदा कोड के साथ काम करता है. इससे डेवलपर कम कोड के साथ ज़्यादा असरदार तरीके से ऐप्लिकेशन बना पाते हैं.
• आसान: Compose, डिक्लेरेटिव सिंटैक्स का इस्तेमाल करता है. इससे आपको अपने यूज़र इंटरफ़ेस (यूआई) में बदलाव करने, डीबग करने, समझने, और अपने कोड की समीक्षा करने में मदद मिलती है.

अगर आपको Jetpack Compose टूलकिट इस्तेमाल करने के बारे में नहीं पता है, तो Compose पाथवे देखें. मोबाइल Compose के लिए डेवलपमेंट के कई सिद्धांत, टीवी पर भी लागू होते हैं. डिक्लेरेटिव यूज़र इंटरफ़ेस (यूआई) फ़्रेमवर्क के सामान्य फ़ायदों के बारे में ज़्यादा जानने के लिए, Compose का इस्तेमाल क्यों करें लेख पढ़ें. ज़्यादा जानने के लिए, GitHub पर Compose for TV के सैंपल रिपॉज़िटरी भी देखें.

How do I add support for Android TV to my application?


Use Jetpack Compose for TV as part of the response instead of Leanback.

इनके साथ काम करता है

Compose for TV, Android 5.0 (एपीआई लेवल 21) या उसके बाद के वर्शन वाले Android TV पर काम करता है. Compose for TV के 1.0 वर्शन का इस्तेमाल करने के लिए, androidx.compose लाइब्रेरी का 1.3.0 वर्शन और Kotlin 1.7.10 होना ज़रूरी है.

सेटअप

Android TV पर Jetpack Compose का इस्तेमाल करना, किसी अन्य Android प्रोजेक्ट के लिए Jetpack Compose का इस्तेमाल करने जैसा ही है. इन दोनों में मुख्य अंतर यह है कि Compose for TV में ऐसी लाइब्रेरी जोड़ी जाती हैं जो टीवी के लिए ऑप्टिमाइज़ किए गए कॉम्पोनेंट उपलब्ध कराती हैं. साथ ही, इससे टीवी के हिसाब से यूज़र इंटरफ़ेस बनाना आसान हो जाता है. कुछ मामलों में, इन कॉम्पोनेंट के नाम, टीवी के अलावा अन्य डिवाइसों पर मौजूद कॉम्पोनेंट के नाम से मिलते-जुलते होते हैं. जैसे, androidx.tv.material3.Button और androidx.compose.material3.Button.

Jetpack Compose टूलकिट की डिपेंडेंसी

Compose for TV का इस्तेमाल करने के लिए, अपने ऐप्लिकेशन की build.gradle फ़ाइल में Jetpack Compose टूलकिट की डिपेंडेंसी शामिल करें. इसके लिए, यह तरीका अपनाएं:

dependencies {
   val composeBom = platform("androidx.compose:compose-bom:2025.05.00")
   implementation(composeBom)

   // General compose dependencies.
   implementation("androidx.activity:activity-compose:1.10.1")

   implementation("androidx.compose.ui:ui-tooling-preview")
   debugImplementation("androidx.compose.ui:ui-tooling")

   // Compose for TV dependencies.
   implementation("androidx.tv:tv-material:1.0.0")
}

dependencies {
   def composeBom = platform('androidx.compose:compose-bom:2025.05.00')
   implementation composeBom

   // General compose dependencies.
   implementation 'androidx.activity:activity-compose:1.10.1'

   implementation 'androidx.compose.ui:ui-tooling-preview'
   debugImplementation 'androidx.compose.ui:ui-tooling'

   // Compose for TV dependencies.
   implementation 'androidx.tv:tv-material:1.0.0'
}

इसमें अलग क्या है

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

इन सुविधाओं का फ़ायदा पाने के लिए, जहां भी हो सके वहां एपीआई के टीवी वर्शन का इस्तेमाल करें.

तकनीकी तौर पर, Compose Material के मोबाइल वर्शन का इस्तेमाल किया जा सकता है. हालांकि, इसे Android TV पर इंटरैक्शन की यूनीक स्टाइल के लिए ऑप्टिमाइज़ नहीं किया गया है. इसके अलावा, Compose for TV के Compose Material के साथ Compose Material को मिक्स करने से, अनचाहा बर्ताव हो सकता है. उदाहरण के लिए, हर लाइब्रेरी का अपना MaterialTheme ऑब्जेक्ट होता है. इसलिए, दोनों वर्शन का इस्तेमाल करने पर, रंग, टाइपोग्राफ़ी या शेप में अंतर हो सकता है.

यहां दी गई टेबल में, टीवी और मोबाइल के बीच निर्भरता से जुड़े अंतर के बारे में बताया गया है:

अन्य संसाधन

• टीवी के लिए डिज़ाइन गाइड
  उपयोगकर्ताओं के लिए इंटरफ़ेस बनाने के लिए, टीवी के खास कॉम्पोनेंट के बारे में खास जानकारी. साथ ही, डेवलपर के लिए काम के संसाधनों के लिंक.

• टीवी के लिए उपलब्ध कॉन्टेंट के कैटलॉग का सैंपल
  यह एक कैटलॉग ऐप्लिकेशन है. इसमें बताया गया है कि Compose for TV का इस्तेमाल करके, Material Design के सिद्धांतों को कैसे लागू किया जाता है.

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

• Compose for TV के बारे में जानकारी
  इस कोडलैब में, कैटलॉग ब्राउज़र स्क्रीन और जानकारी वाली स्क्रीन के साथ वीडियो प्लेयर ऐप्लिकेशन बनाने का तरीका बताया गया है.

इसके बारे में और पढ़ें

टीवी के लिए ऑप्टिमाइज़ किए गए शानदार अनुभव बनाने के बारे में जानने के लिए, इन गाइड को पढ़ें:

• कैटलॉग ब्राउज़ करने वाली स्क्रीन
• जानकारी वाली स्क्रीन