สร้างเบราว์เซอร์แคตตาล็อก

แอปสื่อที่ทำงานบนทีวีต้องอนุญาตให้ผู้ใช้เรียกดูข้อเสนอเนื้อหา เลือกเนื้อหา และเริ่มเล่นเนื้อหาได้ ประสบการณ์การเรียกดูเนื้อหาของแอปประเภทนี้ควรใช้งานง่าย มีภาพที่สวยงามและน่าสนใจ

โดยทั่วไปเบราว์เซอร์แคตตาล็อกจะมีหลายส่วน และแต่ละส่วนจะมีรายการเนื้อหาสื่อ ตัวอย่างส่วนต่างๆ ในแคตตาล็อกสื่อ ได้แก่ เพลย์ลิสต์ เนื้อหาที่โดดเด่น หมวดหมู่ที่แนะนำ

รูปที่ 1 หน้าจอแคตตาล็อกทั่วไป ผู้ใช้สามารถเรียกดูข้อมูลแคตตาล็อกวิดีโอได้

ใช้ฟังก์ชันที่ Compose สำหรับ TV มีให้เพื่อสร้างอินเทอร์เฟซผู้ใช้สำหรับการเรียกดูเพลงหรือวิดีโอจากแคตตาล็อกสื่อของแอป

สร้างฟังก์ชันที่ประกอบกันได้สำหรับแคตตาล็อก

ทุกอย่างที่ปรากฏบนจอแสดงผลจะได้รับการติดตั้งใช้งานเป็นฟังก์ชันที่ประกอบกันได้ใน Compose สำหรับ TV เริ่มต้นด้วยการกำหนดฟังก์ชันที่คอมโพสได้สำหรับเบราว์เซอร์แคตตาล็อกสื่อ ดังนี้

@Composable
fun CatalogBrowser(
    featuredContentList: List<Movie>,
    sectionList: List<Section>,
    modifier: Modifier = Modifier,
    onItemSelected: (Movie) -> Unit = {},
) {
    // ToDo: add implementation
}

CatalogBrowser คือฟังก์ชันที่ประกอบกันได้ซึ่งติดตั้งใช้งานเบราว์เซอร์แคตตาล็อกสื่อ ฟังก์ชันนี้ใช้การโต้แย้งต่อไปนี้

  • รายการเนื้อหาที่โดดเด่น
  • รายการส่วน
  • ออบเจ็กต์ Modifier
  • ฟังก์ชัน Callback ซึ่งทริกเกอร์การเปลี่ยนหน้าจอ

ตั้งค่าองค์ประกอบ UI

Compose สำหรับ TV มี Lazy List ซึ่งเป็นคอมโพเนนต์สำหรับแสดงรายการจำนวนมาก (หรือรายการที่มีความยาวไม่ทราบ) เรียก LazyColumn เพื่อวางส่วนต่างๆ ในแนวตั้ง LazyColumn มี LazyListScope.() -> Unit บล็อก ซึ่งมี DSL สำหรับกำหนดเนื้อหารายการ ในตัวอย่างต่อไปนี้ แต่ละส่วนจะอยู่ในรายการแนวตั้งโดยมีช่องว่าง 16 dp ระหว่างส่วนต่างๆ

@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 โดยการเรียก DSL ที่ให้ไว้

@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 ข้อความและคอมโพเนนต์อื่นๆ ที่กำหนดไว้ใน Material Design มีให้ใช้งานในไลบรารี tv-material คุณสามารถ เปลี่ยนสไตล์ของข้อความตามที่กำหนดไว้ใน Material Design ได้โดยอ้างอิงออบเจ็กต์ 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 จะแสดงข้อมูลในชุดรายการที่เลื่อน เฟด หรือย้ายเข้าสู่มุมมองได้ คุณใช้คอมโพเนนต์นี้เพื่อไฮไลต์เนื้อหาที่โดดเด่น เช่น ภาพยนตร์ที่เพิ่งเปิดตัวหรือตอนใหม่ของรายการทีวี

Carousel ต้องการให้คุณระบุจำนวนรายการที่ Carousel มีและวิธีวาดแต่ละรายการเป็นอย่างน้อย โดยคุณระบุจำนวนรายการแรกได้ด้วย itemCount ส่วนรายการที่ 2 สามารถส่งผ่านเป็นแลมบ์ดาได้ ระบบจะส่งหมายเลขดัชนีของรายการที่แสดงไปยังแลมบ์ดา คุณสามารถกำหนดรายการที่แสดงด้วยค่าดัชนีที่กำหนดได้ดังนี้

Carousel สามารถเป็นรายการของ Lazy List เช่น TvLazyColumn ข้อมูลโค้ดต่อไปนี้แสดง FeaturedCarousel ที่คอมโพสได้ที่ด้านบนของ SectionRow ที่คอมโพสได้ทั้งหมด