Android实现带指示器的自动轮播式ViewPager

下面我将为大家详细讲解“Android实现带指示器的自动轮播式ViewPager”的完整攻略，过程中会包含两条示例说明。这个攻略方便在Android开发中需要实现轮播图时候使用。

1.需求分析

首先我们需要明确我们这个轮播ViewPager的需求：

1. 实现自动轮播效果
2. 有指示器控件
3. 滑动时支持循环播放
4. 能够手动屏蔽轮播或启用轮播
5. 提供接口用于外部的操作

有了需求目标，我们接下来就可以进行实现了。

2.实现

首先，我们需要在项目中导入ViewPager的依赖，如下所示：

implementation 'androidx.viewpager2:viewpager2:1.0.0'

在布局文件中，我们需要放置ViewPager控件和其它控件，比如指示器等。示例代码如下：

<androidx.viewpager2.widget.ViewPager2
    android:id="@+id/viewPager2"
    android:layout_width="match_parent"
    android:layout_height="200dp" />

<LinearLayout
    android:id="@+id/indicator"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:layout_marginTop="8dp"
    android:gravity="center"
    android:orientation="horizontal" />

接下来我们需要创建一个Adapter，用于展示ViewPager的内容，代码如下：

public class MyPagerAdapter extends RecyclerView.Adapter<MyPagerAdapter.ViewHolder> {

    private List<Integer> images;

    public MyPagerAdapter(List<Integer> images) {
        this.images = images;
    }

    @NonNull
    @Override
    public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.pager_item, parent, false);
        return new ViewHolder(view);
    }

    @Override
    public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
        holder.imageView.setImageResource(images.get(position % images.size()));
    }

    @Override
    public int getItemCount() {
        return Integer.MAX_VALUE;
    }

    static class ViewHolder extends RecyclerView.ViewHolder {

        ImageView imageView;

        public ViewHolder(@NonNull View itemView) {
            super(itemView);
            imageView = itemView.findViewById(R.id.image_view);
        }
    }
}

Adapter内部包含了展示ViewPager的图片集合。由于ViewPager要求至少有3张以上的图片才能实现循环滑动，这里我们使用了Integer.MAX_VALUE的数量作为视图总个数，这样就能够实现无限循环了。

然后，我们在Activity中进行ViewPager的初始化和操作，代码如下：

public class MainActivity extends AppCompatActivity {

    private ViewPager2 viewPager2;
    private LinearLayout indicatorLayout;
    private List<Integer> mData = Arrays.asList(R.mipmap.img1, R.mipmap.img2, R.mipmap.img3, R.mipmap.img4);
    private Handler mHandler = new Handler();

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        viewPager2 = findViewById(R.id.viewPager2);
        indicatorLayout = findViewById(R.id.indicator);
        viewPager2.setAdapter(new MyPagerAdapter(mData));
        viewPager2.setOffscreenPageLimit(1);  // 设置缓存页数
        addIndicator();  // 添加指示器
        mHandler.postDelayed(mRunnable, 2000);  // 开启自动轮播
        viewPager2.registerOnPageChangeCallback(mOnPageChangeCallback);  // 监听页面切换事件
    }

    // 添加指示器
    private void addIndicator() {
        for (int i = 0; i < mData.size(); i++) {
            ImageView imageView = new ImageView(this);
            imageView.setScaleType(ImageView.ScaleType.CENTER_CROP);
            imageView.setImageResource(R.drawable.indicator_selector);
            LinearLayout.LayoutParams layoutParams = new LinearLayout.LayoutParams(
                    LinearLayout.LayoutParams.WRAP_CONTENT, LinearLayout.LayoutParams.WRAP_CONTENT);
            layoutParams.leftMargin = 6;
            layoutParams.rightMargin = 6;
            if (i == 0) {
                imageView.setSelected(true);
            }
            indicatorLayout.addView(imageView, layoutParams);
        }
    }

    // 自动轮播
    private Runnable mRunnable = new Runnable() {
        @Override
        public void run() {
            int currentItem = viewPager2.getCurrentItem();
            currentItem++;
            viewPager2.setCurrentItem(currentItem);
            mHandler.postDelayed(mRunnable, 2000);
        }
    };

    // 页面切换事件监听
    private RecyclerView.OnPageChangeCallback mOnPageChangeCallback = new RecyclerView.OnPageChangeCallback() {
        @Override
        public void onPageSelected(int position) {
            // 更新指示器
            int count = indicatorLayout.getChildCount();
            for (int i = 0; i < count; i++) {
                indicatorLayout.getChildAt(i).setSelected(i == position % mData.size());
            }
        }
    };

    @Override
    protected void onDestroy() {
        mHandler.removeCallbacks(mRunnable);
        super.onDestroy();
    }
}

在Activity中，我们首先初始化了ViewPager和指示器，并调用了addIndicator()方法添加指示器；接着注册了一个RecyclerView.OnPageChangeCallback监听页面切换事件，并在其中更新了指示器的状态，保证能够随着页面的切换而更新指示器。最后在onDestroy()方法中记得把自动轮播的runnable从Handler中移除，避免内存泄漏的问题。

3.总结

通过以上的实现步骤，我们已经完成了一个Android实现带指示器的自动轮播式ViewPager控件。通过Adapter的设计，能够方便的展示图片、设置缓存页数、实现无限循环等效果，通过Handler的操作，能够方便的实现自动轮播和更新指示器状态，这些都让我们能够轻松的在项目中实现类似的轮播效果。

以上就是关于“Android实现带指示器的自动轮播式ViewPager”的完整攻略的讲解，完整示例代码可以参考本文，希望对大家有所帮助。