Leanback UI 工具包程式庫

使用 Compose 建構更優質的內容

使用 Jetpack Compose for Android TV OS 以最少的程式碼建立精美的 UI。

Compose for TV →

Leanback UI 工具包提供部分電視專用的程式庫，專供為 Android TV OS 開發的應用程式使用。這些程式庫包含下列項目：

• Leanback 程式庫：提供 UI 範本，可簡化 Android TV 應用程式的建立程序。
• Leanback Preferences 程式庫：提供與平台一致的偏好設定和設定畫面，但可以根據應用程式的主題設定主題。
• Leanback Paging 程式庫：支援 ObjectAdapters 的 AndroidX 分頁模型，這種模型經常與 Leanback 範本搭配使用。
• Leanback 分頁程式庫：支援 Android TV 上的分頁瀏覽功能。

Leanback 分頁程式庫

Leanback UI 工具包中的分頁功能與 AndroidX Paging 3 程式庫相同，可以簡化將分頁新增至 RecyclerView.Adapter 的程序。使用 Leanback Paging 程式庫時，公開的轉接程式通常是 ObjectAdapter，因此程式庫會為 ObjectAdapter 新增分頁支援。

如要在應用程式中新增分頁轉接程式，請先將程式庫依附元件新增至專案：

implementation "androidx.leanback:leanback-paging:$version"

然後按照 Paging 3 說明文件中的 androidx.leanback.paging.PagingDataAdapter 取代 androidx.paging.PagingDataAdapter。唯一的差別在於，您現在可以傳入 Presenter 或 PresenterSelector。這適用於一般使用 ObjectAdapter 的任何位置，例如 ListRow 中：

val adapter: PagingDataAdapter<MyItem> = PagingDataAdapter(myPresenter,
   object : DiffUtil.ItemCallback<MyItem>() {
       override fun areItemsTheSame(
           oldItem: MyItem,
           newItem: MyItem
       ): Boolean {
           return oldItem.id === newItem.id
       }

       override fun areContentsTheSame(
           oldItem: MyItem,
           newItem: MyItem
       ): Boolean {
           return oldItem == newItem
       }
   })

val header = HeaderItem(headerTitle)
val row = ListRow(header, adapter)

PagingDataAdapter<MyItem> adapter = new PagingDataAdapter(myPresenter, new DiffUtil.ItemCallback<MyItem>() {
    @Override
    public boolean areItemsTheSame(@NonNull MyItem oldItem, @NonNull MyItem newItem) {
        return oldItem.getId().equals(newItem.getId());
    }

    @Override
    public boolean areContentsTheSame(@NonNull MyItem oldItem, @NonNull MyItem newItem) {
        return oldItem.equals(newItem);
    }
});

HeaderItem header = new HeaderItem(headerTitle);
Row row = new ListRow(header, adapter);

Leanback 分頁媒體庫

Leanback UI 工具包範本可以在瀏覽畫面中提供側邊導覽功能。如要在應用程式頂端水平新增一列分頁，您可以改用 Leanback 分頁。

在專案中新增程式庫依附元件：

implementation "androidx.leanback:leanback-tab:$version"

然後按照現有的 ViewPager 指南，使用 LeanbackTabLayout 和 LeanbackViewPager 實作分頁。請注意，LeanbackViewPager 是以 ViewPager 為基礎，而非 ViewPager2。

範例如下：

val leanbackTabLayout = findViewById<LeanbackTabLayout>(R.id.tab_layout)
val leanbackViewPager = findViewById<LeanbackViewPager>(R.id.view_pager)

leanbackViewPager.setAdapter(adapter)
leanbackTabLayout.setupWithViewPager(leanbackViewPager)

LeanbackTabLayout leanbackTabLayout = findViewById(R.id.tab_layout);
LeanbackViewPager leanbackViewPager = findViewById(R.id.view_pager);

leanbackViewPager.setAdapter(adapter);
leanbackTabLayout.setupWithViewPager(leanbackViewPager);

限制

Leanback 分頁程式庫在支援的主題和焦點移動的處理方式上有所限制。

支援的主題

系統僅支援衍生自 Theme.AppCompat 的主題。TabLayout 含有強制執行主題的限制，可防止使用 Theme.AppCompat 的任何非子系主題。您也可以使用 Leanback UI 工具包的橋接主題。

焦點從分頁移至頂端

如果版面配置高度大於螢幕高度，而您按下 D-Pad 向上按鈕，控制項會返回分頁，而不會停留在片段內並前往上方的項目 (如圖 1 所示)。如要處理這個問題，片段中的內容必須覆寫聚焦搜尋；例如，使用 RowsSupportFragment。BrowseSupportFragment 有覆寫的焦點搜尋方法，導致焦點無法移回分頁，因此無法在分頁中使用。