電視

  
為開發人員提供 Compose 和質感設計功能,以編寫用於電視的應用程式
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2024 年 5 月 1 日 - - 1.0.0-beta01 -

宣告依附元件

如要為 tv-foundation 和 tv-material 新增依附元件,您必須將 Google Maven 存放區新增至您的專案。詳情請參閱 Google 的 Maven 存放區

在應用程式或模組的 build.gradle 檔案中,新增所需構件的依附元件:

Groovy

dependencies {
    implementation "androidx.tv:tv-foundation:1.0.0-alpha10"
    implementation "androidx.tv:tv-material:1.0.0-beta01"
}

Kotlin

dependencies {
    implementation("androidx.tv:tv-foundation:1.0.0-alpha10")
    implementation("androidx.tv:tv-material:1.0.0-beta01")
}

如要進一步瞭解依附元件,請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題,或是有改進這個程式庫的建議,請告訴我們。回報新問題前,請先查看這個程式庫的現有問題。只要按一下星號按鈕,即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 文件

這個構件沒有任何版本資訊。

Tv-Material 1.0 版

1.0.0-beta01 版本

2024 年 5 月 1 日

發布 androidx.tv:tv-material:1.0.0-beta01。1.0.0-beta01 版包含這些修訂版本

API 變更

  • ColorScheme 及其公用函式現已穩定。(If34fa)。
  • LocalContentColor 現在是穩定版 (I60ee2)
  • Typography API 現在是穩定版 (I088d6)
  • Shapes API 現在是穩定版 (I0f5f4)
  • Border API 現在是穩定版 (I69281)
  • Glow API 現在是穩定版 (Iea5f1)
  • 圖示元件現在是穩定版 (I62c2d)
  • LocalTextStyles API 現在是穩定版 (Iaded8)
  • MaterialTheme API 現在是穩定版 (I2f541)
  • Text 元件現已穩定 (Ib9e31)
  • RadioButton 元件現在是穩定版 (Ia03c8)
  • 切換元件現在是穩定版 (I6cea3)
  • Checkbox 元件現在是穩定版 (I7eafc)
  • 表面元件現已穩定 (I58758I04aca)
  • 已將 NonInteractiveSurfaceDefaults 重新命名為 SurfaceDefaults,並將 NonInteractiveSurfaceColors 重新命名為 SurfaceColors (I0812e)
  • 可選 Surface 現在使用「select」一詞,而不是「check」,因為兩者都有不同的語意含義 (I5a206)
  • NavigationDrawerNavigationDrawerScope 現已穩定 (I249c1)
  • NavigationDrawerItem 元件現在是穩定版 (Id6986)
  • 分頁和 TabRow 元件現已穩定 (I92d92)
  • ButtonOutlinedButtonIconButtonOutlinedIconButtonWideButton 元件現已穩定 (Ib4de8)
  • CardClassicCardCompactCardWideClassicCardStandardCardContainerWideCardContainer 元件現在是穩定版 (I34390)
  • 已將 StandardCardLayout 重新命名為 StandardCardContainer,並將 WideCardLayout 重新命名為 WideCardContainer (I08883)
  • 移除 CardContainerDefaults.ImageCard,並將 CardDefaults.ContainerGradient 重新命名為 CardDefaults.ScrimBrush (I6adfe)。您可以在卡片容器中使用 Card 取代 CardContainerDefaults.ImageCard
  • ListItemDenseListItem 現已穩定 (Idebd9)
  • ListItemDefaults.ListItemShapeListItemDefaults.FocusedDisabledBorderListItemDefaults.SelectedContainerColorOpacity 現已設為私人 (I5d533)
  • 重新排列 ListItem 的參數,並將 ListItemDefaults.ListItemElevation 重新命名為 ListItemDefaults.TonalElevation (Id6841)。headlineContent 參數已移至可組合項頂端。之前,您可以使用 Kotlin 的結尾 lambda 語法傳遞 headlineContent。現在,您必須使用具名參數語法來提供 headlineContent
  • LocalAbsoluteTonalElevation 現在為內部內部 (Ibfc65)
  • 已移除 ImmersiveList 元件。請查看此範例,瞭解如何自行建構。(Id48da)。
  • 在 API 中公開 MutableInteractionSource 的 tv-material 元件已更新,現在可公開預設為空值的可為空值 MutableInteractionSource。這裡沒有語意變更:傳遞空值表示您不想提升 MutableInteractionSource,且會視需要在元件內建立。變更為空值可讓部分元件永遠不會分配 MutableInteractionSource,也可讓其他元件只在需要時延遲建立執行個體,進而提高這些元件的效能。如果您不是使用傳遞至這些元件的 MutableInteractionSource,建議改為傳遞空值。此外,建議您在元件中做出類似的變更。(I309b4b/298048146)
  • 電視文字元件的 TextAlign 參數現在不是空值 (Ib73b1b/299490814)
  • 針對 ParagraphTextStyleTextAlignTextDirectionHyphensLineBreak 欄位加入特殊未指定值 (I4197eb/299490814)

