前言：Android TV Launcher頁在RecyclerView出來之前大家用GridView去實作。TV開發有五向鍵的監聽，遙控器hover監聽，點選事件等。用GridView去處理焦點是有一定挑戰性的，往往會出現不可預料焦點錯亂問題。這裡封裝了一個針對TV的RecyclerView，很友善的處理了這些事件。
首先上效果圖：
tvRecycler.gif
這裡封裝了RecyclerView實作了下面的一些功能:
1.響應五向鍵，按下五向鍵的上下左右會跟着移動，并獲得焦點，在獲得焦點時會擡高。
2.在滑鼠hover在條目上時會獲得焦點。
3.添加了條目的點選和長按事件。
4.添加了是否第一個可見條目和是否是最後一個可見條目的方法。
5.在item獲得焦點時和失去焦點時，這裡有相應的回調方法。
實作
下面分析一些關鍵的點：
1.滑鼠滑動時避免跟着滑動，隻響應五向鍵和左右箭頭
@Override
public boolean dispatchTouchEvent(MotionEvent ev) {
//在recyclerView的move事件情況下，攔截調，隻讓它響應五向鍵和左右箭頭移動
LogUtil.i(this, "CustomRecycleView.dispatchTouchEvent.");
return ev.getAction() == MotionEvent.ACTION_MOVE || super.dispatchTouchEvent(ev);
}
2.使用StaggeredGridLayoutManager實作管理，如果使用GridLayoutManager會出現焦點的錯亂，當使用五向鍵左右移動時，會從上面轉移到下面。原因是GridLayoutManager會存在分組。
//設定布局管理器
StaggeredGridLayoutManager layoutManager = new StaggeredGridLayoutManager(3,StaggeredGridLayoutManager.HORIZONTAL);
mRecyclerView.setLayoutManager(layoutManager);
3.設定RecyclerView的item有焦點。按五向鍵，焦點會跟着一起移動
//item可以獲得焦點，需要設定這個屬性。
holder.itemView.setFocusable(true);
4，左右鍵，讓RecyclerView跟着一起滾動，并獲得焦點：
@Override
public boolean dispatchKeyEvent(KeyEvent event) {
boolean result = super.dispatchKeyEvent(event);
int dx = this.getChildAt(0).getWidth();
View focusView = this.getFocusedChild();
if (focusView != null) {
switch (event.getKeyCode()) {
case KeyEvent.KEYCODE_DPAD_RIGHT:
if (event.getAction() == KeyEvent.ACTION_UP) {
return true;
} else {
View rightView = FocusFinder.getInstance().findNextFocus(this, focusView, View.FOCUS_RIGHT);
LogUtil.i(this, "rightView is null:" + (rightView == null));
if (rightView != null) {
rightView.requestFocusFromTouch();
return true;
} else {
this.smoothScrollBy(dx, 0);
return true;
}
}
case KeyEvent.KEYCODE_DPAD_LEFT:
View leftView = FocusFinder.getInstance().findNextFocus(this, focusView, View.FOCUS_LEFT);
LogUtil.i(this, "left is null:" + (leftView == null));
if (event.getAction() == KeyEvent.ACTION_UP) {
return true;
} else {
if (leftView != null) {
leftView.requestFocusFromTouch();
return true;
} else {
this.smoothScrollBy(-dx, 0);
return true;
}
}
}
}
return result;
}
這裡請求擷取焦點的方法是：
rightView.requestFocusFromTouch();
TV的焦點的處理的邏輯比較複雜：
5.在holder裡監聽到焦點變化時做一些處理：
holder.itemView.setOnFocusChangeListener(new View.OnFocusChangeListener() {
@Override
public void onFocusChange(View v, boolean hasFocus) {
if (hasFocus) {
focusStatus(v);
} else {
normalStatus(v);
}
}
});
private void focusStatus(View itemView) {
if (itemView == null) {
return;
}
if (Build.VERSION.SDK_INT >= 21) {
//擡高Z軸
ViewCompat.animate(itemView).scaleX(1.10f).scaleY(1.10f).translationZ(1).start();
} else {
ViewCompat.animate(itemView).scaleX(1.10f).scaleY(1.10f).start();
ViewGroup parent = (ViewGroup) itemView.getParent();
parent.requestLayout();
parent.invalidate();
}
onItemFocus(itemView);
}
protected abstract void onItemFocus(View itemView);
private void normalStatus(View itemView) {
if (itemView == null) {
return;
}
if (Build.VERSION.SDK_INT >= 21) {
ViewCompat.animate(itemView).scaleX(1.0f).scaleY(1.0f).translationZ(0).start();
} else {
ViewCompat.animate(itemView).scaleX(1.0f).scaleY(1.0f).start();
ViewGroup parent = (ViewGroup) itemView.getParent();
parent.requestLayout();
parent.invalidate();
}
onItemGetNormal(itemView);
}
protected abstract void onItemGetNormal(View itemView);
這裡抽象了兩個方法，當item獲得焦點和失去焦點時調用。獲得焦點時條目會擡高，這裡是擡高了Z軸。
6.擷取在第一個和最後一個可見的條目，根據這些狀态去顯示和隐藏左右箭頭。
public boolean isFirstItemVisible() {
LayoutManager layoutManager = getLayoutManager();
if (layoutManager instanceof StaggeredGridLayoutManager) {
int[] firstVisibleItems = null;
firstVisibleItems = ((StaggeredGridLayoutManager) layoutManager).
findFirstCompletelyVisibleItemPositions(firstVisibleItems);
int position = firstVisibleItems[0];
return position == 0;
} else if (layoutManager instanceof LinearLayoutManager) {
int position = ((LinearLayoutManager) layoutManager).findFirstCompletelyVisibleItemPosition();
return position == 0;
}
return false;
}
public boolean isLastItemVisible(int lineNum, int allItemNum) {
LayoutManager layoutManager = getLayoutManager();
if (layoutManager instanceof StaggeredGridLayoutManager) {
int[] lastVisibleItems = null;
lastVisibleItems = ((StaggeredGridLayoutManager) layoutManager).findLastCompletelyVisibleItemPositions(lastVisibleItems);
int position = lastVisibleItems[0];
LogUtil.i(this, "lastVisiblePosition:" + position);
boolean isVisible = position >= (allItemNum - lineNum);
if (isVisible) {
scrollBy(1, 0);
}
return isVisible;
} else if (layoutManager instanceof LinearLayoutManager) {
int position = ((LinearLayoutManager) layoutManager).findLastCompletelyVisibleItemPosition();
return position == allItemNum - 1;
}
return false;
}
下面說一個坑，在處理最後一個條目時可見時，我發現拿到的資料并不是一種情況，當一共有三行時。
用下面的代碼來打出位置：
for (int i = 0; i < lastVisibleItems.length; i++) {
LogUtil.i(this, "order:"+i +"----->last position:" + lastVisibleItems[i]);
}
有三種情況：
1.最後一列隻有有一個時，打出的log是
01-06 02:40:51.868 4135-4135/com.songwenju.customtvrecyclerview I/swjCustomRecyclerView: order:0----->last position:12
01-06 02:40:51.869 4135-4135/com.songwenju.customtvrecyclerview I/swjCustomRecyclerView: order:1----->last position:10
01-06 02:40:51.869 4135-4135/com.songwenju.customtvrecyclerview I/swjCustomRecyclerView: order:2----->last position:11
2.當最後一列有兩個時：
01-06 02:41:54.285 6109-6109/com.songwenju.customtvrecyclerview I/swjCustomRecyclerView: order:0----->last position:12
01-06 02:41:54.286 6109-6109/com.songwenju.customtvrecyclerview I/swjCustomRecyclerView: order:1----->last position:13
01-06 02:41:54.286 6109-6109/com.songwenju.customtvrecyclerview I/swjCustomRecyclerView: order:2----->last position:11
3.當最後一行有三個時：
01-06 02:43:21.336 8818-8818/com.songwenju.customtvrecyclerview I/swjCustomRecyclerView: order:0----->last position:12
01-06 02:43:21.337 8818-8818/com.songwenju.customtvrecyclerview I/swjCustomRecyclerView: order:1----->last position:13
01-06 02:43:21.337 8818-8818/com.songwenju.customtvrecyclerview I/swjCustomRecyclerView: order:2----->last position:14
是以這裡的處理是傳入行數：
boolean isVisible = position >= (allItemNum - lineNum);來判斷是否可見。
7.在Recycler滾動時候去處理箭頭的顯示狀态：
private class MyOnScrollListener extends RecyclerView.OnScrollListener {
@Override
public void onScrollStateChanged(RecyclerView recyclerView, int newState) {
super.onScrollStateChanged(recyclerView, newState);
}
@Override
public void onScrolled(RecyclerView recyclerView, int dx, int dy) {
super.onScrolled(recyclerView, dx, dy);
//在滾動的時候處理箭頭的狀态
setLeftArrStatus();
setRightArrStatus();
}
}
結束：
注意在使用該控件時，要設定RecyclerView的寬度是Item的整數倍，左右箭頭點選滑動的距離也要設定為RecyclerView寬度。
項目的位址：https://github.com/songwenju/CustomTvRecyclerView
如果對你有幫助，歡迎star和fork。
推薦：
歡迎關注我建立的Android TV 簡書專題，會定期給大家分享一些AndroidTv相關的内容：
http://www.jianshu.com/c/37efc6e9799b
版權聲明：本文為部落客原創文章，并已授權微信公衆号Tamic開發社群獨家釋出。