??Google 的 Leanback 有其固定的風(fēng)格，但國內(nèi)的UI往往不會按照 Leanback 的風(fēng)格進行設(shè)計筑舅，比如說上面的云視聽極光。這就導(dǎo)致 Android TV 的那些封裝好的 Fragment庄岖、Presenter 等控件我們基本上用不到豁翎，局限性很強，所以隅忿，如果想要既使用 Leanback 的放大效果心剥，又要同時按國內(nèi)的 UI 風(fēng)格做出國內(nèi)界面的樣子的話，只能使用適應(yīng)性較強的控件背桐，比如如 HorizontalGridView优烧、VerticalGridView。那就要求我們要盡可能的熟悉 HorizontalGridView链峭、VerticalGridView 這些控件的使用方式畦娄。
??下面就記錄一下 HorizontalGridView 相關(guān)的東西。
??HorizontalGridView 繼承自抽象類 BaseGridView弊仪，而 BaseGridView 又繼承自 RecyclerView熙卡，也就是說 HorizontalGridView 是 RecyclerView 的子類，對于 HorizontalGridView 來說励饵，RecyclerView 有的特性基本上也適用于 HorizontalGridView驳癌，也可以認(rèn)為 HorizontalGridView 就是針對 TV 再次封裝的 RecyclerView 。
??這次就對照下圖所示的云視聽極光的標(biāo)題欄來寫個 demo 役听，順便梳理一下 HorizontalGridView 的一些屬性和方法颓鲜。
1 基本使用
1.1 新建項目，添加依賴
??如果想要使用Leanback典予，首先要添加 如下所示的 Leanback 的依賴甜滨。
implementation 'com.android.support:leanback-v17:28.0.0'
1.2 修改 activity_main.xml
??在 activity_main.xml 中添加標(biāo)題欄的 HorizontalGridView。修改后如下所示瘤袖。
<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity"
android:background="#000000">
<android.support.v17.leanback.widget.HorizontalGridView
android:id="@+id/hg_title"
android:layout_width="wrap_content"
android:layout_height="50dp" />
</android.support.constraint.ConstraintLayout>
1.3 創(chuàng)建 Presenter
??Presenter 是 HorizontalGridView 用來綁定衣摩、展示子 Item 的類，類比著想的話捂敌，它就是和 RecyclerView 的 Adapter 起著一樣的作用的東西昭娩，它們都有 onCreateViewHolder、onBindViewHolder 這樣的方法黍匾，都有繼承自 ViewHolder 的靜態(tài)內(nèi)部類∏喊穑看看下面 TitlePresenter 這個類就會覺得十分熟悉锐涯。
??那就分析分析吧。
??一樣之處：它們都是在 onCreateViewHolder 里加載 item 的布局填物，在 onBindViewHolder 里綁定數(shù)據(jù)纹腌，在內(nèi)部類 ViewHolder 中接收由布局生成的子 View霎终，并加載子 View 中的控件。
??不一樣之處：不一樣的是 RecyclerView 的 Adapter 有 notifyDataSetChanged升薯、notifyItemChanged莱褒、notifyItemMoved、notifyItemRangeChanged 這樣的數(shù)據(jù)刷新的方法涎劈，而在 HorizontalGridView 中广凸，這些功能都抽出來了，它們都放到了 ObjectAdapter 這個抽象類及其子類中了蛛枚，這是 MVP 設(shè)計模式的寫法谅海，同時我覺得這也體現(xiàn)了單一職責(zé)的思想。
??這里還有一些不關(guān)鍵的類和 xml 沒貼出來蹦浦，有需要去文章末尾百度云下載項目看吧扭吁。
TitlePresenter.class
package isuperred.github.com.horizontalgeidviewdemo;
import android.support.v17.leanback.widget.Presenter;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.TextView;
public class TitlePresenter extends Presenter {
@Override
public ViewHolder onCreateViewHolder(ViewGroup viewGroup) {
View view = LayoutInflater.from(viewGroup.getContext()).inflate(R.layout.item_title, viewGroup, false);
return new ViewHolder(view);
}
@Override
public void onBindViewHolder(Presenter.ViewHolder viewHolder, Object o) {
if (o instanceof Title) {
ViewHolder vh = (ViewHolder) viewHolder;
vh.tvTitle.setText(((Title) o).getName());
}
}
@Override
public void onUnbindViewHolder(Presenter.ViewHolder viewHolder) {
}
static class ViewHolder extends Presenter.ViewHolder {
TextView tvTitle;
public ViewHolder(View view) {
super(view);
tvTitle = view.findViewById(R.id.tv_title);
}
}
}
1.4 初始化 HorizontalGridView 并為之綁定適配器、數(shù)據(jù)
??先通過 findViewById 獲取 HorizontalGridView 的對象盲镶，通過 setHorizontalSpacing 這個方法在 item 之間添加間距侥袜，ArrayObjectAdapter 用于數(shù)據(jù)的綁定、數(shù)據(jù)的刷新溉贿，ItemBridgeAdapter 也可以進行數(shù)據(jù)刷新枫吧，它是全部刷新一遍，比較重顽照，它更重要的是起一個橋梁的作用由蘑，將 ObjectAdapter、PresenterSelector代兵、Presenter聯(lián)系起來尼酿。
MainActivity.class
package isuperred.github.com.horizontalgeidviewdemo;
import android.os.Bundle;
import android.support.v17.leanback.widget.ArrayObjectAdapter;
import android.support.v17.leanback.widget.FocusHighlight;
import android.support.v17.leanback.widget.FocusHighlightHelper;
import android.support.v17.leanback.widget.HorizontalGridView;
import android.support.v17.leanback.widget.ItemBridgeAdapter;
import android.support.v7.app.AppCompatActivity;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
initView();
}
private void initView() {
HorizontalGridView horizontalGridView = findViewById(R.id.hg_title);
horizontalGridView.setHorizontalSpacing(30);
ArrayObjectAdapter arrayObjectAdapter = new ArrayObjectAdapter(new TitlePresenter());
ItemBridgeAdapter itemBridgeAdapter = new ItemBridgeAdapter(arrayObjectAdapter);
/*FocusHighlightHelper.setupBrowseItemFocusHighlight(itemBridgeAdapter,
FocusHighlight.ZOOM_FACTOR_LARGE, true);*/
horizontalGridView.setAdapter(itemBridgeAdapter);
arrayObjectAdapter.addAll(0, TitleModel.getTitleList());
}
}
1.5 效果圖
??代碼寫完效果就是下面這樣了，我這是在電視上運行后的效果植影。
2 一些屬性裳擎、方法
2.1 focusOutFront、focusOutEnd
??像上面云視聽極光所示思币，如果標(biāo)題欄使用 HorizontalGridView 實現(xiàn)鹿响，內(nèi)容區(qū)域使用 Fragment 里放的 VerticalGridView 實現(xiàn)，可能出現(xiàn)標(biāo)題欄和內(nèi)容區(qū)焦點切換不成功的問題谷饿，比如說惶我，焦點不能從內(nèi)容區(qū)切到標(biāo)題欄這樣的情況。這時使用 focusOutFront 和 focusOutEnd 屬性能夠解決問題博投，解決不同容器里焦點切換不成功的問題绸贡。使用方式如下所示。
<android.support.v17.leanback.widget.HorizontalGridView
android:id="@+id/hg_title"
android:layout_width="wrap_content"
android:layout_height="50dp"
app:focusOutEnd="true"
app:focusOutFront="true"/>
??這2個屬性在源碼中是通過調(diào)用 GridLayoutManager 的 setFocusOutAllowed 方法來使用的。
2.2 setHorizontalSpacing
??沒什么說的听怕，就是設(shè)置 HorizontalGridView 的 Item 之間的間距捧挺。setHorizontalMargin 已經(jīng)被棄用了。
2.3 setFocusScrollStrategy
??setFocusScrollStrategy 用來設(shè)置焦點的滾動方式尿瞭，它的參數(shù)有3個可選值闽烙，分別為 FOCUS_SCROLL_ALIGNED、FOCUS_SCROLL_ITEM 和 FOCUS_SCROLL_PAGE声搁，默認(rèn)值為 FOCUS_SCROLL_ALIGNED黑竞；值得一提的是，HorizontalGridView 和 VerticalGridView 的默認(rèn)焦點搜索規(guī)則是溯源原則酥艳，而設(shè)置焦點滾動方式為 FOCUS_SCROLL_ITEM 后摊溶，焦點搜索規(guī)則變?yōu)榱司徒瓌t。
setFocusScrollStrategy 使用方式如下所示充石。
horizontalGridView.setFocusScrollStrategy(HorizontalGridView.FOCUS_SCROLL_ITEM);
verticalGridView.setFocusScrollStrategy(HorizontalGridView.FOCUS_SCROLL_ITEM);
??FOCUS_SCROLL_ALIGNED：焦點在中間
??FOCUS_SCROLL_ITEM：焦點在末尾
??FOCUS_SCROLL_PAGE：翻頁
2.4 setNumRows
??setNumRows 用于設(shè)置行數(shù)莫换，默認(rèn) HorizontalGridView 為一行，通過 setNumRows 方法可以設(shè)置多行骤铃。但有個注意點拉岁，設(shè)置多行后要注意 position 的位置。舉個例子惰爬，2 行的 HorizontalGridView喊暖，第一行第一個模塊 position 為 0，而 position 為 1 的模塊是 第二行第一個撕瞧，而非第一行第二個陵叽。如下圖所示。
2.5 setRowHeight
??注意了丛版，setRowHeight 是用來設(shè)置 HorizontalGridView 的 Item 的高度巩掺，而不是用來設(shè)置 HorizontalGridView 的高度。
2.6 setSelectedPosition页畦、setSelectedPositionSmooth
??setSelectedPosition 和 setSelectedPositionSmooth 都是讓某個 position 獲取焦點胖替，區(qū)別在于 setSelectedPositionSmooth 在移動時更平滑一點。
2.7 duplicateParentState
??這個屬性還是很有用的豫缨。舉個例子独令，上圖是小米電視的【我的應(yīng)用】頁面，體驗一下能夠感受到：它的放大的焦點 View 是每個 Item 的最外層布局好芭，而不是圖標(biāo)那個View燃箭，但是其焦點框卻套在了圖標(biāo)那個 View 上，那這種效果如果我來實現(xiàn)就會用到 duplicateParentState 屬性了舍败。duplicateParentState 的意思是：當(dāng)前控件是否跟隨父控件的(點擊招狸、焦點等)狀態(tài)碗硬。下面簡單寫一下其使用方式。
??如上圖所示瓢颅，最外層布局設(shè)置可點擊、可獲取焦點弛说，在 ImageView 里設(shè)置了 duplicateParentState 屬性挽懦，表示跟隨父控件狀態(tài)，所以在父控件獲取焦點時木人，ImageView 也可以獲取焦點信柿。ImageView 設(shè)置了一個背景 bg_focus_border，bg_focus_border 是一個Selector醒第，里邊設(shè)置了焦點態(tài)和非焦點態(tài)的邊框渔嚷。這樣，Item 的獲取焦點時稠曼，圖標(biāo)就會顯示有焦點框了形病。
3 代碼
??沒多少代碼，就只傳了標(biāo)題欄的代碼霞幅。
??百度云盤下載代碼鏈接：https://pan.baidu.com/s/14Rf1XZMSxJQCH6dlmd4ICw
??提取碼：gkaj
4 結(jié)語
??還有很多不會的漠吻，不知道的東西，慢慢學(xué)習(xí)吧司恳。路漫漫其修遠兮途乃！
