Android輪播圖控件的實現詳解(附GitHub開源連接)

輪播圖在Android開發中是很是常見的控件，通常App的首頁廣告和電商類App的商品詳情圖片都會用輪播圖來實現。但是Android源生的控件中卻沒有能直接拿來使用的輪播圖控件，因此通常的輪播圖效果都須要咱們本身去實現。今天我就給你們介紹一個我本身寫的輪播圖控件：CustomBanner。有須要的同窗能夠直接訪問個人GitHub使用該控件。下面我將爲你們詳細介紹CustomBanner控件的實現思路和細節。
（說明：下面我貼出來的代碼只是CustomBanner的代碼摘要，想要看完整源碼的同窗請到GitHub下載或引用依賴）

一、佈局
輪播圖通常由一個能夠左右滾動、承載圖片的主體控件和一個顯示當前位置的指示器組成。CustomBanner的佈局很是簡單，直接繼承FrameLayout，內部添加兩個子View：一個ViewPager(能夠左右滾動、承載圖片的主體控件)和一個LinearLayout(指示器容器)。

public class CustomBanner<T> extends FrameLayout {

    private ViewPager mBannerViewPager;
    private LinearLayout mIndicatorLayout;

    //添加輪播圖ViewPager
    private void addBannerViewPager(Context context) {
        mBannerViewPager = new ViewPager(context);
        this.addView(mBannerViewPager);
    }

    //添加輪播圖指示器容器
    private void addIndicatorLayout(Context context) {
        mIndicatorLayout = new LinearLayout(context);
        LayoutParams lp = new LayoutParams(LayoutParams.WRAP_CONTENT, LayoutParams.WRAP_CONTENT);
        lp.gravity = analysisGravity(mIndicatorGravity);
        lp.setMargins(0, 0, 0, DensityUtils.dp2px(context, 8));
        mIndicatorLayout.setGravity(Gravity.CENTER);
        this.addView(mIndicatorLayout, lp);
    }
}複製代碼

二、實現輪播圖的無限循環
輪播圖是須要左右無限循環滾動的，而ViewPager是有滾動邊界的。爲了實現ViewPager循環滾動，我採用了網上一個很巧妙的實現方式。就是ViewPager的實際長度是它的應有長度+2，在ViewPager的應有長度的頭尾各加一個節點。頭節點的數據跟ViewPager的最後一個數據同樣，尾節點的數據跟ViewPager的第一個數據同樣。當ViewPager滾動到尾節點時，就無縫跳轉到第一個數據，當ViewPager滾動到頭節點時，就無縫跳轉到最後一個數據，因爲跳轉的兩節點的數據是同樣的，並且是無縫跳轉，沒有過分動畫，因此用戶感受不到ViewPager的顯示節點已經改變，就給用戶一種ViewPager在無限循環的錯覺。具體請看這裏。
因爲多加了兩個節點，因此在處理ViewPager的position時，實際的position和用戶所看到的position是不同的。好比：輪播圖有5張圖片，用戶看到的也應該是5張圖片，而實際上咱們的ViewPager會有7張圖片，由於第1張圖片和第6張圖片是同一張圖片，第7張圖片和第2張圖片是同一張圖片。這裏可能很很差理解，可是必定要理解，由於這是實現輪播圖循環輪播的關鍵。

//ViewPager的實際長度是他的數據的長度+2
     @Override
    public int getCount() {
        return mDatas == null || mDatas.isEmpty() ? 0 : mDatas.size() + 2;
    }複製代碼

//經過實際的position計算用戶所理解的position
private int getActualPosition(int position) {
        if (position == 0) {
            //若是是頭節點，返回最後一個數據的position
            //由於頭節點的數據和最後一個數據是同樣的。
            return mDatas.size() - 1;
        } else if (position == getCount() - 1) {
            //若是是尾節點，返回第一個數據的position
            //由於尾節點的數據和第一個數據是同樣的。
            return 0;
        } else {
            //除了頭尾之外，position節點的數據是mDatas中的第position - 1的下標的數據
            return position - 1;
        }
    }複製代碼

