Android端OpenCV CameraView适配问题：三星设备有黑边如何兼容全机型？

你的问题是代码逻辑缺陷和设备硬件差异共同导致的，具体原因如下：

• 分辨率选择逻辑不合理：直接取支持预览尺寸列表的中间档位，没有考虑不同厂商返回的分辨率列表排序规则不同，三星返回的列表中间值的宽高比，大概率和你需要的1:1比例、CameraView控件的宽高比不匹配，比例不匹配时就会出现黑边或裁切。而小米、realme的列表排序刚好让你拿到了比例匹配的尺寸，所以显示正常。
• setMaxFrameSize使用方式不符合预期：该参数的作用是限制OpenCV返回预览帧的最大尺寸，不是用来做1:1比例裁剪的，不同厂商相机底层对该参数的适配逻辑不同，三星设备不会自动将非1:1的预览帧裁剪为1:1，就会出现黑边。
• 设备底层相机实现差异：三星的相机硬件默认的预览裁切、缩放策略和其他安卓品牌不同，对非标准比例的预览尺寸适配性更差。

1. 优化预览分辨率选择逻辑 #

不要直接取列表中间值，改为筛选和目标比例最匹配的尺寸，示例逻辑如下：

// 目标比例，你需要1:1就传1f，要匹配控件比例就传（控件宽/控件高），注意竖屏要先转方向
private Camera.Size getOptimalSize(List<Camera.Size> supportSizes, float targetRatio) {
    Camera.Size optimalSize = null;
    float minDiff = Float.MAX_VALUE;
    // 可以加最低分辨率限制，避免选到太模糊的尺寸
    int minWidth = 720;
    for (Camera.Size size : supportSizes) {
        // 相机返回的尺寸是宽>高，竖屏使用时要翻转宽高计算比例
        float ratio = (float) size.width / size.height;
        float diff = Math.abs(ratio - targetRatio);
        if (diff < minDiff && size.width >= minWidth) {
            minDiff = diff;
            optimalSize = size;
        }
    }
    // 没找到匹配的就选第一个尺寸
    if (optimalSize == null) {
        optimalSize = supportSizes.get(0);
    }
    return optimalSize;
}

2. 正确实现1:1预览裁剪 #

不要通过setMaxFrameSize实现比例控制，改为在预览回调中自行裁剪帧：

@Override
public Mat onCameraFrame(CameraBridgeViewBase.CvCameraViewFrame inputFrame) {
    Mat frame = inputFrame.rgba();
    // 裁剪为1:1比例，取中间区域
    int cut = Math.abs(frame.width() - frame.height()) / 2;
    Mat squareFrame;
    if (frame.width() > frame.height()) {
        squareFrame = frame.submat(0, frame.height(), cut, frame.width() - cut);
    } else {
        squareFrame = frame.submat(cut, frame.height() - cut, 0, frame.width());
    }
    // 后续业务直接使用squareFrame即可
    return squareFrame;
}

3. 统一缩放和方向配置 #

• 给CameraView固定缩放模式：如果需要预览无黑边满屏显示，设置mCameraView.setScaleType(ImageView.ScaleType.CENTER_CROP)；如果需要完整显示1:1内容，设置ScaleType.FIT_CENTER。
• 适配相机预览方向：根据屏幕方向动态设置相机的显示旋转角度，避免方向不匹配导致的黑边。

4. 特殊机型兼容 #

针对三星等适配性差的机型，优先筛选16:9、4:3这类标准比例的预览尺寸，这类尺寸的厂商适配完成度最高，不会出现异常裁切。

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