[Android]使用HorizontalScrollView实现广告栏Banner及相关原理分析

我会带着你远行 2022-08-20 12:29 156阅读 0赞

现在的App中，广告栏Banner的使用还是挺广泛的，用于展示各种广告、活动推荐等。使用HorizontalScrollView可以很简单的实现一个可自动播放、可滑动、可点击的广告栏Banner，这个也可以做为一个例子，来学习自定义控件的制作。相关原理主要包括两个方面：

*  onMeasure、onLayout、onDraw等View、ViewGroup相关布局函数；
 *  dispatchTouchEvent、onInterceptTouchEvent、onTouchEvent等触摸事件处理函数（包括Click等事件触发）；

这两部分搞懂后，制作自定义控件就得心应手了。

## 一、需求 ##

1.  控件每次展示一张图片，隔一段时间换播下一张，如果当前是最后一张则展示第一张；
2.  用户手指触摸控件，停止轮播，用户滑动手指，则根据方向展示相应下一张或前一张图片；
3.  如果是第一张图片继续往前滑动，需要展示最后一张图片，如果最后一张图片往后滑动，展示第一张图片；
4.  最下方需要有小白点来指示当前是第几张图片；

最终效果如图：  
![这里写图片描述][Center]

## 二、初设计 ##

HorizontalScrollView本来就是一个横向滑动组件，使用它可以很方便的实现滑动及相应的动画效果，所以选择用它来写这个控件，我看网上也有使用ViewPager实现，原理都是大同小异；下面是按上面的需求做的初始设计，在实现的过程中还会碰到其他问题，需要按情况解决。

1.  布局  
    HorizontalScrollView——LinearLayout——ImageView List  
    同时需要在HorizontalScrollView上画小白点指示当前页
2.  定时滚动  
    添加一个定时器，每隔一段时间滑动到下一页，注意最后一页的循环处理。
3.  用户事件  
    添加事件监控，触摸停止定时器及滑动事件处理

## 三、具体实现 ##

### 1. 设计布局 ###

xml中的布局只有最外层控件，其他的LinearLayout和ImageView都是动态添加进去的，实现如下：

public class ADPager extends HorizontalScrollView{ 
    
        private LinearLayout container = null;
        private LinearLayout.LayoutParams imgLayoutParams = null;
        public ADPager(Context context) {
            super(context);
            init();
        }
        private void init(){
            Context ctx = getContext();
            container = new LinearLayout(ctx);
            ViewGroup.LayoutParams layoutParams = new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT);
            container.setLayoutParams(layoutParams);
            //横向布局
            container.setOrientation(LinearLayout.HORIZONTAL);
    
            imgLayoutParams = new LinearLayout.LayoutParams(getWidth(),getHeight());
    
            this.addView(container);
            this.setSmoothScrollingEnabled(true);
            //不显示滑动条
            this.setHorizontalScrollBarEnabled(false);
        }
    
        public void setImageList(int imgArray[]){
            int size = imgArray.length;
            if(size > 1){
                //如果大于一张图片，第一张前放最后一张图片
                this.container.addView(makeImageView(imgArray[size - 1]));
            }
            for(int imgId:imgArray){
                this.container.addView(makeImageView(imgId));
            }
            if(size > 1){
                //如果大于一张图片，最后一张后放第一张图片
                this.container.addView(makeImageView(imgArray[0]));
            }
        }
    
        public ImageView makeImageView(int resourceId){
            ImageView imageView;
            Context ctx = getContext();
            imageView = new ImageView(ctx);
            imageView.setImageResource(resourceId);
            imageView.setScaleType(ImageView.ScaleType.CENTER_CROP);
            imageView.setLayoutParams(imgLayoutParams);
            return imageView;
    
        }

在onCreate中调用初始化图片：

int imgIdArray[] = {R.drawable.img1,R.drawable.img2,R.drawable.img3};
        ADPager adPager = (ADPager)findViewById(R.id.adpager);
        adPager.setImageList(imgIdArray);

然后运行就碰到了第一个坑，根本没有图片被展示出来，原因是：在初始化时，我们尝试使用getWidth和getHeight函数来获取宽度和高度，然后设置图片大小，**但在View还没有展示出来时，其实通过这两个函数是不能获取宽高的，比如在onCreate/onStart/onResume中**，详见：  
[ Activity中获取view的高度和宽度为0的原因以及解决方案][Activity_view_0]