1.0.0 版本

1.0.0-alpha10 版本

2023 年 10 月 4 日

發布 androidx.tv:tv-foundation:1.0.0-alpha10androidx.tv:tv-material:1.0.0-alpha10查看 1.0.0-alpha10 版的修訂項

新功能

  • 推出 NavigationDrawerItem,以便在 NavigationDrawerModalNavigationDrawer 中使用。(I4b491)。
  • 將基準設定檔新增至 tv-foundation 程式庫。(2b57fd7)。
  • 將基準設定檔新增至 tv-material 程式庫。(1711ff5)。

API 變更

  • NavigationDrawerScope.doesTabRowHaveFocus 已重新命名為 NavigationDrawerScope.hasFocus。(I8286b)。
  • TabRowScope.isActivated 已重新命名為 TabRowScope.hasFocus。(Ic4273)。

修正錯誤

  • 修正輪轉介面與使用焦點還原工具 API 的相鄰項目之間的相容性。(7b2a7a4)。
  • 停用 API_LEVEL 低於 28 的光暈指標,因為 OS 不支援此功能。(6d3616f)。
  • 修正快速反向捲動時,延遲容器中的項目放置不當導致的 ANR 當機問題。(642d65c)。
  • 移除 Modal Navigation Drawer 的背景邊框間距。(69965b2)。
  • 修正 Navigation Drawer 中的 Scrim,在背景內容上方 (而非後方) 繪製。(d4bbefb)。

1.0.0-alpha09 版本

2023 年 9 月 6 日

發布 androidx.tv:tv-foundation:1.0.0-alpha09androidx.tv:tv-material:1.0.0-alpha091.0.0-alpha09 版包含此連結所列的修訂項目。

API 變更

  • 新增 ReusableComposition 介面,用於管理生命週期及重複使用子組合。(I812d1b/252846775)
  • 將 tv-foundation Fork 與 Compose-foundation 同步處理。(I737c3b/287011882)
  • 新增了 LazyLayout 的超載,因此接受 LazyLayoutItemProvider 的 lambda,而非像之前的純物件。先前的超載已淘汰,(I42a5a)。
  • 新增 TvKeyboardAlignment,可讓開發人員透過 AndroidImeOptions 設定螢幕小鍵盤位置。(Idb772)。
  • 新增 rememberCarouselState 以在 TV Compose Material 中利用 Saver 記住 CarouselState。(Id7275)。
  • scrimColor: Color 參數變更為 scrimBrush:Brush 參數,讓使用者可在紗罩上加入漸層。(I254d4)。

1.0.0-alpha08 版

2023 年 7 月 26 日

發布 androidx.tv:tv-foundation:1.0.0-alpha08androidx.tv:tv-material:1.0.0-alpha081.0.0-alpha08 版包含此連結所列的修訂項目。

新功能

  • 推出 Compose for TV 教材的方塊元件。(I86da4)。
  • ListItem 元件新增至 TV Compose Material。(I3f0b3)。
  • DenseListItem 元件新增至 TV Compose Material。(I536bf)。

