如何使用PixelCopy保存ScrollView屏外不可见区域的完整视图截图

结论 #

无法通过PixelCopy实现截取ScrollView屏外不可见区域的需求

原因说明 #

PixelCopy的底层逻辑是直接读取当前Activity Window的渲染缓冲区像素，只有当前屏幕可见的内容才会被渲染到该缓冲区中。ScrollView未滚入可视区域的内容并不会被绘制到Window的渲染层，因此无论如何调整PixelCopy的截取范围，都无法获取到这部分未渲染的内容。

完整截图实现方案 #

你需要的获取整个ScrollView所有内容（含屏外区域）的需求，直接使用View绘制到自定义Canvas的方案即可实现，正确代码如下：

fun takeFullScrollViewScreenshot(scrollView: ScrollView): Bitmap {
    // 获取ScrollView内部子View的实际总高度
    val childView = scrollView.getChildAt(0)
    val fullHeight = childView.measuredHeight
    val fullWidth = scrollView.measuredWidth

    val bitmap = Bitmap.createBitmap(fullWidth, fullHeight, Bitmap.Config.ARGB_8888)
    val canvas = Canvas(bitmap)

    // 保存当前滚动位置，截图后恢复避免用户感知
    val currentScrollY = scrollView.scrollY
    scrollView.scrollTo(0, 0)
    // 绘制整个ScrollView内容到画布
    scrollView.draw(canvas)
    scrollView.scrollTo(0, currentScrollY)

    // 后续可自行将bitmap转为PNG保存
    return bitmap
}

两种截图方案的适用场景 #

• PixelCopy：仅适用于截取当前屏幕可见的窗口内容，针对SurfaceView、TextureView这类自带独立渲染图层的View，必须使用PixelCopy才能拿到正确的渲染结果，使用View.draw方案会得到空白内容。
• View.draw到Canvas：适用于普通View（包括ScrollView、LinearLayout等滚动/普通容器）的完整内容截取，只要View没有独立渲染图层都可以正常生效。

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