WearableListView的使用和一些思考

今年加盟了一家做手表的公司，至此开启了androidwear（类）的开发之门。

近日要做一个手表上的List显示，为此也是花了很多的心思在List效果上，多日下来，有些心得。

一.需求确定：

手表上的List，它的静止图是这样的

他的动态图是这样的。

明确需求

1.显示一个list

2.list有一个头部

3.list一个屏幕上显示三个数据，中间那个数据高亮放大，并显示详细信息

4.list滑动时有显示效果的变化

二.需求分析和相关技术

拿到这个需求，在没有做过androidwear的情况下，还是觉得比较复杂的。首先先去研究了下androidwear的list显示特点。

根据官方文档，我们认识了androidwear的常用list，WearableListView。（WearableListView的相关基础知识，详见创建列表1.0.md 和创建列表1.1.md）

根据androidwear的官方文档中的例子，我们知道 WearableListView仅支持三个等高的数据显示

为了描述方便，下面的例子，我们都假设Wearable是全屏显示的。

那我们还有几个问题要解决

1.如何显示头部。

我们注意到，WearableListView的第一个数据是从屏幕中间开始显示的。这样，List上面就有一个很大的空白空间，这个空白空间用来显示一个标题（比如Setting）是非常合理的。

而为了整体UI显示的效果，这个头部也需要随着Listview的Scroll同步进行滑动效果的显示。

我们的布局可以将WearableListView和这个头部（mImgRecordRl）放在一起显示，通过addOnLayoutChangeListener监听布局的变化

     @Override
     public void onLayoutChange(View v, int left, int top, int right, int bottom, int oldLeft, int
             oldTop, int oldRight, int oldBottom) {
         if (v == mImgRecordRl) {
             mInitialHeaderHeight = bottom - top;
             mInitialHeaderHeight += ((ViewGroup.MarginLayoutParams) v.getLayoutParams()).topMargin;

         } else if (v == listView) {
             adjustHeaderTranslation();
         }
     }

同时通过addOnScrollListener监听WearableListView的Scroll状态，在onScroll时不断的根据mInitialHeaderHeight调整Header的Translation

 listView.addOnScrollListener(new WearableListView.OnScrollListener() {
             @Override
             public void onScroll(int var1) {
                 adjustHeaderTranslation();
                 //rect.setPressed(true);
             }

             @Override
             public void onAbsoluteScrollChange(int var1) {

             }

             @Override
             public void onScrollStateChanged(int var1) {
                 ...........
             }

             @Override
             public void onCentralPositionChanged(int var1) {

             }
         });

而调整Header TranslationY的方法就在这个adjustHeaderTranslation()里了。（逻辑还是很简单清晰的，就是通过刚才的mInitialHeaderHeight以及Listview三平均高度的实际来做的计算）

     private void adjustHeaderTranslation() {
         int translation = 0;
         if (listView.getChildCount() > 0) {
             translation = listView.getCentralViewTop() - listView.getChildAt(0).getTop();
         }
         float newTranslation = Math.min(Math.max(-mInitialHeaderHeight, -translation), 0);
         int position = listView.getChildPosition(this.listView.getChildAt(0));
         if (position != 0 && newTranslation >= 0) {
             return;
         }
         mImgRecordRl.setTranslationY(newTranslation);
     }

这样，我们第一个问题就解决了，头部可以随着list滑动而滑动了。

2.如何中间数据高亮显示。

首先我们还是要看下官方文档，我们发现WearableListView已经提供好这样的接口。

 @Override
     public void onCenterPosition(boolean animate) {
         ............
     }

     @Override
     public void onNonCenterPosition(boolean animate) {
         ............
     }

貌似，到此我们的问题已经解决差不多了，那现在我们可以实现需求了吗，对了，滑动时的那些效果如何实现。

3.滑动效果的实现

在这个地方，我开发过程中遇到了很多的坑，方案都改了几次，在这我一一道来吧，泪崩了。

第一个版本：

我已经知道中间和非中间状态的API（见上面的问题2），而且需求上要求中间和非中间的布局确实区别很大，那么我干脆就写好两个布局，在onNonCenterPosition和onCenterPosition分别的visible和gone不就可以了吗。

于是，我就这样做了，结果是滑动时总感觉到到处跳转。

经过分析，看来最好不要用两个布局，因为无论如何，两个布局就是两个view，这样的界面切换肯定是非常生硬的。

第二个版本:

我们采用一个布局，然后在onNonCenterPosition和onCenterPosition分别对布局里的元素进行translation scale alpha的操作。

我们发现，这样比两个布局要好一点，相对没有生硬的感觉。但是还是有突然跳转的感觉。

