Android 17 相机 API 更新，实战手册

// 旧时代的做法：cameraCaptureSession.close(); // 关掉cameraDevice.createCaptureSession( // 重新创建 newConfigs, callback, handler);

// 假设你已经在跑一个 CameraCaptureSession// 想从 拍照模式 切到 录像模式： // 1. 准备好新的 OutputConfiguration 列表List<OutputConfiguration> videoOutputs = new ArrayList<>();videoOutputs.add(new OutputConfiguration(videoSurface)); // MediaCodec 的 SurfacevideoOutputs.add(new OutputConfiguration(previewSurface)); // 预览 Surface // 2. 直接更新——不关会话，不黑屏if (Build.VERSION.SDK_INT >= 37) { cameraCaptureSession.updateOutputConfigurations(videoOutputs);} else { // fallback 到老方法：close + recreate switchToLegacyPath(videoOutputs);}

// ❌ 只传 videoSurface，预览会断session.updateOutputConfigurations(List.of(videoOutputConfig)); // ✅ 预览和录像都要传session.updateOutputConfigurations(List.of( new OutputConfiguration(previewSurface), new OutputConfiguration(videoSurface)));

Sensor RAW → ISP → 多帧合成 → 降噪 → 色调映射 → 超分 → 出图

Sensor RAW → ISP → 出图

// ========== 第一步：查询设备有什么扩展 ==========CameraManager manager = context.getSystemService(CameraManager.class);String cameraId = ”0”; // 通常是后置主摄 CameraExtensionCharacteristics extChars = manager.getCameraExtensionCharacteristics(cameraId); // getSupportedExtensions() 现在返回的不仅是标准扩展// 还包含厂商自己注册的扩展 ID（比如小米的 ”SUPER_NIGHT”）List allExtensions = extChars.getSupportedExtensions(); for (int ext : allExtensions) { boolean supported = extChars.isExtensionSupported(ext); Log.d(”CAM”, ”扩展 ID ” + ext + ” 是否支持: ” + supported);  // 查这个扩展支持什么输出分辨率 List sizes = extChars.getExtensionSupportedSizes( ext, ImageFormat.JPEG);} // ========== 第二步：建立扩展会话 ==========ExtensionSessionConfiguration config = new ExtensionSessionConfiguration.Builder( CameraExtensionCharacteristics.EXTENSION_NIGHT, // 你要用的扩展类型 outputConfigs, executor, new CameraExtensionSession.StateCallback() { @Override public void onConfigured(@NonNull CameraExtensionSession session) { // 会话建好了，可以开始拍 session.capture(request, callback, handler); }  @Override public void onConfigureFailed(@NonNull CameraExtensionSession session) { // 大部分时候是这个扩展在这个设备上不支持 // fallback 到普通 CameraCaptureSession } } ).build(); cameraDevice.createExtensionSession(config);