API 變更

  • 將 public tv-material API 標示為實驗性 API。(I632e7)。
  • 推出 TabRowScope,以便透過 Tab 可組合項和重新命名 TabColors 屬性分享 TabRow 可組合項的狀態。(Ief587)。

1.0.0-alpha07 版

2023 年 6 月 7 日

發布 androidx.tv:tv-foundation:1.0.0-alpha07androidx.tv:tv-material:1.0.0-alpha071.0.0-alpha07 版包含此連結所列的修訂項目。

API 變更

  • 元件的縮放指標現在包含 None 以停用縮放功能。(I50df5)。
  • 新增對 TV Material Surface、資訊卡和按鈕的長按支援。(Id2b89)。
  • 已移除 CarouselItemCarouselScope。使用 AnimatedContentScopeModifier.animateEnterExit 可在投影片中完成前景內容動畫。(Ic038e)。
  • 已將 colorcontentColor 參數合併為 TV Material Surface 的 colors。(Ie69eb)。
  • 在 TV Material 中推出 RadioButton 可組合項。(I08690)。
  • 在 TV Material 中推出 Switch 可組合項。(I45e29)。
  • 在 TV Material 中推出 Checkbox 可組合項。(I6a45a)。
  • 在 TV Material 中引入不可互動的介面。(Ic5f85)。
  • 表明內部標示。(Ibff82)。

1.0.0-alpha06 版

2023 年 4 月 19 日

發布 androidx.tv:tv-foundation:1.0.0-alpha06androidx.tv:tv-material:1.0.0-alpha061.0.0-alpha06 版包含此連結所列的修訂項目。

新功能

  • 新增針對電視最佳化的 Material 3 資訊卡實作。
    • 基本資訊卡 (I5b701)
    • ClassicCardCompactCardWideClassicCard (I70471)
    • StandardCardLayoutWideCardLayout (I33fae)
  • 新增針對電視最佳化的 Material 3 按鈕實作。

API 變更

  • Carousel 中的 CarouselSlideslideCount 已重新命名為 CarouselItemitemCount。(Ie554c)。
  • forwardbackward ContentTransforms 已重新命名為 StartToEndEndToStart。(Ie554c)。

修正錯誤

  • 當聚焦於 NavigationDrawer 時,處理返回方向鍵按鈕。(d654f4)。

1.0.0-alpha05 版

2023 年 3 月 22 日

發布 androidx.tv:tv-foundation:1.0.0-alpha05androidx.tv:tv-material:1.0.0-alpha051.0.0-alpha05 版包含此連結所列的修訂項目。

API 變更

  • tv-material 中推出側邊 Navigation Drawer 可組合項。如要瞭解如何使用這個可組合項,請參閱範例。(I12c08)。
  • 在 TV Material 3 中導入圖示可組合項 (I72db9)
  • 透過「邊框」、「光暈」和「比例」等指示,在 tv-material 上推出 Surface 可組合項,可用來建構明顯醒目顯示電視螢幕上焦點元素的元件。(I4a6d8)、(Iceea1)、(Iee4d4)、(I79edf)、(Icb376)
  • CarouselItem 更新為 CarouselSlide,以符合「Carousel API」中的 slideCount 參數名稱 (Ic4299)

1.0.0-alpha04 版

2023 年 2 月 8 日

發布 androidx.tv:tv-foundation:1.0.0-alpha04androidx.tv:tv-material:1.0.0-alpha041.0.0-alpha04 版包含此連結所列的修訂項目。

新功能

  • 可以視需要覆寫 Lazy 列、欄和格線中的樞紐,確保整個項目呈現在檢視畫面中。(11d7e40)。
  • 支援自訂分頁在各種狀態下的顏色。(21b2925)。
  • 輪轉介面支援設定手動前後捲動的自訂動畫。(431494a)。

