有人在Compose应用中成功实现Android12滚动截图的ScrollCaptureCallback吗？

View体系下的基础实现 #

虽然官方对ScrollCaptureCallback的文档不够详尽，但核心逻辑是给可滚动View绑定回调，让系统能控制滚动并捕获每一帧内容。以RecyclerView为例：

// 提前保存初始滚动位置
val originalScrollY = recyclerView.scrollY

recyclerView.setScrollCaptureCallback(object : ScrollCaptureCallback() {
    override fun onScrollCaptureStart(
        session: ScrollCaptureSession,
        bounds: Rect
    ): Rect {
        // 返回当前可滚动区域的真实边界，系统基于此捕获内容
        return Rect(0, 0, recyclerView.width, recyclerView.height)
    }

    override fun onScrollCaptureProgress(
        session: ScrollCaptureSession,
        request: ScrollCaptureRequest,
        destination: Surface
    ) {
        // 控制RecyclerView滚动到系统请求的位置
        val targetY = request.scrollOffset.y
        recyclerView.scrollTo(0, targetY)
        // 通知系统当前帧已准备好，自动完成捕获
        session.notifyCaptureProgress(request, destination)
    }

    override fun onScrollCaptureEnd(session: ScrollCaptureSession) {
        // 结束后恢复初始滚动位置
        recyclerView.scrollTo(0, originalScrollY)
    }
})

Compose页面的适配方案（无需全量转View） #

不用把整个页面改成View体系，可通过AndroidView包装需要滚动截图的区域，将Composable嵌入到支持滚动捕获的View中：

@Composable
fun ScrollCaptureLazyColumn() {
    AndroidView(
        factory = { context ->
            val nestedScrollView = NestedScrollView(context).apply {
                isFillViewport = true
                // 给NestedScrollView绑定滚动捕获回调
                setScrollCaptureCallback(object : ScrollCaptureCallback() {
                    override fun onScrollCaptureStart(session: ScrollCaptureSession, bounds: Rect): Rect {
                        return Rect(0, 0, width, height)
                    }

                    override fun onScrollCaptureProgress(
                        session: ScrollCaptureSession,
                        request: ScrollCaptureRequest,
                        destination: Surface
                    ) {
                        scrollTo(0, request.scrollOffset.y)
                        session.notifyCaptureProgress(request, destination)
                    }

                    override fun onScrollCaptureEnd(session: ScrollCaptureSession) {
                        // 恢复初始滚动状态
                        scrollTo(0, 0)
                    }
                })
            }
            // 将Composable嵌入到ComposeView，再添加到NestedScrollView
            val composeView = ComposeView(context).apply {
                setContent {
                    LazyColumn {
                        items(100) { index ->
                            Text(text = "Item $index", modifier = Modifier.padding(16.dp))
                        }
                    }
                }
            }
            nestedScrollView.addView(composeView)
            nestedScrollView
        }
    )
}

这种方式既保留Compose的开发体验，又能让系统识别到可滚动捕获的View节点。

关键踩坑点 #

• 屏幕层级问题：确保目标View没有被Dialog、PopupWindow或其他悬浮View遮挡，系统只会捕获最上层的可滚动View内容
• 滚动边界准确性：onScrollCaptureStart返回的Rect必须是View的真实可视区域，否则会导致截图内容偏移或缺失
• 状态同步：如果Composable中有动态内容，要确保滚动时内容已完全渲染，避免截图出现空白或加载中的状态

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