三、設置ViewPager的滾動速度
ViewPager有本身的mScroller屬性，負責控制ViewPager的滾動速度。可是ViewPager的默認滾動速度太快了，並且ViewPager並無提供方法設置mScroller的滾動速度也沒有提供方法設置mScroller，因此咱們須要經過反射用本身的mScroller替換掉ViewPager的mScroller，使咱們能夠徹底控制和操做ViewPager的mScroller屬性。這不只僅是實現咱們自定義ViewPager的滾動速度，也是實現第2步中ViewPager無縫跳轉的關鍵。

//經過反射替換掉mBannerViewPager的mScroller屬性
    private void replaceViewPagerScroll() {
        try {
            Field field = ViewPager.class.getDeclaredField("mScroller");
            field.setAccessible(true);
            mScroller = new ViewPagerScroller(mContext,
                    new AccelerateInterpolator());
            field.set(mBannerViewPager, mScroller);
        } catch (Exception e) {
        }
    }

    /** * 設置輪播圖的滾動速度 * * @param scrollDuration */
    public CustomBanner<T> setScrollDuration(int scrollDuration) {
        mScroller.setScrollDuration(scrollDuration);
        return this;
    }複製代碼

public class ViewPagerScroller extends Scroller {

    private int mScrollDuration = 550;
    //是否無縫跳轉
    private boolean sudden;

    public ViewPagerScroller(Context context) {
        super(context);
    }

    public ViewPagerScroller(Context context, Interpolator interpolator) {
        super(context, interpolator);
    }

    public ViewPagerScroller(Context context, Interpolator interpolator, boolean flywheel) {
        super(context, interpolator, flywheel);
    }

    @Override
    public void startScroll(int startX, int startY, int dx, int dy, int duration) {
        super.startScroll(startX, startY, dx, dy, sudden ? 0 : mScrollDuration);
    }

    @Override
    public void startScroll(int startX, int startY, int dx, int dy) {
        super.startScroll(startX, startY, dx, dy, sudden ? 0 : mScrollDuration);
    }

    public int getScrollDuration() {
        return mScrollDuration;
    }

    public void setScrollDuration(int scrollDuration) {
        this.mScrollDuration = scrollDuration;
    }

    public boolean isSudden() {
        return sudden;
    }

    public void setSudden(boolean zero) {
        this.sudden = zero;
    }
}複製代碼

四、實現ViewPager的自動輪播
這個實現起來很是的簡單。直接利用Handler延遲發送消息的功能來進行輪播滾動的計時，在消息的處理中改變ViewPager顯示的Item，達到ViewPager的自動滾動效果，而後再Handler發送一個延遲消息，造成循環。

private Handler mTimeHandler = new Handler();
    private Runnable mTurningTask = new Runnable() {
        @Override
        public void run() {
            if (isTurning && mBannerViewPager != null) {
                int page = mBannerViewPager.getCurrentItem() + 1;
                mBannerViewPager.setCurrentItem(page);
                mTimeHandler.postDelayed(mTurningTask, mIntervalTime);
            }
        }
    };

    /** * 啓動輪播 * @param intervalTime 輪播間隔時間 * @return */
    public CustomBanner<T> startTurning(long intervalTime) {
        isTurning = true;
        mIntervalTime = intervalTime;
        mTimeHandler.postDelayed(mTurningTask, mIntervalTime);
        return this;
    }複製代碼

五、添加和更新指示器
指示器的指示點用指示器容器mIndicatorLayout來承載，當ViewPager滾動的時候，指示器也要相應的作更新

