RecyclerView系列一：TV焦点控制

Android TV开发中RecyclerView焦点控制的重要性

在Android TV开发中，特别是处理动态生成的列表项（如RecyclerView中的item）时，焦点控制变得尤为关键。
由于RecyclerView的item是动态创建和销毁的，传统的XML布局文件中的焦点控制属性
（如android:nextFocus*）无法直接应用于每个item。
因此，需要通过编程方式在RecyclerView的适配器（Adapter）中控制焦点的行为。

控制焦点的基本步骤

1. 设置View可聚焦

   • 确保RecyclerView中的每个item视图都是可聚焦的，通过在item的布局设置android:focusable="true"。
   • 对于Android TV应用，通常不需要设置android:focusableInTouchMode="true"，因为它主要影响触摸模式下的焦点行为。

2. 控制焦点转移

   • 由于item是动态生成的，无法直接在XML中指定android:nextFocus*属性去设置下一个焦点View。
   • 有效方法：

     • 自定义RecyclerView.OnKeyListener，处理方向键的按下事件，根据当前焦点的位置和按键方向决定新焦点位置，并请求焦点转移。

       其他：

       • 使用RecyclerView.LayoutManager控制焦点转移，通过重写RecyclerView.FocusFinder来自定义焦点查找逻辑（较复杂）。
       • 可以在RecyclerView的适配器中重写onBindViewHolder方法，并在其中设置焦点的逻辑。
       • 使用View.setOnFocusChangeListener监听焦点的变化，并通过View.requestFocus()方法请求焦点转移。

3. 阻止焦点离开当前视图

   • 在OnKeyListener中检查条件，当不希望焦点转移时返回false或不调用requestFocus()方法。

4. 实现焦点放大效果

   • 在item的XML布局文件中使用ObjectAnimator或scale属性定义放大和缩小的效果。
   • 在RecyclerView的Adapter中为ViewHolder设置焦点改变监听器，在获得焦点时启动放大动画，在失去焦点时启动缩小动画。

示例代码

RecyclerView的OnKeyListener处理方向键事件

recyclerView.setOnKeyListener(new View.OnKeyListener() {
    @Override
    public boolean onKey(View v, int keyCode, KeyEvent event) {
        //判断key事件
        if (event.getAction() == KeyEvent.ACTION_DOWN) {
            //findFocus()找到焦点View以及getPosition拿到位置
            View currentFocusedView = recyclerView.findFocus();
            int focusedPosition = ((LinearLayoutManager) recyclerView.getLayoutManager()).getPosition(currentFocusedView);

            switch (keyCode) {
                case KeyEvent.KEYCODE_DPAD_DOWN:
                    // 处理向下移动焦点的逻辑
                    break;
                case KeyEvent.KEYCODE_DPAD_UP:
                    // 处理向上移动焦点的逻辑
                    break;
                // 处理其他方向键
            }

            // 根据逻辑请求焦点转移到新的View
            // 例如: recyclerView.findViewHolderForAdapterPosition(newPosition).itemView.requestFocus();
        }
        return true; // 表明已处理按键事件
    }
});

RecyclerView Adapter中设置焦点放大效果

public class RecyclerViewAdapter extends RecyclerView.Adapter<RecyclerViewAdapter.ViewHolder> {
    // ... 其他代码 ...

    public static class ViewHolder extends RecyclerView.ViewHolder {
        private ImageView imageView;
        private ObjectAnimator scaleUpAnimator;
        private ObjectAnimator scaleDownAnimator;

        public ViewHolder(View itemView) {
            // ... 初始化动画和焦点监听器 ...
            itemView.setOnFocusChangeListener(new View.OnFocusChangeListener() {
                @Override
                public void onFocusChange(View v, boolean hasFocus) {
                    if (hasFocus) {
                        scaleUpAnimator.start();
                    } else {
                        scaleDownAnimator.start();
                    }
                }
            });
        }

        // ... 其他方法 ...
    }

    // ... 其他代码 ...
}

结论

通过以上步骤和示例代码，你可以在Android TV开发中有效地控制RecyclerView中item的焦点转移，并实现焦点放大效果，提升用户体验。

---

【TV简单页面开发】

1、设置可获取焦点

    android:focusable="true"
    view.setFocusable(true);

如果能触摸的话

    android:focusableInTouchMode="true"
    view.setFocusableInTouchMode(true);

2、View焦点监听

view.setOnFocusChangeListener(new View.OnFocusChangeListener() {
    @Override
    public void onFocusChange(View v, boolean hasFocus) {
        if (hasFocus) {
            // 获取焦点时操作，常见的有放大、加边框等
             v.setOutlineProvider(new ViewOutlineProvider() {  
                @Override  
                public void getOutline(View view, Outline outline) {  
                    Rect rect = new Rect(0, 0, (int) (view.getWidth() / FOCUS_SCALE), (int) (view.getHeight() / FOCUS_SCALE));  
                    outline.setRoundRect(rect, BORDER_WIDTH / 2);  
                }  
            });  
            v.setClipToOutline(true);  //加边框
        } else {
            // 失去焦点时操作，恢复默认状态
            v.setScaleX(1f);  
            v.setScaleY(1f); 
            v.setOutlineProvider(ViewOutlineProvider.BOUNDS); // 清除自定义边框  
            v.setClipToOutline(false); 
        }
    }
});

3，直接设置下一个获取焦点的View：

android:nextFocusDown="@id/button1"
android:nextFocusUp="@id/button2"
android:nextFocusLeft="@id/button3"
android:nextFocusRight="@id/button4"

view.setNextFocusDownId(R.id.button1);
view.setNextFocusUpId(R.id.button2);
view.setNextFocusLeftId(R.id.button3);
view.setNextFocusRightId(R.id.button4);

4、定位焦点位置：

    ViewTreeObserver observer = getWindow().getDecorView().getViewTreeObserver();
    observer.addOnGlobalFocusChangeListener(new ViewTreeObserver.OnGlobalFocusChangeListener() {
        @Override
        public void onGlobalFocusChanged(View oldFocus, View newFocus) {
            VLog.d(TAG, "oldFocus:    " + oldFocus + "/n" + "newFocus:    " + newFocus);
        }
    });

5、在复杂的自定义View中， 只有外层的父View能获取到焦点， 子View无论如何也获取不到焦点。

android:descendantFocusability="afterDescendants"

FOCUS_BEFORE_DESCENDANTS: 在子View之前优先获取焦点。
FOCUS_AFTER_DESCENDANTS: 当子View都不获取焦点时，才获取焦点
FOCUS_BLOCK_DESCENDANTS: 禁止子View获取焦点

通过这个属性可以指定viewGroup和其子View到底谁获取焦点， 直接在viewGroup的 xml的布局上使用就行。