从网上找了一些例子，发现大家的做法就是对translation scale alpha的操作加一个动画，这样可能会看起来不是那么的生硬。

但是我们发现如果加一个动画，如果在动画没有完全完成的情况下，我右滑到一半不退出返回的话（注：这是androidwear的设计，右滑就是走onDestroy，而如果没有完成右滑动作，到一半返回，这样activity生命周期并没有发生变化），动画停止，这样整个界面就会静止在动画停止前的状态，像卡死一样，而这种操作其实是非常常见的，这也是这个版本测试多次提的问题。

第三个版本

由于没有找到合适的方向，我们与设计师讨论修改了方案，改为滑动时不变，停止滑动时，以动画的方式中间元素变化。

再看看需求里的效果，他有一个中间逐渐变大，两边逐渐缩小的效果。

经过实验发现，

1.listview的scroll过程，listitem并没有scroll，这样只能做到对listview的监听，而无法实现对listItem的监听。因此我只能在WearableListView中的onTouchEvent中加一个对listItem的监听，

2.但是我后面又发现onNonCenterPosition onCenterPosition是一直在调用并刷新界面的，这样这个监听后做的处理会和onNonCenterPosition/onCenterPosition冲突。另外，对listItem的监听，坐标的变化很难处理，因为牵扯到上下两个item都处理的情况，尝试了各种处理方式都会冲突（比如ACTION_DOWN的时候，加flag，然后onNonCenterPosition/onCenterPosition时特殊处理;然后还有快速滑动的逻辑需要特殊处理）。

3.最难处理的是第二个版本遇到的问题，如何处理右滑到一半不退出返回的情况。因为我们要让滑动时所有元素都显示一个简单信息，滑动即将停止的时候，中间元素显示一个详细信息。那么滑动停止，我需要实现onTouchEvent中的ACTION_UP。但是右滑到一半不退出返回的情况是不会发生ACTION_UP事件的，这样就会出现和第二个版本那个动画一样的问题。

这个版本耗费了大量的时间，并且出现了大量的bug。 最终由于bug已经不可控，我决定还是推倒重来，回到最初的设计。

第四个版本（最终成功的版本）

经过那么多的尝试，在这个版本中，我决定好好研究下WearableListView的源码。

我们还是从onNonCenterPosition/onCenterPosition开始研究，我们知道WearableListView是继承。

