Android 10中Camera2 API预览特效不显示问题求助

我之前也碰到过一模一样的问题，在Android 10及以上机型用Camera2 API设置预览特效时，总会出现预览没效果但拍照正常的情况。这其实是Android 10对Camera2预览流程的底层变更导致的，尤其是和SurfaceView/TextureView的预览渲染路径、CaptureRequest的配置优先级密切相关，下面给你分享几个亲测有效的解决思路：

可能的核心原因 #

• Android 10开始，不少厂商的设备默认启用了硬件加速的预览渲染管线，这条管线会直接跳过CaptureRequest中设置的CONTROL_EFFECT_MODE参数——因为特效需要在预览数据传输到Surface前处理，但新管线为了性能直接绕过了这一步。
• 另外，TEMPLATE_PREVIEW模板的默认配置里，部分设备会自动开启CONTROL_MODE_AUTO并优先处理自动场景检测，导致你手动设置的特效参数被覆盖忽略。

具体解决步骤 #

1. 强制锁定预览请求的控制模式

在设置特效前，先把预览请求的控制模式设为手动，确保特效参数不会被自动配置冲掉：

// 先设置控制模式为手动或指定场景模式
previewRequestBuilder.set(CaptureRequest.CONTROL_MODE, CameraMetadata.CONTROL_MODE_OFF);
// 再设置特效
previewRequestBuilder.set(CaptureRequest.CONTROL_EFFECT_MODE, CameraMetadata.CONTROL_EFFECT_MODE_NEGATIVE);

注意：设为CONTROL_MODE_OFF后，对焦、曝光等自动功能会失效，如果你的应用不需要这些自动能力，这个方法最直接有效。

2. 改用ImageReader手动处理预览帧

如果硬件管线绕过了特效处理，你可以用ImageReader获取原始预览帧，手动应用特效后再渲染到Surface上：

• 先创建ImageReader：

ImageReader imageReader = ImageReader.newInstance(previewSize.getWidth(), previewSize.getHeight(), ImageFormat.YUV_420_888, 2);
imageReader.setOnImageAvailableListener(reader -> {
    try (Image image = reader.acquireLatestImage()) {
        if (image != null) {
            // 在这里手动处理YUV数据，实现负片特效
            // 处理完成后将数据渲染到TextureView/SurfaceView
            renderProcessedImage(image, previewSurface);
        }
    }
}, backgroundHandler);

• 然后把ImageReader的Surface添加到预览请求的输出目标中：

previewRequestBuilder.addTarget(imageReader.getSurface());
previewRequestBuilder.addTarget(previewSurface);

这种方法虽然代码量增加，但兼容性拉满，完全不受系统版本和厂商定制的影响。

3. 尝试替换预览模板为TEMPLATE_RECORD

有些设备上，TEMPLATE_RECORD的预览配置会保留特效处理路径，你可以试试替换模板：

previewRequestBuilder = cameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_RECORD);

之后再设置特效参数，说不定就能生效。

4. 检查设备的"快速预览"设置

部分Android 10设备的系统相机设置里有"快速预览"或"硬件加速预览"选项，开启后会跳过特效处理。你可以引导用户关闭这个选项，或者在应用中通过CameraCharacteristics检测该特性是否存在，若存在则提示用户关闭。

额外验证建议 #

测试前可以先确认设备是否支持你要设置的特效模式，避免做无用功：

boolean supportsNegativeEffect = characteristics.get(CameraCharacteristics.CONTROL_AVAILABLE_EFFECT_MODES) != null 
    && Arrays.asList(characteristics.get(CameraCharacteristics.CONTROL_AVAILABLE_EFFECT_MODES)).contains(CameraMetadata.CONTROL_EFFECT_MODE_NEGATIVE);

根据你的描述，拍照能生效说明设备是支持该特效的，所以重点还是放在预览路径的调整上。

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