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 के डेवलपमेंट के कई सिद्धांत, टीवी पर भी लागू होते हैं. डिक्लेरेटिव यूज़र इंटरफ़ेस फ़्रेमवर्क के सामान्य फ़ायदों के बारे में ज़्यादा जानने के लिए, Why 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 लाइब्रेरी और 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:2026.03.00")
   implementation(composeBom)

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

   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:2026.03.00')
   implementation composeBom

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

   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 Material को Compose for TV के Compose Material के साथ मिलाने पर, अनचाहा व्यवहार देखने को मिल सकता है. उदाहरण के लिए, हर लाइब्रेरी का अपना MaterialTheme ऑब्जेक्ट होता है. इसलिए, अगर दोनों वर्शन का इस्तेमाल किया जाता है, तो हो सकता है कि रंग, टाइपोग्राफ़ी या आकार में अंतर दिखे.

यहां दी गई टेबल में, टीवी और मोबाइल के लिए डिपेंडेंसी के बीच के अंतर को दिखाया गया है:

अन्य संसाधन

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

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

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

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

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

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

• कैटलॉग ब्राउज़र बनाना
• जानकारी दिखाने वाली स्क्रीन बनाना
• स्क्रोल किए जा सकने वाले लेआउट बनाना