Android CameraX PreviewView：如何获取实际相机画面的边界？

核心逻辑 #

你设置了scaleType="fitCenter"且固定16:9预览比例，相机画面会居中显示、上下留空。要拿到实际画面的边界，有两种可靠方式：

方式一：监听预览输出更新（推荐） #

PreviewView在相机预览就绪后，会自动计算适配后的显示区域，直接通过API获取即可：

// 用Jetpack Lifecycle监听预览流状态
previewView.previewStreamState.observe(viewLifecycleOwner) { state ->
    if (state is PreviewStreamState.StreamAvailable) {
        // state.surfaceFrame就是实际相机画面在PreviewView内的边界Rect
        val actualPreviewRect = state.surfaceFrame
        // 用这个Rect更新你的人脸框、网格线等叠加视图
        updateOverlayViews(actualPreviewRect)
    }
}

或者通过OnPreviewOutputUpdateListener处理：

previewView.setOnPreviewOutputUpdateListener { output ->
    // 获取适配后的Surface区域
    val surfaceRect = previewView.getChildAt(0).clipBounds
    // 转换为PreviewView坐标系下的Rect
    val actualPreviewRect = Rect(surfaceRect)
    // 调整叠加视图的布局参数
    overlayView.apply {
        layoutParams = LayoutParams(actualPreviewRect.width(), actualPreviewRect.height()).apply {
            leftMargin = actualPreviewRect.left
            topMargin = actualPreviewRect.top
        }
    }
}

方式二：手动计算适配区域 #

如果需要自己推导，根据PreviewView的宽高和16:9比例计算：

// 确保在PreviewView布局完成后调用（比如在view.post{}内）
previewView.post {
    val parentWidth = previewView.width
    val parentHeight = previewView.height
    val aspectRatio = 16f / 9f

    val actualWidth: Int
    val actualHeight: Int
    val left: Int
    val top: Int

    // 判断是宽度还是高度优先适配
    if (parentWidth / aspectRatio <= parentHeight) {
        actualWidth = parentWidth
        actualHeight = (parentWidth / aspectRatio).toInt()
        left = 0
        top = (parentHeight - actualHeight) / 2
    } else {
        actualHeight = parentHeight
        actualWidth = (parentHeight * aspectRatio).toInt()
        left = (parentWidth - actualWidth) / 2
        top = 0
    }

    val actualPreviewRect = Rect(left, top, left + actualWidth, top + actualHeight)
    // 更新叠加视图
    updateOverlayViews(actualPreviewRect)
}

关键注意点 #

• 必须在PreviewView完成布局后执行计算，否则获取的宽高为0
• 切换相机（前后置）或修改预览比例后，需要重新计算或监听预览输出更新

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