public static boolean isExtAvailable( CameraExtensionCharacteristics c, int extId) { if (Build.VERSION.SDK_INT >= 37) { return c.isExtensionSupported(extId); } // 旧版本：假设 getSupportedExtensions 里有的就是支持的 return c.getSupportedExtensions().contains(extId);}

// 在 ImageReader 里直接指定 RAW14ImageReader reader = ImageReader.newInstance( width, height, ImageFormat.RAW14, // ← 新常量 maxImages); // 或者在 CameraRequest 里 target 这个 reader 的 SurfaceCaptureRequest.Builder builder = cameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_STILL_CAPTURE);builder.addTarget(reader.getSurface()); // 回调里拿到的 Image，format 就是 RAW14reader.setOnImageAvailableListener(reader1 -> { Image image = reader1.acquireLatestImage(); if (image.getFormat() == ImageFormat.RAW14) { // 处理 14bit RAW 数据 ByteBuffer buffer = image.getPlanes()[0].getBuffer(); // 每个像素 2 bytes（16bit 存储，低 14bit 有效） // 注意：buffer 是 packed 还是 unpacked，看传感器实现 } image.close();}, handler);

int[] bitsPerSample = characteristics.get( CameraCharacteristics.SENSOR_INFO_BITS_PER_SAMPLE);

// 开启”额外物理相机结果”CaptureRequest.Builder builder = cameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW);builder.set(CaptureRequest.LOGICAL_MULTI_CAMERA_ADDITIONAL_RESULTS, CaptureRequest.LOGICAL_MULTI_CAMERA_ADDITIONAL_RESULTS_ON); // 在 CaptureCallback 里：CaptureCallback callback = new CaptureCallback() { @Override public void onCaptureCompleted( CaptureRequest request, TotalCaptureResult result) {  // 旧的 API——只有主输出的物理相机 Map<String, CaptureResult> physicalResults = result.getPhysicalCameraResults();  // Android 17 新的——所有活跃的物理相机 if (Build.VERSION.SDK_INT >= 37) { Map<String, TotalCaptureResult> allPhysical = result.getPhysicalCameraTotalResults(); for (Map.Entry<String, TotalCaptureResult> entry : allPhysical.entrySet()) { String physicalId = entry.getKey(); TotalCaptureResult physicalResult = entry.getValue(); // 可以读到每个物理相机的完整 metadata Float focalLength = physicalResult.get( CaptureResult.LENS_FOCAL_LENGTH); // ... } } }};

// 1. 检查设备是否支持CameraCharacteristics chars = manager.getCameraCharacteristics(cameraId);int[] availableProfiles = chars.get( CameraCharacteristics.REQUEST_AVAILABLE_DYNAMIC_RANGE_PROFILES); boolean eclipsaSupported = false;for (int profile : availableProfiles) { if (profile == DynamicRangeProfiles.HLG10_SMPTE_2094_50) { eclipsaSupported = true; break; }} if (!eclipsaSupported) { // 不支持 Eclipsa，fallback 到普通 HDR 或 SDR return;} // 2. 配置 CaptureRequest 使用 Eclipsa 动态范围CaptureRequest.Builder builder = cameraDevice.createCaptureRequest(TEMPLATE_RECORD);builder.set(CaptureRequest.DYNAMIC_RANGE_PROFILE, DynamicRangeProfiles.HLG10_SMPTE_2094_50); // 3. 创建 MediaCodec 编码器// 注意：不需要特殊配置，元数据会自动从 camera 管线透传到编码器MediaFormat format = MediaFormat.createVideoFormat( MediaFormat.MIMETYPE_VIDEO_HEVC, width, height);format.setInteger(MediaFormat.KEY_BIT_RATE, bitRate);format.setInteger(MediaFormat.KEY_FRAME_RATE, fps);format.setInteger(MediaFormat.KEY_COLOR_FORMAT, MediaCodecInfo.CodecCapabilities.COLOR_FormatSurface); MediaCodec encoder = MediaCodec.createEncoderByType( MediaFormat.MIMETYPE_VIDEO_HEVC);encoder.configure(format, null, null, MediaCodec.CONFIGURE_FLAG_ENCODE);Surface encoderSurface = encoder.createInputSurface(); // 把 encoder surface 加到 capture session 里// camera 输出 HDR 数据 → encoder → muxer

MediaFormat.createVideoFormat(MediaFormat.MIMETYPE_VIDEO_VVC, width, height);// ”video/vvc”

MediaCodecList codecList = new MediaCodecList(MediaCodecList.REGULAR_CODECS);MediaCodecInfo codecInfo = codecList.findDecoderForFormat( MediaFormat.createVideoFormat( MediaFormat.MIMETYPE_VIDEO_VVC, 1920, 1080)); if (codecInfo != null) { // 可以硬解 VVC}

MediaRecorder recorder = new MediaRecorder();// ... 常规设置 ... // Android 17 新增if (Build.VERSION.SDK_INT >= 37) { recorder.setVideoEncodingQuality( MediaRecorder.VideoEncodingQuality.CQ);}

CBR： ████░░░░████░░░░████░░░░ （所有场景都一样的比特预算） CQ： ██████████░░██████████░░ （简单场景省下来的比特，给复杂场景用）

int deviceType = cameraManager.getCameraDeviceType(cameraId); // 返回值含义switch (deviceType) { case CameraManager.CAMERA_DEVICE_TYPE_BUILT_IN: // 0 — 内置摄像头 break; case CameraManager.CAMERA_DEVICE_TYPE_EXTERNAL_USB: // 1 — USB 外接摄像头 break; case CameraManager.CAMERA_DEVICE_TYPE_VIRTUAL: // 2 — 虚拟摄像头 break;}

关于博主 

采用v4l2loopback来实现 虚拟Camera

Camera基础及一些基本概念

Android Camera 学习路线 | 个人推荐

Android Camera开发系列（干货满满）

Camera Hal｜如何学习一个新平台

一篇文章带你了解Android 最新Camera框架

学习完Camera入门课程视频，可以去找工作了？