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
中:
Kotlin
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)
Java
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
。
範例如下:
Kotlin
val leanbackTabLayout = findViewById<LeanbackTabLayout>(R.id.tab_layout) val leanbackViewPager = findViewById<LeanbackViewPager>(R.id.view_pager) leanbackViewPager.setAdapter(adapter) leanbackTabLayout.setupWithViewPager(leanbackViewPager)
Java
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
有覆寫的焦點搜尋方法,導致焦點無法移回分頁,因此無法在分頁中使用。