在上面的文章中，也提到了几种获取的方式，但我们是自定义控件，还有他方式来获取：

@Override
        protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
            super.onMeasure(widthMeasureSpec, heightMeasureSpec);
            imgLayoutParams.width = getMeasuredWidth();
            imgLayoutParams.height = getMeasuredHeight();
        }

这种方法使用了onMeasure函数，现在只要知道这个函数是用来测量自己及子View的大小就可以了，后面还会系统总结。

现在已经可以展示出图片，且可以自由滑动，当然，现在还简陋的很：  
![这里写图片描述][Center 1]  
       只不过有多张图片时，我们显示的是最后一张图片，是因为我们为了第一张图片还可以往前滑动，在前面添加的，所以我们需要在初始时，滑动到第一张图片展示：

public void scrollToPage(int page,boolean isSmooth){
            if(page < 0){
                page = mTotalSize - 1;
            }else if(page >= mTotalSize){
                page = 0;
            }
            //设置当前页
            mCurrPage = page;
            int width = getWidth();
            //因为第一张前面加了一张，所以页数需要+1。而只有一张图片时，scrollTo其实没有产生效果
            if(isSmooth){
                this.smoothScrollTo((page + 1) * width, 0);
            }else{
                this.scrollTo((page + 1) * width, 0);
            }
        }
    
        @Override
        protected void onLayout(boolean changed, int l, int t, int r, int b) {
            super.onLayout(changed, l, t, r, b);
            scrollToPage(0,false);
        }

### 2. 添加小白点 ###

小白点用来指示当前是哪张图片，位于中间下方，且不随图片滑动而移动。所以只能画在最上层的HorizontalScrollView上。这里我们在onDraw画控件函数中，直接在画版上画：

private  void initPaint(){
            mStrokePaint = new Paint();
            //抗锯齿
            mStrokePaint.setAntiAlias(true);
            //空心线宽
            mStrokePaint.setStrokeWidth(1.0f);
            //中空
            mStrokePaint.setStyle(Paint.Style.STROKE);
            //颜色
            mStrokePaint.setColor(Color.WHITE);
    
            mFillPaint = new Paint();
            mFillPaint.setAntiAlias(true);
            mFillPaint.setStyle(Paint.Style.FILL_AND_STROKE);
            mFillPaint.setColor(Color.WHITE);
        }
    
        @Override
        protected void dispatchDraw(Canvas canvas) {
            super.dispatchDraw(canvas);
            int width = getWidth();
    
            float density = getContext().getResources().getDisplayMetrics().density;
            //半径转换为像素
            int radiusInPixel = (int)(CIRCLE_RADIUS * density);
            //白点间隔
            int margin = radiusInPixel;
            //白点区域总宽度
            int totalWidth = radiusInPixel * 2 * mTotalSize + margin * (mTotalSize - 1);
            //初始第一个点位置
            int offsetX = getScrollX() + width / 2 - totalWidth / 2 + radiusInPixel;
            int offsetY = (int)(getHeight() - density * 10 - radiusInPixel);
            //开始画点
            for(int i = 0;i < mTotalSize; i++){
                if(i == mCurrPage){
                    canvas.drawCircle(offsetX,offsetY,radiusInPixel,mFillPaint);
                }else{
                    canvas.drawCircle(offsetX,offsetY,radiusInPixel,mStrokePaint);
                }
                offsetX += radiusInPixel * 2 + margin;
            }
        }

可以看到我代码中其实是使用dispatchDraw来画的，而不是上面说的onDraw函数。是因为我在实现时又踩了一个坑，因为View会先调用onDraw来画自己的东西，然后调用dispatchDraw去画孩子（当然，View没有孩子，这个只有在ViewGroup中才有用）

// Step 3, draw the content
    if (!dirtyOpaque) onDraw(canvas);
    
    // Step 4, draw the children
    dispatchDraw(canvas);

如果在onDraw中去画点，则会被后来画的孩子遮挡住，这个可以将container不添加到父节点中去来测试，可以看到我们画的圆。所以应该在dispatchDraw中，画完孩子然后去画点。  
       当然，在网上也看到如果没有背景会跳过onDraw直接调用dispatchDraw的说法，实验结果并不是这样。

### 3. 自动滑动 ###

