【Android TV 开发】–＞Leanback 中的 HorizontalGridView

不断学习，做更好的自己！?

LeanBack 是 Google 官方推出的 TV 端的功能库，里面包含了很多在 TV Android 端开发常用的控件，本文重点介绍其对 RecyclerView 适配 TV 端做的封装：HorizontalGridView 。

效果图

属性 & 方法

• focusOutFront、focusOutEnd
  如果标题栏使用 HorizontalGridView 实现，内容区域使用 Fragment 里放的 VerticalGridView 实现，可能出现标题栏和内容区焦点切换不成功的问题，比如说，焦点不能从内容区切到标题栏这样的情况。这时使用 focusOutFront 和 focusOutEnd 属性能够解决问题，解决不同容器里焦点切换不成功的问题。
  
  
• setHorizontalSpacing()
  设置 HorizontalGridView 的 Item 之间的间距。
  
  
• setFocusScrollStrategy()
  设置焦点的滚动方式，它的参数有3个可选值，默认值为 FOCUS_SCROLL_ALIGNED；
  
  
  • FOCUS_SCROLL_ALIGNED：焦点在中间
  • FOCUS_SCROLL_ITEM：焦点在末尾
  • FOCUS_SCROLL_PAGE：翻页
• setNumRows()
  设置行数，默认 HorizontalGridView 为一行，通过 setNumRows 方法可以设置多行。但有个注意点，设置多行后要注意 position 的位置。
  
  
• setRowHeight()
  设置 HorizontalGridView 的 Item 的高度，而不是用来设置 HorizontalGridView 的高度。
  
  
• setSelectedPosition()、setSelectedPositionSmooth()
  让某个 position 获取焦点，区别在于 setSelectedPositionSmooth 在移动时更平滑一点。
  
  
• duplicateParentState()
  它的放大的焦点 View 是每个 Item 的最外层布局，而不是图标那个View，但是其焦点框却套在了图标那个 View 上，那这种效果如果我来实现就会用到 duplicateParentState 属性了。duplicateParentState 的意思是：当前控件是否跟随父控件的(点击、焦点等)状态。
  
  

基本使用

1. 添加依赖

 implementation 'androidx.leanback:leanback:1.0.0' implementation 'androidx.leanback:leanback-preference:1.0.0' 

2. 布局文件

• bg_title.xml

 
    <selector xmlns:android="http://schemas.android.com/apk/res/android"> <item android:drawable="@drawable/btn_focus" android:state_focused="true" />  
     selector> 

• btn_focus.xml

 
    <shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle"> <corners android:radius="300dp" /> <solid android:color="#FF4081" />  
     shape> 

• activity_widget.xml

 
    <androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" android:background="@color/teal_200" tools:context=".widget.WidgetActivity"> <androidx.leanback.widget.HorizontalGridView android:id="@+id/hg_title" android:layout_width="wrap_content" android:layout_height="50dp" app:focusOutEnd="true" app:focusOutFront="true" tools:ignore="MissingConstraints" />  
     androidx.constraintlayout.widget.ConstraintLayout> 

• item_title.xml

 
    <TextView xmlns:android="http://schemas.android.com/apk/res/android" android:id="@+id/tv_title" android:layout_width="wrap_content" android:layout_height="match_parent" android:background="@drawable/bg_title" android:clickable="true" android:focusable="true" android:gravity="center" android:textColor="#FFFFFF" android:focusableInTouchMode="true" android:paddingLeft="30dp" android:paddingRight="30dp" android:textSize="28sp" /> 

3. 创建 Presenter

/ * Created on 2022/4/16 17:51 * * @author Gong Youqiang */ 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); } } } 

4. Title.java

/ * Created on 2022/4/16 17:53 * * @author Gong Youqiang */ public class Title { 
    private String name; public Title(String name) { 
    this.name = name; } public String getName() { 
    return name; } public void setName(String name) { 
    this.name = name; } } 

5. TitleModel

/ * Created on 2022/4/16 17:53 * * @author Gong Youqiang */ public class TitleModel { 
    public static List<Title> getTitleList() { 
    List<Title> titleList = new ArrayList<>(); titleList.add(new Title("儿童模式")); titleList.add(new Title("家庭模式")); titleList.add(new Title("商务模式")); return titleList; } } 

6. 使用

public class WidgetActivity extends AppCompatActivity { 
    @BindView(R.id.hg_title) HorizontalGridView horizontalGridView; @SuppressLint("RestrictedApi") @Override protected void onCreate(Bundle savedInstanceState) { 
    super.onCreate(savedInstanceState); setContentView(R.layout.activity_widget); ButterKnife.bind(this); horizontalGridView.setHorizontalSpacing(30); ArrayObjectAdapter arrayObjectAdapter = new ArrayObjectAdapter(new TitlePresenter()); ItemBridgeAdapter itemBridgeAdapter = new ItemBridgeAdapter(arrayObjectAdapter); horizontalGridView.setAdapter(itemBridgeAdapter); horizontalGridView.setFocusScrollStrategy(BaseGridView.FOCUS_SCROLL_ITEM); arrayObjectAdapter.addAll(0, TitleModel.getTitleList()); } }