//根據輪播圖的數量來添加指示器的點
    //指示器的點用ImageView來表示，樣式由使用者自定義
    private void initIndicator(int count) {
        mIndicatorLayout.removeAllViews();
        if (count > 0) {
            for (int i = 0; i < count; i++) {
                ImageView imageView = new ImageView(mContext);
                LinearLayout.LayoutParams lp = new LinearLayout.LayoutParams(
                ViewGroup.LayoutParams.WRAP_CONTENT, ViewGroup.LayoutParams.WRAP_CONTENT);
0, DensityUtils.dp2px(mContext, 2), 0);
                mIndicatorLayout.addView(imageView, lp);
            }
        }
    }

    /** * 更新指示器 */
    private void updateIndicator() {
        int count = mIndicatorLayout.getChildCount();
        //獲取ViewPager當前顯示的Item。
        int currentPage = getCurrentItem();
        if (count > 0) {
            for (int i = 0; i < count; i++) {
                ImageView view = (ImageView) mIndicatorLayout.getChildAt(i);
                if (i == currentPage) {
                    //設置選中樣式
                    view.setImageResource(mIndicatorSelectRes);
                } else {
                    //設置未選中樣式
                    view.setImageResource(mIndicatorUnSelectRes);
                }
            }
        }
    }複製代碼

六、設置輪播圖數據
把輪播圖的基本功能都實現了以後，接下來就是填充數據了。下面先看設置數據的方法：

/** * 設置輪播圖數據 * @param creator 建立和更新輪播圖View的接口 * @param data 輪播圖數據 * @return */
    public CustomBanner<T> setPages(ViewCreator<T> creator, List<T> data) {
        mAdapter = new BannerPagerAdapter<T>(mContext, creator, data);
        mBannerViewPager.setAdapter(mAdapter);
        return this;
    }複製代碼

代碼很是的簡單，其實就是給mBannerViewPager設置了一個Adapter。上面的setPages方法接收兩個參數：
一、creator：這是一個ViewCreator對象，ViewCreator是負責建立和更新輪播圖的接口。
二、data：這是輪播圖的數據。
他們的泛型T是輪播圖的數據類型，輪播圖的數據類型能夠是任何的類型。
下面是ViewCreator接口代碼

/** * 建立和更新輪播圖View的接口 * @param <T> */
    public interface ViewCreator<T> {
        //建立輪播圖的每一個項的View
        View createView(Context context, int position);
        //更新輪播圖
        void updateUI(Context context, View view, int position, T data);
    }複製代碼

createView方法的返回值是View而不是ImageView，因此CustomBanner能夠支持輪播全部的佈局，而不只僅是ImageView，雖然咱們大部分狀況使用的都是ImageView。
若是你如今還不清楚ViewCreator是幹什麼的，那麼請看下面的代碼。下面是輪播圖適配器BannerPagerAdapter的核心代碼，經過這段代碼，你應該就能很清晰的理解ViewCreator的做用了。

@Override
    public Object instantiateItem(ViewGroup container, final int position) {

        View view = views.get(position);

        if (view == null) {
            //mCreator就是調用者傳入的ViewCreator對象
            //經過mCreator建立輪播圖的佈局，因此輪播圖的佈局是由調用者建立的
            view = mCreator.createView(mContext, position);
            views.put(position, view);
        }

        final int item = getActualPosition(position);
        final T t = mData.get(item);

        //經過mCreator把更新輪播圖數據的操做交給調用者去實現
        mCreator.updateUI(mContext, view, item, t);
        container.addView(view);
        return view;
    }複製代碼

CustomBanner的實現思路和代碼分析到這裏就結束了。相信如今你們對於輪播圖的實現已經有了必定的瞭解了。至於CustomBanner的使用，我將在下一章《Android輪播圖控件CustomBanner的使用講解》具體講解，歡迎閱讀。下面先給你們看一下CustomBanner的效果：

演示.gif

上面貼出來的代碼只是CustomBanner的代碼摘要，完整的代碼請訪問我在GitHub中的CustomBanner項目。

文章已同步到個人CSDN博客