如何实现RecyclerView自动滚动与音频播放进度同步

核心思路 #

提前为列表每个条目绑定对应音频片段的起止时间戳，监听音频实时播放进度匹配对应条目，触发列表滚动到目标位置。

具体实现步骤 #

1. 绑定条目与音频时间戳 #

首先在列表数据结构中新增每个条目对应的音频时间区间字段，示例数据类：

// 时间单位统一用毫秒，避免换算误差
data class AudioItemBean(
    val content: String, // 条目展示的文本/其他内容
    val startMs: Long, // 对应音频片段的开始时间
    val endMs: Long // 对应音频片段的结束时间
)

所有条目的时间区间要覆盖完整的音频总时长，避免出现进度匹配不到的情况。

2. 监听音频实时播放进度 #

根据你使用的播放器类型（MediaPlayer/ExoPlayer/其他自定义播放器），设置进度监听，推荐每隔100ms获取一次当前播放进度即可，间隔过短会导致不必要的性能损耗：

• 若使用ExoPlayer，可通过addAnalyticsListener回调或者固定间隔轮询player.currentPosition获取进度
• 若使用原生MediaPlayer，可通过Timer定时任务每隔100ms取一次currentPosition

3. 匹配当前播放对应条目 #

每次拿到播放进度后，匹配对应的条目位置：

1. 优先校验当前进度是否还在上一次匹配到的条目时间区间内，如果是则无需重新匹配，减少性能消耗
2. 若不在上一条的区间内，遍历数据集找到第一个满足startMs ≤ 当前进度 ≤ endMs的条目，记录其position

4. 触发列表滚动到目标位置 #

如果匹配到的position和上一次滚动的position不一致，才触发滚动逻辑，避免列表反复抖动。
如果需要让目标条目固定停在列表的指定位置（比如演示效果中停在列表上部），使用scrollToPositionWithOffset方法自定义偏移量：

val layoutManager = recyclerView.layoutManager as LinearLayoutManager
// 自定义偏移量：此处设置为列表高度的1/4，可根据需求调整目标停留位置
val targetOffset = recyclerView.height / 4
// 无动画直接滚动
layoutManager.scrollToPositionWithOffset(targetPosition, targetOffset)

// 如需平滑滚动，使用自定义平滑滚动器调整滚动速度
val smoothScroller = object : LinearSmoothScroller(context) {
    override fun calculateSpeedPerPixel(displayMetrics: DisplayMetrics): Float {
        // 数值越大滚动速度越慢，可按需调整
        return 40f / displayMetrics.density
    }
}
smoothScroller.targetPosition = targetPosition
layoutManager.startSmoothScroll(smoothScroller)

常用优化点 #

• 音频快进、快退操作完成后，主动触发一次进度匹配与滚动，无需等待定时轮询，降低操作延迟
• 监听RecyclerView的滚动状态，用户手动拖动列表时暂时关闭自动滚动，用户松手列表静止后再恢复自动滚动，避免操作冲突
• 新增当前播放条目高亮逻辑：在Adapter中添加currentPlayPosition字段，匹配到新的条目后更新该字段并调用notifyItemChanged，为当前条目设置特殊高亮样式

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