这个比较简单，不过其中也碰到了一个坑，内存泄漏问题。这个可以看下前面的一个杂记：[Android内存泄露杂记2016-02-26][Android_2016-02-26]  
       具体就是匿名Runnable引用外部数据，后来使用WeakReference解决，代码如下：

public static class AutoPlayRunable implements Runnable{ 
            private WeakReference<ADPager> reference = null;
            public AutoPlayRunable(ADPager adPager){
                reference = new WeakReference<ADPager>(adPager);
            }
            @Override
            public void run() {
                ADPager adPager = reference.get();
                if(adPager != null){
                    int page = adPager.getCurrPage();
                    adPager.scrollToPage(page + 1,true);
                    adPager.postDelayed(adPager.getAutoPlayRunnable(),AUTO_PLAY_DUATION);
                }
            }
        }

现在广告就可以自动滚动起来了：  
![这里写图片描述][Center 2]

### 4.触摸事件 ###

但是现在还无法通过触摸来顺畅控制广告移动，就和上图一样。因为HorizontalScrollView自己处理了触摸事件，通过手指来自由滑动。但这不是我们想要的结果，我们需要的是通过触摸，可以左右滑动，但超过一半，就应该显示下一张，或者没超过一半退回，而不是停在中间。然后就是手指滑动的够快，就算不超过一半也需要到下一张，就和有惯性一样。想要实现这样的结果，我们需要重写触摸事件处理，幸运的是，Android是支持这样做的。  
       这需要使用到几个触摸事件接口，并对其流程足够了解。一共涉及3个接口，如下：  
View里，有两个回调函数 ：

1. public boolean dispatchTouchEvent(MotionEvent ev)；    
    2. public boolean onTouchEvent(MotionEvent ev);

ViewGroup里，有三个回调函数 ：

1. public boolean dispatchTouchEvent(MotionEvent ev)；    
    2. public boolean onInterceptTouchEvent(MotionEvent ev);    
    3. public boolean onTouchEvent(MotionEvent ev);

在Activity里，有两个回调函数 ：

1. public boolean dispatchTouchEvent(MotionEvent ev)；    
    2. public boolean onTouchEvent(MotionEvent ev);

事件传递默认是从父节点开始，直到传递到View。也就是说传递过程是Activity-ViewGroup-View。  
       触摸事件是由一系列的ACTION\_DOWN、ACTION\_MOVE…MOVE…MOVE、ACTION\_UP的过程  
       对上面的接口来说，事件包含三个处理方式，一是分发（dispatchTouchEvent），二是拦截(onInterceptTouchEvent)，一个是消费(onTouchEvent)，并都有其返回值。

*  分发： dispatchTouchEvent返回true则顺序下发会中断（一般表示事件被消费），后续节点接收不到事件（分发是深度优先的），返回false继续分发
 *  拦截： onInterceptTouchEvent比较复杂，return true可以拦截DOWN、MOVE、UP事件  
    
    
     *  拦截DOWN事件，则表示事件完全由当前ViewGroup来处理，后续MOVE、UP事件也会来找当前ViewGroup
     *  拦截MOVE、UP事件，则表示后续事件由当前ViewGroup来处理，之前处理事件的View会收到一个ACTION\_CANCEL事件
 *  消费： onTouchEvent事件，如果前面没有被拦截：  
    
    
     *  **View（如果可点击）默认返回true，表示消费事件**
     *  消费Down事件，则后续MOVE、UP事件都会来找当前View
     *  没消费Down事件，则其他事件也没有你什么事了，不会传递给你的
     *  许多事件依赖于onTouchEvent处理UP事件，如Click事件

配上伪代码：

View mTarget=null;//保存捕获Touch事件处理的View
    public boolean dispatchTouchEvent(MotionEvent ev) {
    
        //....其他处理，在此不管
    
        if(ev.getAction()==KeyEvent.ACTION_DOWN){
            //每次Down事件，都置为Null
    
            if(!onInterceptTouchEvent()){
                mTarget=null;
                View[] views=getChildView();
                for(int i=0;i<views.length;i++){
                    if(views[i].dispatchTouchEvent(ev))
                        mTarget=views[i];
                    return true;
                }
            }
        }
        //当子View没有捕获down事件时，ViewGroup自身处理。这里处理的Touch事件包含Down、Up和Move
        if(mTarget==null){
            return super.dispatchTouchEvent(ev);
        }
        //...其他处理，在此不管
        if(onInterceptTouchEvent()){
            //...其他处理，在此不管
        }
        //这一步在Action_Down中是不会执行到的，只有Move和UP才会执行到。
        return mTarget.dispatchTouchEvent(ev);
    
    }

