手把手教你用ViewPager自定义实现Banner轮播

欢迎大家关注android开源网络框架nohttp：https://github.com/yanzhenjie/nohttp 

　　我们在实际开发中，很多app都会在做一个广告轮播器（可能是图片，可能是其他view），很多同学都是使用别人封装好的或者直接使用viewpager自己来改，但是有人可能并不理解里面的原理，或者有人遇到了手势滑动冲突。我们今天就用150行代码实现一自定义的广告轮播器并不干扰原来view滑动事件。
　　本例代码源码及demo传送门

效果演示

需求分析、解决方案

　　轮播器最重要的几个特点就是：自动滚动、手动滑动、滚动方向、每个item显示时间。因此我们设计提供以下几个方法供外部调用：

/**
 * 设置每个item的播放时间，默认3000毫秒
 */
public void setshowtime(int showtimemillis);

/**
 * 设置滚动方向，默认向左滚动
 */
public void setdirection(direction direction);

/**
 * 开始自动滚动
 */
public void start();

/**
 * 停止自动滚动
 */
public void stop();

/**
 * 播放上一个
 */
public void previous();

/**
 * 播放下一个
 */
public void next();

　　仔细看过上面方法的同学会发现，和我们的分析想比，还缺少一个手动滑动的方法，我们知道手势滑动肯定要用到ontouch等方法，所以我们想到v4包下viewpager自带滑动效果，而且可以代码控制跳转到某个item。因此我们自定义view继承viewpager不就完美解决了。
　　我们看到上面的方法中有一个direction类，这个类不是系统的，是达哥自定义的方向控制枚举，目前最常见的轮播方向无非就是左右轮播(上下本次先不讨论)，代码如下：

public enum direction {
 /**
 * 向左行动，播放的下一张应该是右边的
 */
 left,

 /**
 * 向右行动，播放的下一张应该是左边的
 */
 right
}

自定义view如何实现以及原理

　　上面分析到需要继承viewpager，so我们先结合上面的几个方法把完整的代码撸起来：

public class autoplayviewpager extends viewpager {

 public autoplayviewpager(context context) {
 super(context);
 }

 public autoplayviewpager(context context, attributeset attrs) {
 super(context, attrs);
 }

 /**
 * 播放时间
 */
 private int showtime = 3 * 1000;
 /**
 * 滚动方向
 */
 private direction direction = direction.left;

 /**
 * 设置播放时间，默认3秒
 *
 * @param showtimemillis 毫秒
 */
 public void setshowtime(int showtimemillis) {
 this.showtime = showtime;
 }

 /**
 * 设置滚动方向，默认向左滚动
 *
 * @param direction 方向
 */
 public void setdirection(direction direction) {
 this.direction = direction;
 }

 /**
 * 开始
 */
 public void start() {
 // todo 待实现开始播放
 }

 /**
 * 停止
 */
 public void stop() {
 // todo 待实现停止播放
 }

 /**
 * 播放上一个
 */
 public void previous() {
 // todo 待实现播放上一个
 }

 /**
 * 播放下一个
 */
 public void next() {
 // todo 待实现播放下一个
 }

 public enum direction {
 /**
  * 向左行动，播放的应该是右边的
  */
 left,

 /**
  * 向右行动，播放的应该是左边的
  */
 right
 }
}

　　setshowtime(int showtimemillis)方法和setdirection(direction direction)就是记录一下某一个状态而已，现在已经简单的实现了，重点就是开始播放和停止播放。 　　

定时轮播的原理分析和实现

　　前方高能，各位看官小心裤子别掉了。现在我们使用viewpager最主要的就是自动播放了，所以我们需要一个定时器去执行任务，but这样子就得用到handler，就有点小题大做了。这里介绍view的两个方法：

// 线程将被添加到消息队列，这个线程将会在ui线程（主线程）运行。
public boolean post(runnable action);

