Android Kotlin RecyclerView 自动循环滚动实现指南

要实现 Android Kotlin 中的自动循环滚动的 RecyclerView，可以使用以下步骤：

首先，创建一个自定义的 RecyclerViewLayoutManager，该 LayoutManager 将支持循环滚动。可以使用LinearLayoutManager作为基类，然后在scrollHorizontallyBy()和scrollVerticallyBy()方法中添加循环滚动的逻辑。

class LoopLayoutManager(context: Context) : LinearLayoutManager(context) {

    private var isLoopEnabled = true

    override fun scrollHorizontallyBy(dx: Int, recycler: RecyclerView.Recycler?, state: RecyclerView.State?): Int {
        val scrolled = super.scrollHorizontallyBy(dx, recycler, state)
        
        if (isLoopEnabled && scrolled == 0 && dx != 0) {
            val sign = dx / Math.abs(dx)
            val itemCount = itemCount
            val lastVisibleItemPosition = findLastVisibleItemPosition()
            val firstVisibleItemPosition = findFirstVisibleItemPosition()
            
            if (sign > 0 && lastVisibleItemPosition >= itemCount - 1) {
                scrollToPosition(0)
            } else if (sign < 0 && firstVisibleItemPosition <= 0) {
                scrollToPosition(itemCount - 1)
            }
        }
        
        return scrolled
    }

    override fun scrollVerticallyBy(dy: Int, recycler: RecyclerView.Recycler?, state: RecyclerView.State?): Int {
        val scrolled = super.scrollVerticallyBy(dy, recycler, state)
        
        if (isLoopEnabled && scrolled == 0 && dy != 0) {
            val sign = dy / Math.abs(dy)
            val itemCount = itemCount
            val lastVisibleItemPosition = findLastVisibleItemPosition()
            val firstVisibleItemPosition = findFirstVisibleItemPosition()
            
            if (sign > 0 && lastVisibleItemPosition >= itemCount - 1) {
                scrollToPosition(0)
            } else if (sign < 0 && firstVisibleItemPosition <= 0) {
                scrollToPosition(itemCount - 1)
            }
        }
        
        return scrolled
    }

    fun enableLoop(enabled: Boolean) {
        isLoopEnabled = enabled
    }
}

在 Activity 或 Fragment 中，初始化 RecyclerView 和 Adapter，并将自定义的 LoopLayoutManager 设置给 RecyclerView。

val recyclerView: RecyclerView = findViewById(R.id.recyclerView)
val layoutManager = LoopLayoutManager(this)
recyclerView.layoutManager = layoutManager

val adapter = MyAdapter()
recyclerView.adapter = adapter

如果希望 RecyclerView 在触摸时停止滚动，可以使用addOnItemTouchListener()方法添加一个RecyclerView.OnItemTouchListener，在onInterceptTouchEvent()和onTouchEvent()方法中处理触摸事件。

recyclerView.addOnItemTouchListener(object : RecyclerView.OnItemTouchListener {
    override fun onInterceptTouchEvent(rv: RecyclerView, e: MotionEvent): Boolean {
        if (e.action == MotionEvent.ACTION_DOWN) {
            recyclerView.stopScroll()
        }
        return false
    }

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

    override fun onRequestDisallowInterceptTouchEvent(disallowIntercept: Boolean) {}
})

最后，如果希望 RecyclerView 支持快速滚动和滚动中的点击事件，可以使用setOnScrollChangeListener()方法添加一个View.OnScrollChangeListener，在onScrollChange()方法中处理滚动事件。

recyclerView.setOnScrollChangeListener { v, scrollX, scrollY, oldScrollX, oldScrollY ->
    // 处理滚动事件
}

adapter.setOnItemClickListener { position ->
    // 处理点击事件
}

这样就可以实现自动循环滚动、快速滚动、滚动中可点击、触摸停止滚动、松开继续滚动的 RecyclerView。