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

最新推荐文章于 2022-11-28 15:23:49 发布

pur_e

最新推荐文章于 2022-11-28 15:23:49 发布

阅读量4.4k

点赞数

分类专栏： android 文章标签： android 自定义控件 Banner 布局触摸事件

本文链接：https://blog.csdn.net/pur_e/article/details/50761833

版权

android 专栏收录该内容

6 篇文章 0 订阅

订阅专栏

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

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

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

一、需求

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

最终效果如图：
这里写图片描述

二、初设计

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

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

三、具体实现

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的原因以及解决方案

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

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

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

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

    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
具体就是匿名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);
            }
        }
    }

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

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: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就已经做好了。其中涉及的各种知识，在自定义控件中，都是必须的，只有熟练掌握，才能写出属于自己的个性化控件，少踩几个坑。

这里写图片描述

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

pur_e

关注

0
点赞
踩
10

收藏

觉得还不错? 一键收藏
4
评论
[Android]使用HorizontalScrollView实现广告栏Banner及相关原理分析

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

扫一扫

专栏目录