// 线程将被添加到消息队列，在指定的时间之后运行，这个线程将会在ui线程（主线程）运行。
public boolean postdelayed(runnable action, long delaymillis);

　　看到第二个方法犹如醍醐灌顶啊有木有，既然是所有view都有的方法，viewpager必须有啊，这样不就可以在主线程定时发布一个任务了吗？所以我们这里写一个runnable来做这个定时任务。

/**
 * 播放器
 */
private runnable player = new runnable() {
 @override
 public void run() {
 play(direction);
 }
};

　　这里看到有一个play(direction);的方法待我们去实现，我们暂且把这个方法先放一放，我们先来看怎么利用这个private runnable player完成开始播放和停止播放。 　　

实现开始播放和停止播放

　　开始播放时我们为了让当前显示的图片显示showtime的时间，所以我们利用postdelayed(runnable action, long delaymillis);方法在showtime时间之后触发private runnable player：

/**
 * 开始
 */
public void start() {
 postdelayed(player, showtime);
}

　　停止播放，我们把这个线程给取消了就行了，因此停止的方法的实现是：

/**
 * 停止
 */
public void stop() {
 removecallbacks(player);
}

　　但是为了防止开发者不停的调用start方法造成卡死现象，我们在start中做个优化，每次star前先把之前private runable player移除了，因此start方法完整的代码是：

/**
 * 开始
 */
public void start() {
 stop();
 postdelayed(player, showtime);
}

核心重点：如何根据方向播放上一张和下一张

　　本例的核心和重点来了，现在回过头去实现刚才搁置的play(direction);方法，它要根据播放的方向来播放上一张和下一张，我们具体看代码，尤其要细细品味注释哦：

/**
 * 执行播放
 *
 * @param direction 播放方向
 */
private synchronized void play(direction direction) {
 // 拿到viewpager的适配器
 pageradapter pageradapter = getadapter();
 if (pageradapter != null) {// 判空
 // item数量
 int count = pageradapter.getcount();
 // viewpager现在显示的第几个？
 int currentitem = getcurrentitem();
 switch (direction) {
  case left:// 如是向左滚动的，currentitem+1播放下一个
  currentitem++;

  // 如果+到最后一个了，就到第一个
  if (currentitem >= count)
   currentitem = 0;
  break;
  case right:// 如是向右滚动的，currentitem-1播放上一个
  currentitem--;

  // 如果-到低一个了，就到最后一个
  if (currentitem < 0)
   currentitem = count - 1;
  break;
 }
 setcurrentitem(currentitem);// 播放根据方向计算出来的position的item
 }

 // 这就是当可以循环播放的重点，每次播放完成后，再次开启一个定时任务
 start();
}

　　到这里其实我们已经实现轮播啦，但是我们在使用的时候发现存在一种情况，当我们用手指刚滑完一张，紧接着第二张又出来了，不卖关子了，原因就是我们手指滑动的时候private runnable player这个任务没有停止，所以我们在手指滑动时停止player，手指松开的时候再次开启player：

@override
protected void onfinishinflate() {
 addonpagechangelistener(new onpagechangelistener() {
 @override
 public void onpagescrolled(int position, float positionoffset, int positionoffsetpixels) {
 }

 @override
 public void onpageselected(int position) {
 }

 @override
 public void onpagescrollstatechanged(int state) {
  if (state == scroll_state_idle)
  start();
  else if (state == scroll_state_dragging)
  stop();
 }
 });
}

　　有些同学可能不知道为什么不在构造方法中而要在onfinishinflate中addonpagechangelistener，是因为这个方法会在view被加载完成后调用，所以我们在这里做一些初始化的工作比较合理。
　　自定义viewpager的完整代码如下：

package com.yolanda.autoviewpager;

import android.content.context;
import android.support.v4.view.pageradapter;
import android.support.v4.view.viewpager;
import android.util.attributeset;

/**
 * <p>用viewpager自定义的广告轮播器。</p>.
 * 
 * @author yolanda; 
 */
