Android水平RecyclerView自动滑动异常加速 寻求最优实现方案

1. 水平RecyclerView基础实现 #

创建水平方向RecyclerView只需要在初始化时给控件配置水平方向的LayoutManager即可，步骤如下：

• 在布局文件中正常声明RecyclerView控件
• 代码初始化时配置水平LinearLayoutManager，核心配置代码：

// 第二个参数指定方向为水平，第三个参数关闭反向布局
val layoutManager = LinearLayoutManager(context, LinearLayoutManager.HORIZONTAL, false)
rcvHomeItems.layoutManager = layoutManager
// 后续正常绑定适配器即可
rcvHomeItems.adapter = yourAdapter

2. 现有代码的异常加速根因 #

非预期加速问题由三个实现缺陷导致：

• 重复注册滚动监听：每次调用handleScroll都会给RecyclerView新增一个OnScrollListener，多次调用后滑动事件会触发多份回调，重复提交滑动任务
• 任务管理混乱：存在多个Handler实例，没有统一管理轮播任务，多个延迟任务同时排队执行就会出现滑动速度异常
• 末尾重置逻辑不合理：滑到末尾时直接置空adapter再刷新会触发布局重绘、监听重复触发等连锁问题，进一步加剧任务调度混乱

3. 稳定自动轮播实现方案 #

实现稳定无异常的自动轮播遵循几个核心原则：

• 全局只注册一次滚动/触摸监听，不要在数据绑定、ViewHolder复用逻辑里重复添加监听
• 用同一个主线程Handler统一管理所有轮播任务，在页面销毁、控件回收时必须移除所有待执行任务
• 处理用户触摸冲突：用户手动滑动时暂停轮播，手指离开后恢复，避免滑动打架
• 末尾轮播回开头使用平滑滑动，不要通过重置adapter实现

完整可直接复用的实现代码如下：

// 轮播间隔时间，可根据业务需求调整
private const val AUTO_SCROLL_DELAY = 3000L
// 主线程Handler统一管理轮播任务，不要在回调里新建Handler
private val autoScrollHandler = Handler(Looper.getMainLooper())
private var isUserTouching = false
private lateinit var rcvHomeItems: RecyclerView

/**
 * 启动自动轮播，仅在adapter数据加载完成、RecyclerView初始化完成后调用一次
 */
private fun startAutoScroll() {
    stopAutoScroll()
    autoScrollHandler.postDelayed(autoScrollRunnable, AUTO_SCROLL_DELAY)
}

/**
 * 停止自动轮播，在onDestroy、View回收时必须调用
 */
private fun stopAutoScroll() {
    autoScrollHandler.removeCallbacks(autoScrollRunnable)
}

// 轮播执行任务
private val autoScrollRunnable = object : Runnable {
    override fun run() {
        val layoutManager = rcvHomeItems.layoutManager as? LinearLayoutManager ?: run {
            autoScrollHandler.postDelayed(this, AUTO_SCROLL_DELAY)
            return
        }
        val itemCount = layoutManager.itemCount
        if (itemCount <= 0 || isUserTouching) {
            // 无数据或用户正在触摸时跳过本次滑动，等待下一次调度
            autoScrollHandler.postDelayed(this, AUTO_SCROLL_DELAY)
            return
        }
        val lastVisiblePos = layoutManager.findLastCompletelyVisibleItemPosition()
        if (lastVisiblePos == itemCount - 1) {
            // 滑到最后一项时平滑回到第一项，无需重置adapter
            rcvHomeItems.smoothScrollToPosition(0)
        } else {
            // 正常滑到下一项
            rcvHomeItems.smoothScrollToPosition(lastVisiblePos + 1)
        }
        autoScrollHandler.postDelayed(this, AUTO_SCROLL_DELAY)
    }
}

// 初始化时一次性添加触摸监听，处理用户手动滑动场景
private fun initTouchListener() {
    rcvHomeItems.addOnItemTouchListener(object : RecyclerView.OnItemTouchListener {
        override fun onInterceptTouchEvent(rv: RecyclerView, e: MotionEvent): Boolean {
            when (e.action) {
                MotionEvent.ACTION_DOWN, MotionEvent.ACTION_MOVE -> {
                    isUserTouching = true
                }
                MotionEvent.ACTION_UP, MotionEvent.ACTION_CANCEL -> {
                    isUserTouching = false
                }
            }
            return false
        }

        override fun onTouchEvent(rv: RecyclerView, e: MotionEvent) {}
        override fun onRequestDisallowInterceptTouchEvent(disallowIntercept: Boolean) {}
    })
}

如果需要实现无限轮播效果，只需要在Adapter中重写getItemCount()返回一个极大值（比如Int.MAX_VALUE），初始化时将RecyclerView默认定位到中间位置即可，不需要额外处理末尾重置逻辑。

内容的提问来源于stack exchange，提问作者Aashis