在 Android TV 上使用 Jetpack Compose

Compose for TV 是建構 Android TV 的新型方法 存取 APICompose for TV 發揮 Android Jetpack Compose 的一切優勢， 為 TV 應用程式打造美觀且實用的 UI 讓您更容易

使用 Compose for TV 的一些特定優點包括：

• 靈活彈性：Compose 可用來建立任何類型的 UI，只需簡單 將版面配置轉換成複雜的動畫元件可立即使用 根據應用程式需求自訂及調整樣式。
• 簡化與加速開發：Compose 與 還能幫助開發人員更有效率地建構應用程式 程式碼越少越好
• 直覺式：Compose 使用宣告式語法，方便您編寫程式碼 以及對 UI 進行的變更、偵錯、理解及檢查程式碼。

如果您對 Jetpack Compose 工具包的使用方式不太熟悉，請參閱 Compose 課程。多個 行動版 Compose 開發原則 也適用於 TV。詳情請參閱為什麼 Compose 有關宣告式 UI 架構一般優點的資訊。學習 另請參閱 Compose 的 GitHub 上的電視範例存放區。

相容性

Compose for TV 適用於搭載 Android 5.0 (API 級別 21) 以上版本的 Android TV。 使用 Compose for TV 1.0 版需要 1.3.0 版 androidx.compose 程式庫 以及 Kotlin 1.7.10

設定

在 Android TV 上使用 Jetpack Compose 與 Jetpack Compose 類似 和其他 Android 專案主要差別在於 Compose for TV 新增程式庫，提供針對電視最佳化的元件，讓使用者更易於製作 打造專屬於電視的使用者介面在某些情況下，這些元件會共用相同的元件 做為非電視管道的名稱，例如 androidx.tv.material3.Button敬上 和 androidx.compose.material3.Button。

Jetpack Compose 工具包依附元件

如要使用 Compose for TV，請納入 Jetpack Compose 工具包 應用程式 build.gradle 檔案中的依附元件如下：

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

   // General compose dependencies.
   implementation("androidx.activity:activity-compose:1.9.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-rc01")
}

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

   // General compose dependencies.
   implementation 'androidx.activity:activity-compose:1.9.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-rc01'
}

不同點

盡可能使用電視版的 API。 雖然就技術上來說，您也可以使用行動版 Compose Material， 並未針對 Android TV 獨特的互動方式進行最佳化於 此外，將 Compose Material 與 Compose Material 搭配使用 Compose for TV 可能會導致非預期的行為。例如： 每個程式庫都有專屬的 MaterialTheme 物件 如果同時使用兩種版本，顏色、字體排版和形狀不一致。

下表列出電視和 行動裝置：

其他資源

• 電視 Material Catalog 範例
  示範實作方式的目錄應用程式 使用 Compose for TV 的質感設計原則。

• JetStream 範例
  一種媒體串流應用程式，可示範如何將 TV Compose 與 典型的 Material Design 應用程式和實際架構

• Compose for TV 簡介
  本程式碼研究室將逐步說明如何使用目錄瀏覽器建構影片播放器應用程式 以及一個詳細資料畫面

其他資訊

歡迎瀏覽這些指南，瞭解如何為以下使用者打造優質的電視體驗：

• 目錄瀏覽畫面
• 詳細資料畫面