public class autoplayviewpager extends viewpager {

 public autoplayviewpager(context context) {
 super(context);
 }

 public autoplayviewpager(context context, attributeset attrs) {
 super(context, attrs);
 }

 /**
 * 播放时间
 */
 private int showtime = 3 * 1000;
 /**
 * 滚动方向
 */
 private direction direction = direction.left;
 /**
 * 设置播放时间，默认3秒
 *
 * @param showtimemillis 毫秒
 */
 public void setshowtime(int showtimemillis) {
 this.showtime = showtime;
 }

 /**
 * 设置滚动方向，默认向左滚动
 *
 * @param direction 方向
 */
 public void setdirection(direction direction) {
 this.direction = direction;
 }

 /**
 * 开始
 */
 public void start() {
 stop();
 postdelayed(player, showtime);
 }

 /**
 * 停止
 */
 public void stop() {
 removecallbacks(player);
 }

 /**
 * 播放上一个
 */
 public void previous() {
 if (direction == direction.right) {
  play(direction.left);
 } else if (direction == direction.left) {
  play(direction.right);
 }
 }

 /**
 * 播放下一个
 */
 public void next() {
 play(direction);
 }

 /**
 * 执行播放
 *
 * @param direction 播放方向
 */
 private synchronized void play(direction direction) {
 pageradapter pageradapter = getadapter();
 if (pageradapter != null) {
  int count = pageradapter.getcount();
  int currentitem = getcurrentitem();
  switch (direction) {
  case left:
   currentitem++;
   if (currentitem > count)
   currentitem = 0;
   break;
  case right:
   currentitem--;
   if (currentitem < 0)
   currentitem = count;
   break;
  }
  setcurrentitem(currentitem);
 }
 start();
 }

 /**
 * 播放器
 */
 private runnable player = new runnable() {
 @override
 public void run() {
  play(direction);
 }
 };

 public enum direction {
 /**
  * 向左行动，播放的应该是右边的
  */
 left,
  /**
  * 向右行动，播放的应该是左边的
  */
 right
 }

 @override
 protected void onfinishinflate() {
 super.onfinishinflate();
 addonpagechangelistener(new onpagechangelistener() {
  @override
  public void onpagescrolled(int position, float positionoffset, int positionoffsetpixels) {
  }

  @override
  public void onpageselected(int position) {
  }

  @override
  public void onpagescrollstatechanged(int state) {
  if (state == scroll_state_idle)
   start();
  else if (state == scroll_state_dragging)
   stop();
  }
 });
 }
}

如何使用

　　其实我们没有对viewpager做什么太大的干涉，所以我们使用和原生的没有什么区别。这里有几个注意的地方也写出来，免得有人踩坑。

如果使用自定viewpager

autoplayviewpager autoplayviewpage = (autoplayviewpager) findviewbyid(r.id.view_pager);
autoplayviewpage.setadapter(banneradapter);

// 以下两个方法不是必须的，因为有默认值
autoplayviewpage.setdirection(autoplayviewpager.direction.left);// 设置播放方向
autoplayviewpage.setcurrentitem(200); // 设置每个item展示的时间

autoplayviewpage.start(); // 开始轮播

如何优化adapter

　　其实我们看到就是多调用了一个star方法，但是还不够，我们在适配器中还要做一点点小事情。为了能让轮播无限循环，所以我们在getcount中返回int的最大值：

@override
public int getcount() {
 return resids == null ? 0 : integer.max_value;
}

　　resids是我们的数据源。该了这个count后，我们的instantiateitem()方法也要修改，不然会发生下标越界的异常，我们在拿到position后要做个处理：

@override
public object instantiateitem(viewgroup container, int position) {
 position = position % resids.size();
 object xxoo = resids.get(position);
 ...
}

本例代码源码：http://xiazai.jb51.net/201609/yuanma/autoviewpager(jb51.net).rar

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。