更具体的知识储备：  
[Android中的dispatchTouchEvent()、onInterceptTouchEvent()和onTouchEvent()][Android_dispatchTouchEvent_onInterceptTouchEvent_onTouchEvent]  
[Android:30分钟弄明白Touch事件分发机制][Android_30_Touch]

现在我们就可以来想上面的问题了：

*  很明显，ScrollView通过处理Move事件，来进行子View的滑动及动画，所以不能动这个事件；
 *  然后还需要处理UP事件来确定手指抬起后，展示哪张图片；
 *  最后，还需要得到用户手指滑动的速度，速度快则直接展示下一页；
 *  还有别忘了，手指落下时移除自动播放，抬起时开始自动播放。（考虑一下，为什么移除自动播放不能放在onTouchEvent事件中去处理？）

最后代码如下：

@Override
        public boolean onInterceptTouchEvent(MotionEvent ev) {
            switch (ev.getAction()){
                case MotionEvent.ACTION_DOWN:
                    //停止自动播放
                    removeCallbacks(mAutoPlayRunnable);
                    break;
            }
            return super.onInterceptTouchEvent(ev);
    
        }
    
        @Override
        public boolean onTouchEvent(MotionEvent ev) {
            if(mVelocityTracker == null){
                mVelocityTracker = VelocityTracker.obtain();
            }
            mVelocityTracker.addMovement(ev);
            switch (ev.getAction()){
                case MotionEvent.ACTION_CANCEL:
                case MotionEvent.ACTION_UP:
                    int scrollX = getScrollX();
                    int width = getWidth();
                    //计算手指每秒移动像素
                    mVelocityTracker.computeCurrentVelocity(1000,2000);
                    float speedX = mVelocityTracker.getXVelocity();
                    int page;
                    if(Math.abs(speedX) > 1000){
                        //移动速度够大
                        page = scrollX / width;
                        if(speedX > 0){
                            page -= 1;
                        }
                    }else{
                        //缓慢移动，按当前哪张图展示多就显示哪张
                        page = (int)Math.round(scrollX * 1.0 / width) - 1;
                    }
                    scrollToPage(page, true);
                    //开启自动播放
                    postDelayed(mAutoPlayRunnable,AUTO_PLAY_DUATION);
                    //直接返回，不让ScrollView处理事件
                    return true;
            }
            return super.onTouchEvent(ev);
        }

### 5、点击事件 ###

这一步就很简单了，我们只需要给最下层的View添加点击事件就可以了。因为前面提到过的，View如果消费了UP事件用于Click事件，就不会传递给上层的ScrollView了。这里其实就也可以回答上面提出的问题，为什么不能在onTouchEvent中来取消自动播放，因为View默认会消费掉DOWN事件，是传递不到ScrollView中的。

## 四、结语 ##

至此，广告栏Banner就已经做好了。其中涉及的各种知识，在自定义控件中，都是必须的，只有熟练掌握，才能写出属于自己的个性化控件，少踩几个坑。

![这里写图片描述][Center 3]

PS:推荐一个好的看Android原码网站：  
[http://grepcode.com/][http_grepcode.com]

[Center]: /images/20220731/1d51d2a929534ecab95e637ef53a115e.png
[Activity_view_0]: http://blog.csdn.net/nailsoul/article/details/25909313
[Center 1]: /images/20220731/80cb3e6a91e64176bf50bcf89d10fcc6.png
[Android_2016-02-26]: http://blog.csdn.net/pur_e/article/details/50751522
[Center 2]: /images/20220731/38b4daf8c3ff4966b713fe3693de1275.png
[Android_dispatchTouchEvent_onInterceptTouchEvent_onTouchEvent]: http://blog.csdn.net/xyz_lmn/article/details/12517911
[Android_30_Touch]: http://www.cnblogs.com/linjzong/p/4191891.html
[Center 3]: /images/20220731/298b178d69f54a9f861d440e23de98c6.png
[http_grepcode.com]: http://grepcode.com/