如何为Android智能眼镜的PDF阅读器实现类触摸式程序化滚动？

针对智能眼镜设备上AndroidPdfViewer无法触摸滚动、跨页跳转生硬的问题，可通过平滑滚动动画+跨页过渡延迟的方式模拟原生触摸滚动的连贯效果，替代直接生硬的页面跳转。

核心问题分析 #

• 直接调用scrollTo或修改scrollY仅能实现单页内的瞬时滚动，没有过渡动画
• 用jumpTo切换页面时无缓冲，导致页面跳转生硬，缺乏触摸滚动的连贯性

实现思路 #

1. 使用ValueAnimator实现scrollY的平滑过渡，模拟触摸滚动的自然动效
2. 以页面实际高度为判断依据，精准识别当前页是否滚动到底
3. 当前页滚动完成后，延迟启动下一页的滚动，避免跳转突兀
4. 统一控制滚动速度，保持不同页面间的滚动体验一致

完整代码实现 #

import android.animation.Animator
import android.animation.ValueAnimator
import com.github.barteksc.pdfviewer.PDFView

// 封装顺滑滚动方法
private fun smoothScrollPdf() {
    val pdfView = binding.pdfView
    val currentPage = pdfView.currentPage
    val pageHeight = pdfView.getPageHeight(currentPage)
    val currentScrollY = pdfView.scrollY

    // 计算当前页剩余可滚动距离
    val remainingScroll = pageHeight - currentScrollY

    if (remainingScroll > 0) {
        // 当前页未滚动到底，启动平滑滚动动画
        ValueAnimator.ofInt(currentScrollY, pageHeight).apply {
            // 控制滚动速度：每像素耗时2ms，可根据需求调整
            duration = (remainingScroll * 2).toLong()
            addUpdateListener { animation ->
                val targetScrollY = animation.animatedValue as Int
                pdfView.scrollTo(0, targetScrollY)
            }
            addListener(object : Animator.AnimatorListener {
                override fun onAnimationEnd(animation: Animator) {
                    // 当前页滚动完成，检查是否有下一页
                    if (currentPage < pdfView.pageCount - 1) {
                        // 跳转到下一页并重置滚动位置
                        pdfView.jumpTo(currentPage + 1)
                        pdfView.scrollY = 0
                        // 延迟100ms启动下一页滚动，模拟触摸滚动的连贯性
                        pdfView.postDelayed({ smoothScrollPdf() }, 100)
                    }
                }
                override fun onAnimationStart(animation: Animator) {}
                override fun onAnimationCancel(animation: Animator) {}
                override fun onAnimationRepeat(animation: Animator) {}
            })
            start()
        }
    } else {
        // 当前页已滚动到底，直接处理下一页
        if (currentPage < pdfView.pageCount - 1) {
            pdfView.jumpTo(currentPage + 1)
            pdfView.scrollY = 0
            smoothScrollPdf()
        }
    }
}

关键优化点 #

• 精准滚动判断：使用pdfView.getPageHeight(currentPage)获取页面实际高度，避免控件padding等干扰
• 速度控制：通过duration = (remainingScroll * 2).toLong()统一滚动速度，确保不同长度页面的滚动体验一致
• 过渡延迟：postDelayed的100ms延迟模拟了触摸滚动时页面切换的自然缓冲，避免生硬跳转
• 递归调用：动画结束后自动触发下一页滚动，实现全文档连贯滚动

使用方式 #

在需要启动滚动的场景（如语音指令、按键触发）调用smoothScrollPdf()即可，若需要停止滚动，可添加全局标志位在动画中判断取消。

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