टीवी पर चलने वाले मीडिया ऐप्लिकेशन में, उपयोगकर्ताओं को कॉन्टेंट ब्राउज़ करने, उसे चुनने, और चलाने की सुविधा मिलनी चाहिए. इस तरह के ऐप्लिकेशन में कॉन्टेंट ब्राउज़ करने का अनुभव आसान, विज़ुअल तौर पर आकर्षक, और दिलचस्प होना चाहिए.
कैटलॉग ब्राउज़र में कई सेक्शन होते हैं. हर सेक्शन में मीडिया कॉन्टेंट की एक सूची होती है. मीडिया कैटलॉग में मौजूद सेक्शन के उदाहरणों में ये शामिल हैं: प्लेलिस्ट, चुनिंदा कॉन्टेंट, सुझाई गई कैटगरी.
Compose for TV में उपलब्ध फ़ंक्शन का इस्तेमाल करके, ऐसा यूज़र इंटरफ़ेस बनाएं जिससे उपयोगकर्ता आपके ऐप्लिकेशन के मीडिया कैटलॉग से संगीत या वीडियो ब्राउज़ कर सकें.
कैटलॉग के लिए, ऐप्लिकेशन बनाने की सुविधा बनाना
डिसप्ले पर दिखने वाली हर चीज़ को Compose for TV में, ऐप्लिकेशन बनाने की सुविधा के तौर पर लागू किया जाता है. मीडिया कैटलॉग ब्राउज़र के लिए, ऐप्लिकेशन बनाने की सुविधा को तय करके शुरुआत करें:
@Composable fun CatalogBrowser( featuredContentList: List<Movie>, sectionList: List<Section>, modifier: Modifier = Modifier, onItemSelected: (Movie) -> Unit = {}, ) { // ToDo: add implementation }
CatalogBrowser, ऐप्लिकेशन बनाने की सुविधा है. इससे मीडिया कैटलॉग ब्राउज़र को लागू किया जाता है. इस फ़ंक्शन में ये आर्ग्युमेंट इस्तेमाल किए जाते हैं:
- चुनिंदा कॉन्टेंट की सूची.
- सेक्शन की सूची.
- यह एक Modifier ऑब्जेक्ट है.
- एक कॉलबैक फ़ंक्शन, जो स्क्रीन ट्रांज़िशन को ट्रिगर करता है.
यूज़र इंटरफ़ेस (यूआई) एलिमेंट सेट करना
Compose for TV में लेज़ी लिस्ट की सुविधा मिलती है. यह एक कॉम्पोनेंट है, जो बड़ी संख्या में आइटम या ऐसी सूची दिखाता है जिसकी लंबाई के बारे में जानकारी नहीं होती. सेक्शन को वर्टिकल तौर पर रखने के लिए,
LazyColumn
को कॉल करें. LazyColumn, LazyListScope.() -> Unit ब्लॉक उपलब्ध कराता है. यह आइटम के कॉन्टेंट को तय करने के लिए, डीएसएल उपलब्ध कराता है. यहां दिए गए उदाहरण में, हर सेक्शन को वर्टिकल सूची में रखा गया है. साथ ही, सेक्शन के बीच 16 डीपी का गैप है:
@Composable fun CatalogBrowser( featuredContentList: List<Movie>, sectionList: List<Section>, modifier: Modifier = Modifier, onItemSelected: (Movie) -> Unit = {}, ) { LazyColumn( modifier = modifier.fillMaxSize(), verticalArrangement = Arrangement.spacedBy(16.dp) ) { items(sectionList.size) { index -> val section = sectionList[index] SectionRow(section, onItemSelected = onItemSelected) } } }
उदाहरण में, SectionRow ऐप्लिकेशन बनाने की सुविधा से यह तय होता है कि सेक्शन कैसे दिखेंगे.
यहां दिए गए फ़ंक्शन में, LazyRow से पता चलता है कि LazyColumn के इस हॉरिज़ॉन्टल वर्शन का इस्तेमाल, हॉरिज़ॉन्टल सूची को तय करने के लिए कैसे किया जाता है. इसके लिए, दिए गए डीएसएल को कॉल करके LazyListScope.() -> Unit ब्लॉक का इस्तेमाल किया जाता है:
@Composable fun SectionRow( section: Section, modifier: Modifier = Modifier, onItemSelected: (Movie) -> Unit = {}, ) { Text( text = section.title, style = MaterialTheme.typography.headlineSmall, ) MovieCatalog( section.movieList, onClick = { movie -> onItemSelected(movie) }, modifier ) }
@Composable fun MovieCatalog( movies: List<Movie>, onClick: (Movie) -> Unit, modifier: Modifier = Modifier, ) { LazyRow( modifier = modifier, horizontalArrangement = Arrangement.spacedBy(8.dp) ) { items(movies.size) { index -> val movie = movies[index] MovieCard( movie = movie, onClick = { onClick(movie) } ) } } }
SectionRow कंपोज़ेबल में, Text कॉम्पोनेंट का इस्तेमाल किया जाता है.
मटीरियल डिज़ाइन में तय किए गए टेक्स्ट और अन्य कॉम्पोनेंट, tv-material लाइब्रेरी में उपलब्ध हैं . MaterialTheme ऑब्जेक्ट का रेफ़रंस देकर, मटीरियल डिज़ाइन में बताए गए तरीके से टेक्स्ट की स्टाइल बदली जा सकती है.
यह ऑब्जेक्ट, tv-material लाइब्रेरी से भी मिलता है.
Card, tv-material लाइब्रेरी का हिस्सा है.
MovieCard से यह तय होता है कि कैटलॉग में हर फ़िल्म का डेटा कैसे रेंडर किया जाएगा. इसे इस स्निपेट के तौर पर दिखाया जाता है:
@OptIn(ExperimentalMaterial3Api::class) @Composable fun MovieCard( movie: Movie, modifier: Modifier = Modifier, onClick: () -> Unit = {} ) { Card( modifier = modifier, onClick = onClick ) { AsyncImage( model = movie.thumbnailUrl, contentDescription = movie.title, ) } }
चुनिंदा कॉन्टेंट को हाइलाइट करना
पहले बताए गए उदाहरण में, सभी फ़िल्में एक ही तरह से दिखाई गई हैं.
दोनों का साइज़ एक जैसा है और दोनों में कोई विज़ुअल अंतर नहीं है.
Carousel की मदद से, कुछ समीक्षाओं को हाइलाइट किया जा सकता है.
कैरसेल, जानकारी को आइटम के ऐसे सेट में दिखाता है जो स्लाइड हो सकते हैं, फ़ेड हो सकते हैं या व्यू में मूव हो सकते हैं. आप इस कॉम्पोनेंट का इस्तेमाल, चुनिंदा कॉन्टेंट को हाइलाइट करने के लिए करते हैं. जैसे, हाल ही में उपलब्ध हुई फ़िल्में या टीवी प्रोग्राम के नए एपिसोड.
Carousel
को कम से कम यह बताना ज़रूरी है कि कैरसेल में कितने आइटम हैं और हर आइटम को कैसे ड्रॉ करना है. पहले विकल्प को itemCount के साथ तय किया जा सकता है. दूसरे को लैम्ब्डा के तौर पर
पास किया जा सकता है. दिखाए गए आइटम का इंडेक्स नंबर, लैम्ब्डा को दिया जाता है. दी गई इंडेक्स वैल्यू की मदद से, यह तय किया जा सकता है कि कौनसा आइटम दिखाया जाए:
@OptIn(ExperimentalTvMaterial3Api::class) @Composable fun FeaturedCarousel( featuredContentList: List<Movie>, modifier: Modifier = Modifier, ) { Carousel( itemCount = featuredContentList.size, modifier = modifier, ) { index -> val content = featuredContentList[index] Box { AsyncImage( model = content.backgroundImageUrl, contentDescription = content.description, placeholder = painterResource( id = R.drawable.movie_placeholder ), contentScale = ContentScale.Crop, modifier = Modifier.fillMaxSize() ) Text(text = content.title) } } }
Carousel, लेज़ी लिस्ट का कोई आइटम हो सकता है, जैसे कि LazyColumn.
यहां दिए गए स्निपेट में, सभी SectionRow कंपोज़ेबल के ऊपर FeaturedCarousel कंपोज़ेबल दिखाया गया है:
@OptIn(ExperimentalTvMaterial3Api::class) @Composable fun CatalogBrowser( featuredContentList: List<Movie>, sectionList: List<Section>, modifier: Modifier = Modifier, onItemSelected: (Movie) -> Unit = {}, ) { LazyColumn( modifier = modifier.fillMaxSize(), verticalArrangement = Arrangement.spacedBy(16.dp) ) { item { FeaturedCarousel(featuredContentList) } items(sectionList) { section -> SectionRow(section, onItemSelected = onItemSelected) } } }