API 變更

  • androidx.tv.material 重新命名為 androidx.tv.material3,並簡化 androidx.tv.material3 底下的套件結構。(I6ca52)。
  • 輪轉介面指標列中的指標已成為開發人員可以自訂的運算單元。(268af2a)。
  • focusableItem 已重新命名為 immersiveListItem。使用者將必須手動新增 focusable()clickable() 修飾符和 immersiveListItem (5dd5078)(b/263061052)
  • 輪轉介面元件中的 timeToDisplayMillis 已重新命名為 autoScrollDurationMillis。(431494a)。
  • CarouselItem 只能在 Carousel 中使用。(431494a)。
  • 輪轉介面接受 ContentTransforms 做為動畫定義,不接受 EnterTransitionExitTransitions。(431494a)。
  • 透過本機組合導入可由 Lazy 清單提供的 PinnableContainer API,藉此固定目前項目。(Ib8881b/259274257b/195049010)
  • TvLazyListLayoutInfoTvLazyGridLayoutInfo 中新增 mainAxisItemSpacing 屬性 (I37765)

修正錯誤

  • 更新分頁標籤列,確保能正確處理分頁標籤數為 0 或 1 的情況。(I440091c01525b/264018028)
  • 修正當 TvLazyColumn 含有空白 TvLazyRow 時會導致焦點搜尋異常終止的問題。(e11b4feb/260299091)
  • clickable 修飾符可與 ImmersiveList 搭配使用。(5dd5078b/263061052)
  • 支援處理返回鍵操作,可使用返回鍵退出精選輪轉介面。(84c138c)。
  • 輪轉介面不會因為快速多次按下按鍵而失去焦點。(799489f)。
  • 輪轉介面不會因為長按按鍵而失去焦點。(b2cf37e)。
  • 修正當輪轉介面滑動次數變更時發生的當機問題。(b261247)。

1.0.0-alpha03 版本

2022 年 12 月 7 日

發布 androidx.tv:tv-foundation:1.0.0-alpha03androidx.tv:tv-material:1.0.0-alpha031.0.0-alpha03 版包含此連結所列的修訂項目

新功能

  • TabRow 現已做為實驗性 API 提供,可讓使用者將上方導覽列新增至其應用程式。一般來說,當分頁列聚焦在分頁標題時,電視裝置會載入分頁。
  • 並未直接提供如底線指標和藥丸形狀指標等電視特定指標。您可以在 tv-samples 中找到使用範例

1.0.0-alpha02 版

2022 年 11 月 9 日

發布 androidx.tv:tv-foundation:1.0.0-alpha02androidx.tv:tv-material:1.0.0-alpha021.0.0-alpha02 版包含此連結所列的修訂項目。

修正錯誤

  • 縮減聚焦搜尋空間,藉此改善捲動一組 TvLazyRows/TvLazyColumns 時的捲動效能。(I723a3)

1.0.0-alpha01 版

2022 年 10 月 5 日

發布 androidx.tv:tv-foundation:1.0.0-alpha01androidx.tv:tv-material:1.0.0-alpha011.0.0-alpha01 版包含此連結所列的修訂項目。

新功能

第一個 Alpha 版包含下列早期預先發布版的元件實作,適用於電視用途:

  • 新增修飾符 scrollableWithPivot,允許非延遲捲動容器 (例如 Row、Column、Grid) 透過捲動容器來捲動內容,讓焦點項目在電視畫面上的位置保持不變。
  • 新增可組合項 TvLazyRowTvLazyColumnTvLazyHorizontalGridTvLazyVerticalGrid,以利透過捲動容器來捲動內容,讓已選取項目保持在電視螢幕的相同位置。
  • 為電視新增「精選輪轉介面」可組合項目,以便使用者建立自動捲動的橫幅輪轉介面。
  • 為電視新增「沉浸式清單」可組合項目,以便使用者建立沉浸式列/欄/格狀清單,並根據已選取清單項目變更背景。

已知問題

  • 根據預設,當捲動容器取得焦點時,第一個元素不會取得焦點。
  • 聚焦於 TextField 時,不一定會開啟鍵盤,也可能導致焦點無法移至其他欄位。
  • 如果在包含 LazyRowsLazyColumn 中垂直捲動,則捲動效能不佳。