下面的代码是从WearableListView中截取出来的。

 public static class ViewHolder extends android.support.v7.widget.RecyclerView.ViewHolder {
         public ViewHolder(View itemView) {
             super(itemView);
         }

         protected void onCenterProximity(boolean isCentralItem, boolean animate) {
             if (this.itemView instanceof WearableListView.OnCenterProximityListener) {
                 WearableListView.OnCenterProximityListener item = (WearableListView
                         .OnCenterProximityListener) this.itemView;
                 if (isCentralItem) {
                     item.onCenterPosition(animate);
                 } else {
                     item.onNonCenterPosition(animate);
                 }

             }
         }
 ..................
 }

 private void notifyChildrenAboutProximity(boolean animate) {
         //onAllItemScroll(animate);

         WearableListView.LayoutManager layoutManager = (WearableListView.LayoutManager) this
                 .getLayoutManager();
         int count = layoutManager.getChildCount();
         if (count != 0) {
             int index = layoutManager.findCenterViewIndex();

             int position;
             for (position = 0; position < count; ++position) {
                 View view = layoutManager.getChildAt(position);
                 WearableListView.ViewHolder listener = this.getChildViewHolder(view);
                 listener.onCenterProximity(position == index, animate);

             }

     private void onScroll(int dy) {
         isScroll = true;
         Iterator var2 = this.mOnScrollListeners.iterator();

         while (var2.hasNext()) {
             WearableListView.OnScrollListener listener = (WearableListView.OnScrollListener) var2
                     .next();
             listener.onScroll(dy);
         }
         this.notifyChildrenAboutProximity(true);

     }

 android.support.v7.widget.RecyclerView.OnScrollListener onScrollListener = new android
                 .support.v7.widget.RecyclerView.OnScrollListener() {
             public void onScrollStateChanged(RecyclerView recyclerView, int newState) {

                 if (newState == 0 && WearableListView.this.getChildCount() > 0) {
                     WearableListView.this.handleTouchUp((MotionEvent) null, newState);
                 }

                 Iterator var3 = WearableListView.this.mOnScrollListeners.iterator();

                 while (var3.hasNext()) {
                     WearableListView.OnScrollListener listener = (WearableListView
                             .OnScrollListener) var3.next();
                     listener.onScrollStateChanged(newState);
                 }

             }

             public void onScrolled(RecyclerView recyclerView, int dx, int dy) {
                 WearableListView.this.onScroll(dy);
             }
         };
         this.setOnScrollListener(onScrollListener);

从上面的源码可以看出，listView onScroll的时候，也就是listItem onNonCenterPosition/onCenterPosition(animate = true)的时候（注：onNonCenterPosition/onCenterPosition(animate = false)是第一次进入界面进行layout的时候，这不是本文重点，就不再详述）。这样我们就可以确认，滑动时的效果就应该在onNonCenterPosition/onCenterPosition中处理。

看到这里，我们就明白了为什么在onNonCenterPosition/onCenterPosition中使用动画会有卡顿的效果，因为滚动的时候一直产生新的动画。

但是问题来了，onNonCenterPosition/onCenterPosition中没有滑动距离的参数，我们如何判断当前ListItem到底滑了多少呢？

我们再一次的研究所谓Center和NonCenter，到底在滑动的时候，谁是Center，谁是NonCenter呢？

我们找到刚才源码中那个标红的findCenterViewIndex

         private int findCenterViewIndex() {
             int count = this.getChildCount();
             int index = -1;
             int closest = 2147483647;
             int centerY = WearableListView.getCenterYPos(WearableListView.this);

             for (int i = 0; i < count; ++i) {
                 View child = WearableListView.this.getLayoutManager().getChildAt(i);
                 int childCenterY = WearableListView.this.getTop() + WearableListView
                         .getCenterYPos(child);
                 int distance = Math.abs(centerY - childCenterY);
                 if (distance < closest) {
                     closest = distance;
                     index = i;
                 }
             }

             if (index == -1) {
                 throw new IllegalStateException("Can\'t find central view.");
             } else {
                 return index;
             }
         }

这段代码仔细一看，其实就是一个意思：如果ListView高360,则Y坐标处在60-180之间的元素就是CenterPosition,另外两个就是NonCenterPostion。

好了，有了这个原理性的知识，我们的技术方案一下子豁然开朗。

我们原先需求是上下两边的元素在向中间滑动的过程中，进行scale translation alpha的操作。而我开始就理解错了，总以为要对上中下三个的元素同时进行操作。

其实一旦上下两边的元素（原始Y坐标为0 240）进入60-180这个Y坐标的范围，他就自动变成了CenterPosition。这样只需要针对CenterPosition的元素的Y坐标相对于120的中心点的偏离度进行操作即可。

     @Override
     public void onCenterPosition(boolean animate) {
         float scale = (Math.abs(getY() - getHeight())) / (getHeight() / 2);   //这个我们称之为偏离度

         mNameTv.setScaleX(1.55f - 0.55f * scale);
         mNameTv.setScaleY(1.55f - 0.55f * scale);
         mNameTv.setTranslationY(-40.0f + 40.0f * scale);
         if (scale < 0.3f) {
             mDateTimeLl.setAlpha(1.0f - scale);
             mDuarionLl.setAlpha(1.0f - scale);
         } else {
             mDateTimeLl.setAlpha(0.0f);
             mDuarionLl.setAlpha(0.0f);
         }
     }

     @Override
     public void onNonCenterPosition(boolean animate) {

         mNameTv.setScaleX(1.0f);
         mNameTv.setScaleY(1.0f);
         mNameTv.setTranslationY(0.0f);
         mDateTimeLl.setAlpha(0.0f);
         mDuarionLl.setAlpha(0.0f);
     }

至此，我们文章开头的那个需求就真正的实现了。

最后，我们总结一下WearableListView的相关注意事项：

1.WearableListView 屏幕下，仅能显示三个数据元素 listitem的高度就是listview高度/3

2.WearableListView进入界面，第一个元素（就是第0个）显示在中间位置，我们可以在第一个元素的上方加一个Header

3.WearableListView如果要实现中间高亮的效果，要在onNonCenterPosition/onCenterPosition中做处理

4.滑动状态下，WearableListView的CenterPosition判断标准是 listitem的Y坐标处于 (listview.getY + listItem.getHeight/2) —— listview.getCenterY之间

5.onNonCenterPosition/onCenterPosition严禁使用动画

6.滑动时元素变化的最优设计方案是：针对CenterPosition的元素的Y坐标相对于（listview.getCenterY - listItem.getHeight/2）的偏离度进行操作即可。

 

一个重要的教训：

切忌对不熟的控件想当然的使用，

要尽可能地的弄懂控件的原理，

如果文档没有看明白，那就去看源码，

如果源码太过于复杂，至少要多做些实验。