如何为AndroidX Camera的PreviewView添加圆角？

问题原因 #

PreviewView的相机预览画面绘制在内部Surface上，该Surface层级高于背景，单纯设置背景圆角只会显示背景的圆角样式，但预览内容仍为矩形，不会被自动裁剪。

解决方案 #

方案1：通过OutlineProvider裁剪PreviewView #

在Activity/Fragment中给PreviewView设置自定义OutlineProvider，强制裁剪预览内容：

val viewFinder = findViewById<PreviewView>(R.id.viewFinder)
viewFinder.clipToOutline = true
// 转换dp为像素，确保圆角大小适配不同屏幕
val radiusInPx = TypedValue.applyDimension(
    TypedValue.COMPLEX_UNIT_DIP,
    40f,
    resources.displayMetrics
)
viewFinder.outlineProvider = object : ViewOutlineProvider() {
    override fun getOutline(view: View, outline: Outline) {
        outline.setRoundRect(0, 0, view.width, view.height, radiusInPx)
    }
}

方案2：用父布局包裹实现裁剪 #

将PreviewView放入带圆角背景的ViewGroup中，开启父布局的裁剪功能：

<FrameLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@drawable/rounded"
    android:clipToOutline="true">

    <androidx.camera.view.PreviewView
        android:id="@+id/viewFinder"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>
</FrameLayout>

此时可直接使用你已有的rounded.xml作为父布局背景，无需复杂的layer-list组合。

方案3：简化背景Drawable（可选） #

若坚持用背景方式，先简化你的drawable文件，将rounded_inside_corners.xml替换为单一shape：

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="rectangle">
    <stroke android:width="2dp" android:color="#FFFFFFFF" />
    <corners android:radius="40dp"/>
    <solid android:color="#00000000" />
</shape>

然后给PreviewView添加android:clipToOutline="true"属性，确保预览内容被裁剪。

关键注意点 #

• 必须开启clipToOutline = true，才能让View的实际内容（包括Surface预览）被圆角裁剪
• 仅设置背景无法裁剪Surface层级的预览画面，必须通过Outline或父布局裁剪实现

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