1. 从“手抖”到“稳如磐石”移动影像防抖的工程挑战在移动设备影像开发领域防抖功能从“锦上添花”的卖点逐渐演变为决定用户体验的核心基础能力。无论是短视频创作、直播还是日常记录用户对画面稳定性的要求越来越高。作为Android开发者当我们面对Camera2API时如何正确、高效地开启并利用设备提供的电子防抖EIS和光学防抖OIS就成了一项必须掌握的硬核技能。这不仅仅是调用一个API开关那么简单它涉及到对硬件能力、传感器协同、算法边界以及性能功耗的深度理解。很多开发者初次接触Camera2的防抖配置时可能会感到困惑为什么我按照文档设置了CONTROL_VIDEO_STABILIZATION_MODE但预览画面依然抖动为什么有些设备支持OIS代码里却检测不到EIS和OIS到底谁先谁后能否同时开启这些问题背后是Android相机硬件抽象层HAL、图像信号处理器ISP和应用程序之间复杂的交互逻辑。本文将从一个一线开发者的视角深入拆解在Camera2框架下开启EIS和OIS的完整流程、核心原理、实战代码以及那些官方文档不会告诉你的“坑”。2. 防抖技术原理EIS与OIS的协同与博弈在动手写代码之前我们必须先理解EIS和OIS到底是如何工作的。这是后续一切配置和调试的理论基础。2.1 光学防抖OIS硬件级的物理补偿OIS的本质是通过微型马达或音圈电机在物理上移动镜头组件或图像传感器来抵消手持设备时产生的微小抖动。你可以把它想象成相机内部有一个“减震器”。核心工作机制抖动感知设备内置的陀螺仪和加速度计以极高的频率通常高达200Hz以上实时检测设备在三个轴向俯仰、偏航、滚动的角速度和线性加速度。信号处理传感器数据被送入一个专用的运动处理单元或直接由ISP处理通过算法计算出需要补偿的位移量和方向。物理驱动计算出的驱动信号被发送到OIS执行器马达使其产生反向运动让光路在曝光期间保持相对稳定。在Camera2中的体现 OIS完全由相机硬件和底层HAL实现对应用层是“黑盒”。应用开发者无法直接控制OIS马达的运动。我们能做的是查询能力通过CameraCharacteristics检查设备是否支持OIS。启用/禁用通过CaptureRequest向HAL发送指令建议底层启用OIS功能。但最终是否生效取决于硬件状态如电量、温度、当前对焦模式以及HAL的具体实现。一个关键限制OIS的有效补偿范围有限通常只能应对高频、小振幅的抖动如手部生理性震颤对于大幅度、低频的运动如走路、跑动其补偿能力会达到物理极限甚至可能产生反向模糊。2.2 电子防抖EIS算法驱动的画面裁剪EIS则完全在数字域工作。它的核心思想是“用算法算用裁剪补”。核心工作流程运动估计同样利用陀螺仪数据并结合前后视频帧之间画面的特征点匹配光流法等精确计算出每一帧画面由于抖动而产生的全局运动矢量。运动平滑使用滤波算法如卡尔曼滤波对原始、抖动的运动轨迹进行平滑处理得到一个理想的、稳定的运动路径。图像变换与裁剪根据计算出的理想路径与原始路径的差异对每一帧图像进行反向的仿射变换平移、旋转、缩放将画面“拉回”到稳定轨迹上。这个变换过程必然会使得画面边缘的部分像素被移出视野。视野损失为了确保变换后的每一帧都有完整的画面内容EIS算法会预先取一个比输出分辨率更大的图像区域例如从传感器读取1280x720的区域最终输出960x540的稳定画面。这多出来的部分就是用于补偿抖动的“缓冲区”其代价就是输出画面的视野FOV会变小即所谓的“裁剪”。在Camera2中的体现 EIS的实现层级可能不同。较新的设备上EIS可能由ISP或专用的视觉处理单元VPU硬件加速完成。在Camera2API中我们通过CONTROL_VIDEO_STABILIZATION_MODE或CONTROL_VIDEO_STABILIZATION_MODE_PREVIEW_STABILIZATION等键来控制。2.3 EIS与OIS的协同策略现代高端手机通常同时配备OIS和EIS它们以“OIS为主EIS为辅”的方式协同工作OIS处理高频抖动在曝光瞬间OIS快速抵消微小颤动从源头上减少运动模糊为ISP提供更清晰的原始帧。EIS处理残余及低频抖动OIS处理后的画面再交由EIS算法进行二次稳定主要对付OIS处理不了的大幅度运动和低频晃动。陀螺仪数据融合两者的运动估计都依赖于陀螺仪数据但可能采用不同的滤波和时间戳对齐策略需要HAL层做好数据同步避免冲突。这种协同能实现“112”的效果但同时也对开发者的配置提出了更高要求配置不当可能导致画面抽搐或果冻效应。3. Camera2 API下的防抖能力探测与模式选择在开启任何功能前先搞清楚你的设备“有什么”和“能做什么”。这是避免后续踩坑的第一步。3.1 查询相机特性一切始于CameraCharacteristics。我们需要从中提取几个关键信息。CameraManager manager (CameraManager) context.getSystemService(Context.CAMERA_SERVICE); String cameraId “0”; // 通常后置主摄 CameraCharacteristics characteristics manager.getCameraCharacteristics(cameraId); // 1. 查询支持的防抖模式列表 int[] availableStabilizationModes characteristics.get( CameraCharacteristics.CONTROL_AVAILABLE_VIDEO_STABILIZATION_MODES ); if (availableStabilizationModes null) { availableStabilizationModes new int[]{CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_OFF}; } // 2. 检查是否支持OIS int[] availableOpticalStabilizationModes characteristics.get( CameraCharacteristics.LENS_INFO_AVAILABLE_OPTICAL_STABILIZATION ); boolean supportsOIS false; if (availableOpticalStabilizationModes ! null) { for (int mode : availableOpticalStabilizationModes) { if (mode ! CameraMetadata.LENS_OPTICAL_STABILIZATION_MODE_OFF) { supportsOIS true; break; } } } // 3. 检查是否支持EIS (VIDEO_STABILIZATION) boolean supportsEIS false; for (int mode : availableStabilizationModes) { if (mode CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_ON) { supportsEIS true; break; } } // 4. 检查是否支持预览防抖 (Android 12 API 32) boolean supportsPreviewStab false; for (int mode : availableStabilizationModes) { if (mode CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_PREVIEW_STABILIZATION) { supportsPreviewStab true; break; } }重要提示CONTROL_AVAILABLE_VIDEO_STABILIZATION_MODES这个键值在不同的Android版本和厂商实现中其含义可能略有漂移。在较早的版本中它可能主要代表EIS能力。但在一些新设备上厂商可能将OIS和EIS的联合模式也通过此列表返回。因此不能仅凭此列表就断定设备支持纯软件EIS。LENS_INFO_AVAILABLE_OPTICAL_STABILIZATION是判断OIS更可靠的标志。3.2 理解不同防抖模式的含义Camera2API定义了多种防抖模式你需要根据场景选择模式常量对应值含义与适用场景CONTROL_VIDEO_STABILIZATION_MODE_OFF0关闭所有由CONTROL_VIDEO_STABILIZATION_MODE控制的防抖。OIS可能仍受LENS_OPTICAL_STABILIZATION_MODE控制。CONTROL_VIDEO_STABILIZATION_MODE_ON1标准视频防抖模式。通常指启用EIS也可能在支持时自动结合OIS。这是录制视频时最常用的模式。CONTROL_VIDEO_STABILIZATION_MODE_PREVIEW_STABILIZATION2预览防抖模式(API 32)。旨在为预览画面提供稳定效果可能采用与录制模式不同的、延迟更低的算法。注意启用此模式时ON模式可能自动被禁用两者常互斥。OIS模式常量对应值含义LENS_OPTICAL_STABILIZATION_MODE_OFF0关闭OIS。LENS_OPTICAL_STABILIZATION_MODE_ON1开启OIS。在拍照和录像中均可生效用于抵消手抖。一个常见的误区认为设置了CONTROL_VIDEO_STABILIZATION_MODE_ON就一定能同时调用OIS和EIS。实际上这个开关的控制权在HAL和厂商驱动手里。在兼容性好的设备上设置ON可能会智能地启用最合适的防抖组合如OISEIS。但在一些设备上它可能只启用EIS你需要额外设置LENS_OPTICAL_STABILIZATION_MODE_ON来开启OIS。最稳妥的做法是两者都显式设置。3.3 实战中的模式选择逻辑基于以上信息我们可以制定一个健壮的策略private void configureStabilization(CaptureRequest.Builder builder, boolean forVideoRecording) { // 假设我们已经查询过特性并存储在成员变量中 // boolean mSupportsOIS, mSupportsEIS, mSupportsPreviewStab // 第一步配置OIS (如果支持) if (mSupportsOIS) { // 对于视频录制通常希望开启OIS if (forVideoRecording) { builder.set(CaptureRequest.LENS_OPTICAL_STABILIZATION_MODE, CameraMetadata.LENS_OPTICAL_STABILIZATION_MODE_ON); } else { // 对于高分辨率拍照有时为了绝对画质可能会关闭OIS根据场景定 builder.set(CaptureRequest.LENS_OPTICAL_STABILIZATION_MODE, CameraMetadata.LENS_OPTICAL_STABILIZATION_MODE_ON); } } // 第二步配置EIS/视频防抖 if (forVideoRecording) { // 视频录制场景优先使用标准视频防抖 if (mSupportsEIS) { builder.set(CaptureRequest.CONTROL_VIDEO_STABILIZATION_MODE, CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_ON); } } else { // 预览场景如果系统支持预览防抖且API级别足够则使用 if (Build.VERSION.SDK_INT Build.VERSION_CODES.S mSupportsPreviewStab) { builder.set(CaptureRequest.CONTROL_VIDEO_STABILIZATION_MODE, CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_PREVIEW_STABILIZATION); } else if (mSupportsEIS) { // 如果不支持预览防抖但需要预览稳定可以尝试开启标准模式。 // **注意这可能导致预览裁剪且并非所有设备在预览时都支持此模式。** builder.set(CaptureRequest.CONTROL_VIDEO_STABILIZATION_MODE, CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_ON); } } // 如果都不支持则模式默认为OFF无需设置。 }注意上述代码中在预览时开启CONTROL_VIDEO_STABILIZATION_MODE_ON需要谨慎测试。部分设备在预览流上启用该模式会导致异常如帧率下降、画面卡顿或者根本不起作用。PREVIEW_STABILIZATION模式正是为了解决这个问题而引入的。4. 完整集成流程从相机开启到稳定输出现在我们将防抖配置集成到一个典型的Camera2视频录制流程中。这里假设你已经熟悉Camera2的基本生命周期打开相机、创建会话等。4.1 初始化与能力检查在打开相机之前或之后立即进行能力检查并将结果保存。public class Camera2StabilizationHelper { private CameraCharacteristics mCameraCharacteristics; private boolean mSupportsOIS false; private boolean mSupportsEIS false; private boolean mSupportsPreviewStab false; private String mCameraId; public void initialize(CameraManager manager, String cameraId) throws CameraAccessException { mCameraId cameraId; mCameraCharacteristics manager.getCameraCharacteristics(cameraId); checkStabilizationCapabilities(); } private void checkStabilizationCapabilities() { // OIS 检查 int[] oisModes mCameraCharacteristics.get( CameraCharacteristics.LENS_INFO_AVAILABLE_OPTICAL_STABILIZATION ); if (oisModes ! null) { for (int mode : oisModes) { if (mode CameraMetadata.LENS_OPTICAL_STABILIZATION_MODE_ON) { mSupportsOIS true; break; } } } // EIS 及预览防抖检查 int[] videoStabModes mCameraCharacteristics.get( CameraCharacteristics.CONTROL_AVAILABLE_VIDEO_STABILIZATION_MODES ); if (videoStabModes ! null) { for (int mode : videoStabModes) { switch (mode) { case CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_ON: mSupportsEIS true; break; case CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_PREVIEW_STABILIZATION: if (Build.VERSION.SDK_INT Build.VERSION_CODES.S) { mSupportsPreviewStab true; } break; } } } Log.d(TAG, “Capabilities - OIS: ” mSupportsOIS “, EIS: ” mSupportsEIS “, PreviewStab: ” mSupportsPreviewStab); } // Getter methods... public boolean supportsOIS() { return mSupportsOIS; } public boolean supportsEIS() { return mSupportsEIS; } public boolean supportsPreviewStab() { return mSupportsPreviewStab; } }4.2 配置预览请求Preview Request预览画面的稳定性直接影响取景体验。我们的目标是尽可能让预览画面平滑。private CaptureRequest createPreviewRequest(CameraDevice device, Surface previewSurface) { try { CaptureRequest.Builder builder device.createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW); builder.addTarget(previewSurface); // 设置基本的自动对焦、自动曝光等 builder.set(CaptureRequest.CONTROL_AF_MODE, CaptureRequest.CONTROL_AF_MODE_CONTINUOUS_PICTURE); builder.set(CaptureRequest.CONTROL_AE_MODE, CaptureRequest.CONTROL_AE_MODE_ON_AUTO_FLASH); // **应用防抖配置** // 假设有一个 mStabilizationHelper 实例 if (mStabilizationHelper.supportsOIS()) { // 预览时也开启OIS通常是有益的能获得更清晰的实时画面 builder.set(CaptureRequest.LENS_OPTICAL_STABILIZATION_MODE, CameraMetadata.LENS_OPTICAL_STABILIZATION_MODE_ON); } if (Build.VERSION.SDK_INT Build.VERSION_CODES.S mStabilizationHelper.supportsPreviewStab()) { // Android 12 优先使用专用的预览防抖模式 builder.set(CaptureRequest.CONTROL_VIDEO_STABILIZATION_MODE, CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_PREVIEW_STABILIZATION); Log.d(TAG, “Preview: Using PREVIEW_STABILIZATION mode.”); } else if (mStabilizationHelper.supportsEIS()) { // 降级方案尝试使用标准视频防抖模式进行预览稳定 // **警告务必在真机上测试性能** builder.set(CaptureRequest.CONTROL_VIDEO_STABILIZATION_MODE, CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_ON); Log.d(TAG, “Preview: Using standard VIDEO_STABILIZATION mode (may crop).”); } else { builder.set(CaptureRequest.CONTROL_VIDEO_STABILIZATION_MODE, CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_OFF); Log.d(TAG, “Preview: No EIS/Preview stabilization available.”); } return builder.build(); } catch (CameraAccessException e) { Log.e(TAG, “createPreviewRequest failed”, e); return null; } }4.3 配置视频录制请求Recording Request视频录制请求是防抖效果的核心体现。这里的目标是最大化输出视频的稳定性。private CaptureRequest createRecordingRequest(CameraDevice device, Surface previewSurface, Surface recorderSurface) { try { // 使用 TEMPLATE_RECORD 模板它针对录像进行了优化 CaptureRequest.Builder builder device.createCaptureRequest(CameraDevice.TEMPLATE_RECORD); builder.addTarget(previewSurface); // 预览流仍需保持 builder.addTarget(recorderSurface); // 录像输出流 // 录像通常使用连续对焦和自动曝光 builder.set(CaptureRequest.CONTROL_AF_MODE, CaptureRequest.CONTROL_AF_MODE_CONTINUOUS_VIDEO); builder.set(CaptureRequest.CONTROL_AE_MODE, CaptureRequest.CONTROL_AE_MODE_ON); // **关键应用录像防抖配置** if (mStabilizationHelper.supportsOIS()) { // 强烈建议录像时开启OIS builder.set(CaptureRequest.LENS_OPTICAL_STABILIZATION_MODE, CameraMetadata.LENS_OPTICAL_STABILIZATION_MODE_ON); } if (mStabilizationHelper.supportsEIS()) { // 开启标准视频防抖模式 builder.set(CaptureRequest.CONTROL_VIDEO_STABILIZATION_MODE, CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_ON); Log.d(TAG, “Recording: VIDEO_STABILIZATION_MODE_ON set.”); } else { builder.set(CaptureRequest.CONTROL_VIDEO_STABILIZATION_MODE, CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_OFF); } // 一个容易被忽略但重要的设置设置录像的稳定模式提示 // 这有助于HAL更好地分配资源 builder.set(CaptureRequest.CONTROL_CAPTURE_INTENT, CaptureRequest.CONTROL_CAPTURE_INTENT_VIDEO_RECORD); return builder.build(); } catch (CameraAccessException e) { Log.e(TAG, “createRecordingRequest failed”, e); return null; } }4.4 创建相机会话与请求切换在创建CameraCaptureSession时我们需要传入用于预览和录制的Surface。当需要开始录制时通过setRepeatingRequest切换使用录制请求。private CameraCaptureSession mCaptureSession; private CaptureRequest mPreviewRequest; private CaptureRequest mRecordingRequest; private void createCameraSession(CameraDevice device, Surface previewSurface, Surface recorderSurface) { ListSurface outputSurfaces new ArrayList(); outputSurfaces.add(previewSurface); outputSurfaces.add(recorderSurface); // 录制Surface try { device.createCaptureSession(outputSurfaces, new CameraCaptureSession.StateCallback() { Override public void onConfigured(NonNull CameraCaptureSession session) { mCaptureSession session; mPreviewRequest createPreviewRequest(device, previewSurface); mRecordingRequest createRecordingRequest(device, previewSurface, recorderSurface); // 默认开始预览 startPreview(); } // ... 其他回调方法 }, null); } catch (CameraAccessException e) { Log.e(TAG, “createCameraSession failed”, e); } } private void startPreview() { if (mCaptureSession ! null mPreviewRequest ! null) { try { mCaptureSession.setRepeatingRequest(mPreviewRequest, null, null); } catch (CameraAccessException e) { Log.e(TAG, “startPreview failed”, e); } } } private void startRecording() { if (mCaptureSession ! null mRecordingRequest ! null) { try { // 切换到录像请求此时防抖模式已应用 mCaptureSession.setRepeatingRequest(mRecordingRequest, null, null); // 同时你的 MediaRecorder 应该已经开始 } catch (CameraAccessException e) { Log.e(TAG, “startRecording failed”, e); } } } private void stopRecordingAndBackToPreview() { if (mCaptureSession ! null mPreviewRequest ! null) { try { // 停止录像切回预览请求 mCaptureSession.setRepeatingRequest(mPreviewRequest, null, null); } catch (CameraAccessException e) { Log.e(TAG, “stopRecordingAndBackToPreview failed”, e); } } }5. 高级议题分辨率、裁剪与性能权衡开启防抖尤其是EIS并非没有代价。作为开发者必须理解并管理这些副作用。5.1 EIS带来的视野裁剪FOV Crop这是EIS最直接的影响。算法需要额外的像素边界来进行运动补偿。Camera2API提供了一个关键特性来查询这个裁剪系数SCALER_CROP_REGION。但更直接的是当你启用EIS后相机管道输出的画面可能已经是裁剪和稳定后的。为了获得最佳效果你应该选择相机支持的分辨率中被标记为适合视频稳定Video Stabilization的那一个。如何选择合适的分辨率private Size chooseOptimalSizeForStabilization(StreamConfigurationMap map, Class klass, Size maxSize) { Size[] sizes map.getOutputSizes(klass); // 例如 SurfaceTexture.class 或 MediaRecorder.class Size chosenSize null; float chosenAspectRatio 0; int chosenArea 0; // 优先查找设备推荐的“视频稳定”最佳分辨率 // 一些设备会在 CameraCharacteristics 中通过 SCALER_AVAILABLE_STREAM_CONFIGURATIONS 的 ANDROID_SCALER_AVAILABLE_STREAM_CONFIGURATIONS_OUTPUT 和 ANDROID_CONTROL_VIDEO_STABILIZATION_MODE_ON 标记来指示。 // 更实际的方法是检查每个分辨率尝试创建一个启用防抖的会话看是否支持。 // 简化策略选择常见的视频录制分辨率如1080p它通常被优化过。 for (Size size : sizes) { // 例选择小于等于maxSize且宽高比为16:9常见视频比例的最大分辨率 if (size.getWidth() maxSize.getWidth() size.getHeight() maxSize.getHeight()) { float aspect (float) size.getWidth() / size.getHeight(); // 近似判断16:9 if (Math.abs(aspect - 16.0f/9.0f) 0.1) { int area size.getWidth() * size.getHeight(); if (area chosenArea) { chosenArea area; chosenSize size; chosenAspectRatio aspect; } } } } if (chosenSize ! null) { Log.d(TAG, “Chosen size for recording (likely stable): ” chosenSize); return chosenSize; } // 兜底逻辑返回第一个支持的小于maxSize的分辨率 for (Size size : sizes) { if (size.getWidth() maxSize.getWidth() size.getHeight() maxSize.getHeight()) { return size; } } return sizes[0]; // 最后的选择 }重要经验在支持EIS的设备上如果你用createCaptureSession创建会话时传入了目标分辨率但随后在CaptureRequest中启用了CONTROL_VIDEO_STABILIZATION_MODE_ONHAL可能会在内部进行裁剪和缩放。这意味着你从ImageReader或MediaRecorder得到的帧其视野可能比你请求的分辨率对应的原始视野要小。UI预览需要做好适配避免预览构图和最终成片构图产生较大偏差。5.2 OIS与对焦、变焦的互动OIS模块在物理上移动镜头这自然会与相机的自动对焦AF和光学变焦如果支持机制产生交互。对焦冲突在极端情况下如果OIS补偿幅度过大可能会轻微偏离对焦平面导致画面局部模糊。高质量的OIS驱动算法会与AF系统协同避免这种情况。作为应用层我们通常无需干预但需要知道这种现象的存在。如果在开启OIS后发现对焦速度变慢或偶尔失焦可以尝试在特定场景如微距拍摄下关闭OIS进行对比测试。变焦影响在长焦端高倍率变焦OIS的补偿精度要求更高因为同样的手抖角度在长焦端会导致画面更大的位移。多摄像头系统中长焦镜头通常配备专门的OIS模块。当你切换摄像头时OIS的可用性也会随之改变。代码中在切换逻辑后需要重新查询CameraCharacteristics。5.3 功耗与发热考量防抖特别是OIS需要持续驱动马达和计算密集型的EIS算法会增加设备的功耗和发热。OIS功耗相对恒定只要开启就会持续消耗电量。EIS功耗与视频的分辨率、帧率直接相关。4K60fps视频的EIS计算量远大于1080p30fps。开发建议按需启用在预览界面如果用户没有强烈的稳定需求可以考虑仅开启OIS如果功耗可接受或使用低功耗的PREVIEW_STABILIZATION模式甚至关闭防抖。提供选项在应用设置中可以提供“高画质防抖关”、“均衡防抖开”、“超级防抖可能更耗电”等选项把选择权交给用户。监控温度在长时间录制尤其是高分辨率高帧率录制时注意监控设备温度。如果温度过高可以考虑在代码中动态降低防抖等级或提示用户。6. 问题排查与厂商兼容性实战这是项目中最令人头疼的部分。不同厂商、不同芯片平台如高通、联发科对Camera2防抖API的实现可能存在差异。6.1 常见问题与排查清单问题现象可能原因排查步骤设置了防抖模式但预览/录像毫无稳定效果。1. 设备硬件不支持该模式。2. 当前选择的分辨率/帧率不支持防抖。3. 厂商HAL未正确实现该API。1. 确认checkStabilizationCapabilities()返回支持。2. 尝试切换到设备常见的视频分辨率如1080p。3. 使用系统原生相机应用录制一段视频对比效果。如果系统相机有效而你的应用无效可能是配置问题。开启EIS后预览画面有黑边或视野明显变小。EIS正在工作预览界面显示的是裁剪后的稳定画面。这是正常现象。确认最终录制的视频视野是否与预览一致。如果UI需要精确构图需提示用户或提供构图辅助线。开启防抖后画面出现果冻效应滚动快门失真加剧。EIS算法与传感器的读出时间同步不佳运动估计错误。1. 尝试关闭EIS只使用OIS如果支持。2. 尝试降低视频录制分辨率或帧率。3. 此问题可能与特定机型驱动有关需反馈给厂商。录制视频时防抖效果时好时坏或在开始/停止时画面跳动。在预览请求和录制请求切换时防抖模式切换不同步或重置。1. 确保mRecordingRequest正确包含了所有防抖设置。2. 在startRecording()和stopRecordingAndBackToPreview()时检查请求是否成功设置。3. 在CaptureCallback中监听CaptureResult打印LENS_OPTICAL_STABILIZATION_MODE和CONTROL_VIDEO_STABILIZATION_MODE的实际值确认与请求一致。支持OIS但LENS_OPTICAL_STABILIZATION_MODE_ON设置无效。可能在某些模式下如手动对焦CONTROL_AF_MODE_OFFOIS被强制禁用。1. 检查对焦模式。尝试使用CONTROL_AF_MODE_CONTINUOUS_VIDEO或CONTROL_AF_MODE_CONTINUOUS_PICTURE。2. 检查是否处于高分辨率拍照模式如全像素模式有些设备在该模式下会禁用OIS。6.2 通过CaptureResult验证状态调试防抖问题最有效的方法之一是检查从相机返回的CaptureResult它反映了请求参数的实际生效状态。private CameraCaptureSession.CaptureCallback mCaptureCallback new CameraCaptureSession.CaptureCallback() { Override public void onCaptureCompleted(NonNull CameraCaptureSession session, NonNull CaptureRequest request, NonNull TotalCaptureResult result) { Integer opticalStabMode result.get(CaptureResult.LENS_OPTICAL_STABILIZATION_MODE); Integer videoStabMode result.get(CaptureResult.CONTROL_VIDEO_STABILIZATION_MODE); Log.d(TAG, “CaptureResult - OIS Mode: ” opticalStabMode “, VideoStab Mode: ” videoStabMode); // 对比你设置的请求值看是否一致 // 如果不一致说明HAL拒绝了你的设置或者有更高优先级的控制逻辑覆盖了它。 } }; // 在设置重复请求时传入这个回调 mCaptureSession.setRepeatingRequest(mPreviewRequest, mCaptureCallback, null);6.3 厂商特定行为与适配“超级防抖”或“运动防抖”模式许多厂商在原生Camera2API之上实现了自己的增强防抖算法通常结合了更激进的EIS裁剪、多帧融合甚至AI预测。这些模式可能无法通过标准的Camera2API开启需要调用厂商私有的SDK或使用特定的Intent跳转到系统相机。如果你的应用对防抖有极致要求需要研究目标机型的具体开发文档。前后摄像头差异后置主摄通常配备OIS而前置摄像头几乎都没有OIS。EIS的支持情况也前后不一。你的代码需要根据摄像头ID分别查询和配置。多摄像头切换在广角、超广角、长焦之间切换时每个摄像头的防抖能力是独立的。必须在每次摄像头切换后重新查询其CameraCharacteristics。7. 超越API算法增强与未来展望对于追求极致稳定性的应用仅仅依赖系统API可能不够。我们可以考虑在应用层进行算法增强。7.1 应用层视频稳定算法即使硬件和系统提供了防抖你仍然可以在获取到视频帧数据例如通过ImageReader后使用软件算法进行二次稳定。开源库如Google的GyroStabilizer原理基于陀螺仪数据或基于特征点光流的算法如OpenCV中的videostab模块可以作为参考。基本思路在录制视频时同步高频率地收集陀螺仪和加速度计数据并打上精确的时间戳。对每一视频帧根据其时间戳找到对应的传感器数据序列。使用传感器数据计算相机在曝光期间的运动轨迹并进行平滑滤波。对该帧图像进行相应的仿射变换旋转、平移来抵消运动。将处理后的帧重新编码到输出视频流。挑战性能开销CPU/GPU上进行逐帧图像变换非常耗电对实时性要求高的场景如直播挑战巨大。时间戳同步精确对齐传感器数据和视频帧时间戳是关键难点微小的偏差会导致明显的果冻效应。画质损失与EIS类似需要进行裁剪和插值导致分辨率损失。因此应用层算法更适合后期处理或者在系统防抖效果不理想时作为补充。7.2 Android 13 与 CameraX 的进展在最新的Android版本和Jetpack CameraX库中Google正在简化相机开发防抖配置也不例外。CameraX提供了更高级的APIVideoCapture。你可以通过VideoCapture.Builder.setVideoStabilizationEnabled()来启用防抖库会帮你处理大部分兼容性逻辑。这是新项目的推荐方式能减少大量样板代码和兼容性处理工作。Android 13 (API 33)引入了CONTROL_VIDEO_STABILIZATION_MODE_PREVIEW_STABILIZATION的完善支持并可能在未来提供更精细的防抖强度控制。对于新项目强烈建议评估使用CameraX。对于需要深度定制或维护现有Camera2代码库的项目理解本文所述的底层原理依然至关重要。7.3 实战心得防抖配置的“黄金法则”在我经手的多个相机相关项目中总结出几条关于防抖配置的实用经验先查后用永远不要假设在任何设备上防抖都是可选的增强功能。代码必须健壮地处理“不支持”的情况并优雅降级。OIS优先EIS补充如果设备支持OIS在大多数情况下都应该开启它。它从物理层面改善画质且通常功耗可接受。EIS则作为处理大幅度运动的补充手段。预览与录制区别对待预览更注重低延迟和流畅录制更注重高质量稳定输出。利用好PREVIEW_STABILIZATION和标准VIDEO_STABILIZATION模式的区别。分辨率是朋友也是敌人更高的分辨率给EIS提供了更多裁剪空间但也带来了更大的计算负担和功耗。找到设备在该分辨率下支持防抖的“甜点”很重要通常1080p是兼容性最好的选择。用结果验证请求一定要通过CaptureResult监听关键模式的实际生效状态。这是排查兼容性问题最直接的证据。用户感知至上防抖的最终目的是提升体验。如果开启防抖导致预览卡顿、耗电剧增或视野损失过大需要考虑提供开关让用户选择。技术是为体验服务的。
Android Camera2防抖开发指南：EIS与OIS原理、配置与实战
发布时间：2026/7/31 16:54:04
1. 从“手抖”到“稳如磐石”移动影像防抖的工程挑战在移动设备影像开发领域防抖功能从“锦上添花”的卖点逐渐演变为决定用户体验的核心基础能力。无论是短视频创作、直播还是日常记录用户对画面稳定性的要求越来越高。作为Android开发者当我们面对Camera2API时如何正确、高效地开启并利用设备提供的电子防抖EIS和光学防抖OIS就成了一项必须掌握的硬核技能。这不仅仅是调用一个API开关那么简单它涉及到对硬件能力、传感器协同、算法边界以及性能功耗的深度理解。很多开发者初次接触Camera2的防抖配置时可能会感到困惑为什么我按照文档设置了CONTROL_VIDEO_STABILIZATION_MODE但预览画面依然抖动为什么有些设备支持OIS代码里却检测不到EIS和OIS到底谁先谁后能否同时开启这些问题背后是Android相机硬件抽象层HAL、图像信号处理器ISP和应用程序之间复杂的交互逻辑。本文将从一个一线开发者的视角深入拆解在Camera2框架下开启EIS和OIS的完整流程、核心原理、实战代码以及那些官方文档不会告诉你的“坑”。2. 防抖技术原理EIS与OIS的协同与博弈在动手写代码之前我们必须先理解EIS和OIS到底是如何工作的。这是后续一切配置和调试的理论基础。2.1 光学防抖OIS硬件级的物理补偿OIS的本质是通过微型马达或音圈电机在物理上移动镜头组件或图像传感器来抵消手持设备时产生的微小抖动。你可以把它想象成相机内部有一个“减震器”。核心工作机制抖动感知设备内置的陀螺仪和加速度计以极高的频率通常高达200Hz以上实时检测设备在三个轴向俯仰、偏航、滚动的角速度和线性加速度。信号处理传感器数据被送入一个专用的运动处理单元或直接由ISP处理通过算法计算出需要补偿的位移量和方向。物理驱动计算出的驱动信号被发送到OIS执行器马达使其产生反向运动让光路在曝光期间保持相对稳定。在Camera2中的体现 OIS完全由相机硬件和底层HAL实现对应用层是“黑盒”。应用开发者无法直接控制OIS马达的运动。我们能做的是查询能力通过CameraCharacteristics检查设备是否支持OIS。启用/禁用通过CaptureRequest向HAL发送指令建议底层启用OIS功能。但最终是否生效取决于硬件状态如电量、温度、当前对焦模式以及HAL的具体实现。一个关键限制OIS的有效补偿范围有限通常只能应对高频、小振幅的抖动如手部生理性震颤对于大幅度、低频的运动如走路、跑动其补偿能力会达到物理极限甚至可能产生反向模糊。2.2 电子防抖EIS算法驱动的画面裁剪EIS则完全在数字域工作。它的核心思想是“用算法算用裁剪补”。核心工作流程运动估计同样利用陀螺仪数据并结合前后视频帧之间画面的特征点匹配光流法等精确计算出每一帧画面由于抖动而产生的全局运动矢量。运动平滑使用滤波算法如卡尔曼滤波对原始、抖动的运动轨迹进行平滑处理得到一个理想的、稳定的运动路径。图像变换与裁剪根据计算出的理想路径与原始路径的差异对每一帧图像进行反向的仿射变换平移、旋转、缩放将画面“拉回”到稳定轨迹上。这个变换过程必然会使得画面边缘的部分像素被移出视野。视野损失为了确保变换后的每一帧都有完整的画面内容EIS算法会预先取一个比输出分辨率更大的图像区域例如从传感器读取1280x720的区域最终输出960x540的稳定画面。这多出来的部分就是用于补偿抖动的“缓冲区”其代价就是输出画面的视野FOV会变小即所谓的“裁剪”。在Camera2中的体现 EIS的实现层级可能不同。较新的设备上EIS可能由ISP或专用的视觉处理单元VPU硬件加速完成。在Camera2API中我们通过CONTROL_VIDEO_STABILIZATION_MODE或CONTROL_VIDEO_STABILIZATION_MODE_PREVIEW_STABILIZATION等键来控制。2.3 EIS与OIS的协同策略现代高端手机通常同时配备OIS和EIS它们以“OIS为主EIS为辅”的方式协同工作OIS处理高频抖动在曝光瞬间OIS快速抵消微小颤动从源头上减少运动模糊为ISP提供更清晰的原始帧。EIS处理残余及低频抖动OIS处理后的画面再交由EIS算法进行二次稳定主要对付OIS处理不了的大幅度运动和低频晃动。陀螺仪数据融合两者的运动估计都依赖于陀螺仪数据但可能采用不同的滤波和时间戳对齐策略需要HAL层做好数据同步避免冲突。这种协同能实现“112”的效果但同时也对开发者的配置提出了更高要求配置不当可能导致画面抽搐或果冻效应。3. Camera2 API下的防抖能力探测与模式选择在开启任何功能前先搞清楚你的设备“有什么”和“能做什么”。这是避免后续踩坑的第一步。3.1 查询相机特性一切始于CameraCharacteristics。我们需要从中提取几个关键信息。CameraManager manager (CameraManager) context.getSystemService(Context.CAMERA_SERVICE); String cameraId “0”; // 通常后置主摄 CameraCharacteristics characteristics manager.getCameraCharacteristics(cameraId); // 1. 查询支持的防抖模式列表 int[] availableStabilizationModes characteristics.get( CameraCharacteristics.CONTROL_AVAILABLE_VIDEO_STABILIZATION_MODES ); if (availableStabilizationModes null) { availableStabilizationModes new int[]{CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_OFF}; } // 2. 检查是否支持OIS int[] availableOpticalStabilizationModes characteristics.get( CameraCharacteristics.LENS_INFO_AVAILABLE_OPTICAL_STABILIZATION ); boolean supportsOIS false; if (availableOpticalStabilizationModes ! null) { for (int mode : availableOpticalStabilizationModes) { if (mode ! CameraMetadata.LENS_OPTICAL_STABILIZATION_MODE_OFF) { supportsOIS true; break; } } } // 3. 检查是否支持EIS (VIDEO_STABILIZATION) boolean supportsEIS false; for (int mode : availableStabilizationModes) { if (mode CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_ON) { supportsEIS true; break; } } // 4. 检查是否支持预览防抖 (Android 12 API 32) boolean supportsPreviewStab false; for (int mode : availableStabilizationModes) { if (mode CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_PREVIEW_STABILIZATION) { supportsPreviewStab true; break; } }重要提示CONTROL_AVAILABLE_VIDEO_STABILIZATION_MODES这个键值在不同的Android版本和厂商实现中其含义可能略有漂移。在较早的版本中它可能主要代表EIS能力。但在一些新设备上厂商可能将OIS和EIS的联合模式也通过此列表返回。因此不能仅凭此列表就断定设备支持纯软件EIS。LENS_INFO_AVAILABLE_OPTICAL_STABILIZATION是判断OIS更可靠的标志。3.2 理解不同防抖模式的含义Camera2API定义了多种防抖模式你需要根据场景选择模式常量对应值含义与适用场景CONTROL_VIDEO_STABILIZATION_MODE_OFF0关闭所有由CONTROL_VIDEO_STABILIZATION_MODE控制的防抖。OIS可能仍受LENS_OPTICAL_STABILIZATION_MODE控制。CONTROL_VIDEO_STABILIZATION_MODE_ON1标准视频防抖模式。通常指启用EIS也可能在支持时自动结合OIS。这是录制视频时最常用的模式。CONTROL_VIDEO_STABILIZATION_MODE_PREVIEW_STABILIZATION2预览防抖模式(API 32)。旨在为预览画面提供稳定效果可能采用与录制模式不同的、延迟更低的算法。注意启用此模式时ON模式可能自动被禁用两者常互斥。OIS模式常量对应值含义LENS_OPTICAL_STABILIZATION_MODE_OFF0关闭OIS。LENS_OPTICAL_STABILIZATION_MODE_ON1开启OIS。在拍照和录像中均可生效用于抵消手抖。一个常见的误区认为设置了CONTROL_VIDEO_STABILIZATION_MODE_ON就一定能同时调用OIS和EIS。实际上这个开关的控制权在HAL和厂商驱动手里。在兼容性好的设备上设置ON可能会智能地启用最合适的防抖组合如OISEIS。但在一些设备上它可能只启用EIS你需要额外设置LENS_OPTICAL_STABILIZATION_MODE_ON来开启OIS。最稳妥的做法是两者都显式设置。3.3 实战中的模式选择逻辑基于以上信息我们可以制定一个健壮的策略private void configureStabilization(CaptureRequest.Builder builder, boolean forVideoRecording) { // 假设我们已经查询过特性并存储在成员变量中 // boolean mSupportsOIS, mSupportsEIS, mSupportsPreviewStab // 第一步配置OIS (如果支持) if (mSupportsOIS) { // 对于视频录制通常希望开启OIS if (forVideoRecording) { builder.set(CaptureRequest.LENS_OPTICAL_STABILIZATION_MODE, CameraMetadata.LENS_OPTICAL_STABILIZATION_MODE_ON); } else { // 对于高分辨率拍照有时为了绝对画质可能会关闭OIS根据场景定 builder.set(CaptureRequest.LENS_OPTICAL_STABILIZATION_MODE, CameraMetadata.LENS_OPTICAL_STABILIZATION_MODE_ON); } } // 第二步配置EIS/视频防抖 if (forVideoRecording) { // 视频录制场景优先使用标准视频防抖 if (mSupportsEIS) { builder.set(CaptureRequest.CONTROL_VIDEO_STABILIZATION_MODE, CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_ON); } } else { // 预览场景如果系统支持预览防抖且API级别足够则使用 if (Build.VERSION.SDK_INT Build.VERSION_CODES.S mSupportsPreviewStab) { builder.set(CaptureRequest.CONTROL_VIDEO_STABILIZATION_MODE, CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_PREVIEW_STABILIZATION); } else if (mSupportsEIS) { // 如果不支持预览防抖但需要预览稳定可以尝试开启标准模式。 // **注意这可能导致预览裁剪且并非所有设备在预览时都支持此模式。** builder.set(CaptureRequest.CONTROL_VIDEO_STABILIZATION_MODE, CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_ON); } } // 如果都不支持则模式默认为OFF无需设置。 }注意上述代码中在预览时开启CONTROL_VIDEO_STABILIZATION_MODE_ON需要谨慎测试。部分设备在预览流上启用该模式会导致异常如帧率下降、画面卡顿或者根本不起作用。PREVIEW_STABILIZATION模式正是为了解决这个问题而引入的。4. 完整集成流程从相机开启到稳定输出现在我们将防抖配置集成到一个典型的Camera2视频录制流程中。这里假设你已经熟悉Camera2的基本生命周期打开相机、创建会话等。4.1 初始化与能力检查在打开相机之前或之后立即进行能力检查并将结果保存。public class Camera2StabilizationHelper { private CameraCharacteristics mCameraCharacteristics; private boolean mSupportsOIS false; private boolean mSupportsEIS false; private boolean mSupportsPreviewStab false; private String mCameraId; public void initialize(CameraManager manager, String cameraId) throws CameraAccessException { mCameraId cameraId; mCameraCharacteristics manager.getCameraCharacteristics(cameraId); checkStabilizationCapabilities(); } private void checkStabilizationCapabilities() { // OIS 检查 int[] oisModes mCameraCharacteristics.get( CameraCharacteristics.LENS_INFO_AVAILABLE_OPTICAL_STABILIZATION ); if (oisModes ! null) { for (int mode : oisModes) { if (mode CameraMetadata.LENS_OPTICAL_STABILIZATION_MODE_ON) { mSupportsOIS true; break; } } } // EIS 及预览防抖检查 int[] videoStabModes mCameraCharacteristics.get( CameraCharacteristics.CONTROL_AVAILABLE_VIDEO_STABILIZATION_MODES ); if (videoStabModes ! null) { for (int mode : videoStabModes) { switch (mode) { case CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_ON: mSupportsEIS true; break; case CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_PREVIEW_STABILIZATION: if (Build.VERSION.SDK_INT Build.VERSION_CODES.S) { mSupportsPreviewStab true; } break; } } } Log.d(TAG, “Capabilities - OIS: ” mSupportsOIS “, EIS: ” mSupportsEIS “, PreviewStab: ” mSupportsPreviewStab); } // Getter methods... public boolean supportsOIS() { return mSupportsOIS; } public boolean supportsEIS() { return mSupportsEIS; } public boolean supportsPreviewStab() { return mSupportsPreviewStab; } }4.2 配置预览请求Preview Request预览画面的稳定性直接影响取景体验。我们的目标是尽可能让预览画面平滑。private CaptureRequest createPreviewRequest(CameraDevice device, Surface previewSurface) { try { CaptureRequest.Builder builder device.createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW); builder.addTarget(previewSurface); // 设置基本的自动对焦、自动曝光等 builder.set(CaptureRequest.CONTROL_AF_MODE, CaptureRequest.CONTROL_AF_MODE_CONTINUOUS_PICTURE); builder.set(CaptureRequest.CONTROL_AE_MODE, CaptureRequest.CONTROL_AE_MODE_ON_AUTO_FLASH); // **应用防抖配置** // 假设有一个 mStabilizationHelper 实例 if (mStabilizationHelper.supportsOIS()) { // 预览时也开启OIS通常是有益的能获得更清晰的实时画面 builder.set(CaptureRequest.LENS_OPTICAL_STABILIZATION_MODE, CameraMetadata.LENS_OPTICAL_STABILIZATION_MODE_ON); } if (Build.VERSION.SDK_INT Build.VERSION_CODES.S mStabilizationHelper.supportsPreviewStab()) { // Android 12 优先使用专用的预览防抖模式 builder.set(CaptureRequest.CONTROL_VIDEO_STABILIZATION_MODE, CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_PREVIEW_STABILIZATION); Log.d(TAG, “Preview: Using PREVIEW_STABILIZATION mode.”); } else if (mStabilizationHelper.supportsEIS()) { // 降级方案尝试使用标准视频防抖模式进行预览稳定 // **警告务必在真机上测试性能** builder.set(CaptureRequest.CONTROL_VIDEO_STABILIZATION_MODE, CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_ON); Log.d(TAG, “Preview: Using standard VIDEO_STABILIZATION mode (may crop).”); } else { builder.set(CaptureRequest.CONTROL_VIDEO_STABILIZATION_MODE, CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_OFF); Log.d(TAG, “Preview: No EIS/Preview stabilization available.”); } return builder.build(); } catch (CameraAccessException e) { Log.e(TAG, “createPreviewRequest failed”, e); return null; } }4.3 配置视频录制请求Recording Request视频录制请求是防抖效果的核心体现。这里的目标是最大化输出视频的稳定性。private CaptureRequest createRecordingRequest(CameraDevice device, Surface previewSurface, Surface recorderSurface) { try { // 使用 TEMPLATE_RECORD 模板它针对录像进行了优化 CaptureRequest.Builder builder device.createCaptureRequest(CameraDevice.TEMPLATE_RECORD); builder.addTarget(previewSurface); // 预览流仍需保持 builder.addTarget(recorderSurface); // 录像输出流 // 录像通常使用连续对焦和自动曝光 builder.set(CaptureRequest.CONTROL_AF_MODE, CaptureRequest.CONTROL_AF_MODE_CONTINUOUS_VIDEO); builder.set(CaptureRequest.CONTROL_AE_MODE, CaptureRequest.CONTROL_AE_MODE_ON); // **关键应用录像防抖配置** if (mStabilizationHelper.supportsOIS()) { // 强烈建议录像时开启OIS builder.set(CaptureRequest.LENS_OPTICAL_STABILIZATION_MODE, CameraMetadata.LENS_OPTICAL_STABILIZATION_MODE_ON); } if (mStabilizationHelper.supportsEIS()) { // 开启标准视频防抖模式 builder.set(CaptureRequest.CONTROL_VIDEO_STABILIZATION_MODE, CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_ON); Log.d(TAG, “Recording: VIDEO_STABILIZATION_MODE_ON set.”); } else { builder.set(CaptureRequest.CONTROL_VIDEO_STABILIZATION_MODE, CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_OFF); } // 一个容易被忽略但重要的设置设置录像的稳定模式提示 // 这有助于HAL更好地分配资源 builder.set(CaptureRequest.CONTROL_CAPTURE_INTENT, CaptureRequest.CONTROL_CAPTURE_INTENT_VIDEO_RECORD); return builder.build(); } catch (CameraAccessException e) { Log.e(TAG, “createRecordingRequest failed”, e); return null; } }4.4 创建相机会话与请求切换在创建CameraCaptureSession时我们需要传入用于预览和录制的Surface。当需要开始录制时通过setRepeatingRequest切换使用录制请求。private CameraCaptureSession mCaptureSession; private CaptureRequest mPreviewRequest; private CaptureRequest mRecordingRequest; private void createCameraSession(CameraDevice device, Surface previewSurface, Surface recorderSurface) { ListSurface outputSurfaces new ArrayList(); outputSurfaces.add(previewSurface); outputSurfaces.add(recorderSurface); // 录制Surface try { device.createCaptureSession(outputSurfaces, new CameraCaptureSession.StateCallback() { Override public void onConfigured(NonNull CameraCaptureSession session) { mCaptureSession session; mPreviewRequest createPreviewRequest(device, previewSurface); mRecordingRequest createRecordingRequest(device, previewSurface, recorderSurface); // 默认开始预览 startPreview(); } // ... 其他回调方法 }, null); } catch (CameraAccessException e) { Log.e(TAG, “createCameraSession failed”, e); } } private void startPreview() { if (mCaptureSession ! null mPreviewRequest ! null) { try { mCaptureSession.setRepeatingRequest(mPreviewRequest, null, null); } catch (CameraAccessException e) { Log.e(TAG, “startPreview failed”, e); } } } private void startRecording() { if (mCaptureSession ! null mRecordingRequest ! null) { try { // 切换到录像请求此时防抖模式已应用 mCaptureSession.setRepeatingRequest(mRecordingRequest, null, null); // 同时你的 MediaRecorder 应该已经开始 } catch (CameraAccessException e) { Log.e(TAG, “startRecording failed”, e); } } } private void stopRecordingAndBackToPreview() { if (mCaptureSession ! null mPreviewRequest ! null) { try { // 停止录像切回预览请求 mCaptureSession.setRepeatingRequest(mPreviewRequest, null, null); } catch (CameraAccessException e) { Log.e(TAG, “stopRecordingAndBackToPreview failed”, e); } } }5. 高级议题分辨率、裁剪与性能权衡开启防抖尤其是EIS并非没有代价。作为开发者必须理解并管理这些副作用。5.1 EIS带来的视野裁剪FOV Crop这是EIS最直接的影响。算法需要额外的像素边界来进行运动补偿。Camera2API提供了一个关键特性来查询这个裁剪系数SCALER_CROP_REGION。但更直接的是当你启用EIS后相机管道输出的画面可能已经是裁剪和稳定后的。为了获得最佳效果你应该选择相机支持的分辨率中被标记为适合视频稳定Video Stabilization的那一个。如何选择合适的分辨率private Size chooseOptimalSizeForStabilization(StreamConfigurationMap map, Class klass, Size maxSize) { Size[] sizes map.getOutputSizes(klass); // 例如 SurfaceTexture.class 或 MediaRecorder.class Size chosenSize null; float chosenAspectRatio 0; int chosenArea 0; // 优先查找设备推荐的“视频稳定”最佳分辨率 // 一些设备会在 CameraCharacteristics 中通过 SCALER_AVAILABLE_STREAM_CONFIGURATIONS 的 ANDROID_SCALER_AVAILABLE_STREAM_CONFIGURATIONS_OUTPUT 和 ANDROID_CONTROL_VIDEO_STABILIZATION_MODE_ON 标记来指示。 // 更实际的方法是检查每个分辨率尝试创建一个启用防抖的会话看是否支持。 // 简化策略选择常见的视频录制分辨率如1080p它通常被优化过。 for (Size size : sizes) { // 例选择小于等于maxSize且宽高比为16:9常见视频比例的最大分辨率 if (size.getWidth() maxSize.getWidth() size.getHeight() maxSize.getHeight()) { float aspect (float) size.getWidth() / size.getHeight(); // 近似判断16:9 if (Math.abs(aspect - 16.0f/9.0f) 0.1) { int area size.getWidth() * size.getHeight(); if (area chosenArea) { chosenArea area; chosenSize size; chosenAspectRatio aspect; } } } } if (chosenSize ! null) { Log.d(TAG, “Chosen size for recording (likely stable): ” chosenSize); return chosenSize; } // 兜底逻辑返回第一个支持的小于maxSize的分辨率 for (Size size : sizes) { if (size.getWidth() maxSize.getWidth() size.getHeight() maxSize.getHeight()) { return size; } } return sizes[0]; // 最后的选择 }重要经验在支持EIS的设备上如果你用createCaptureSession创建会话时传入了目标分辨率但随后在CaptureRequest中启用了CONTROL_VIDEO_STABILIZATION_MODE_ONHAL可能会在内部进行裁剪和缩放。这意味着你从ImageReader或MediaRecorder得到的帧其视野可能比你请求的分辨率对应的原始视野要小。UI预览需要做好适配避免预览构图和最终成片构图产生较大偏差。5.2 OIS与对焦、变焦的互动OIS模块在物理上移动镜头这自然会与相机的自动对焦AF和光学变焦如果支持机制产生交互。对焦冲突在极端情况下如果OIS补偿幅度过大可能会轻微偏离对焦平面导致画面局部模糊。高质量的OIS驱动算法会与AF系统协同避免这种情况。作为应用层我们通常无需干预但需要知道这种现象的存在。如果在开启OIS后发现对焦速度变慢或偶尔失焦可以尝试在特定场景如微距拍摄下关闭OIS进行对比测试。变焦影响在长焦端高倍率变焦OIS的补偿精度要求更高因为同样的手抖角度在长焦端会导致画面更大的位移。多摄像头系统中长焦镜头通常配备专门的OIS模块。当你切换摄像头时OIS的可用性也会随之改变。代码中在切换逻辑后需要重新查询CameraCharacteristics。5.3 功耗与发热考量防抖特别是OIS需要持续驱动马达和计算密集型的EIS算法会增加设备的功耗和发热。OIS功耗相对恒定只要开启就会持续消耗电量。EIS功耗与视频的分辨率、帧率直接相关。4K60fps视频的EIS计算量远大于1080p30fps。开发建议按需启用在预览界面如果用户没有强烈的稳定需求可以考虑仅开启OIS如果功耗可接受或使用低功耗的PREVIEW_STABILIZATION模式甚至关闭防抖。提供选项在应用设置中可以提供“高画质防抖关”、“均衡防抖开”、“超级防抖可能更耗电”等选项把选择权交给用户。监控温度在长时间录制尤其是高分辨率高帧率录制时注意监控设备温度。如果温度过高可以考虑在代码中动态降低防抖等级或提示用户。6. 问题排查与厂商兼容性实战这是项目中最令人头疼的部分。不同厂商、不同芯片平台如高通、联发科对Camera2防抖API的实现可能存在差异。6.1 常见问题与排查清单问题现象可能原因排查步骤设置了防抖模式但预览/录像毫无稳定效果。1. 设备硬件不支持该模式。2. 当前选择的分辨率/帧率不支持防抖。3. 厂商HAL未正确实现该API。1. 确认checkStabilizationCapabilities()返回支持。2. 尝试切换到设备常见的视频分辨率如1080p。3. 使用系统原生相机应用录制一段视频对比效果。如果系统相机有效而你的应用无效可能是配置问题。开启EIS后预览画面有黑边或视野明显变小。EIS正在工作预览界面显示的是裁剪后的稳定画面。这是正常现象。确认最终录制的视频视野是否与预览一致。如果UI需要精确构图需提示用户或提供构图辅助线。开启防抖后画面出现果冻效应滚动快门失真加剧。EIS算法与传感器的读出时间同步不佳运动估计错误。1. 尝试关闭EIS只使用OIS如果支持。2. 尝试降低视频录制分辨率或帧率。3. 此问题可能与特定机型驱动有关需反馈给厂商。录制视频时防抖效果时好时坏或在开始/停止时画面跳动。在预览请求和录制请求切换时防抖模式切换不同步或重置。1. 确保mRecordingRequest正确包含了所有防抖设置。2. 在startRecording()和stopRecordingAndBackToPreview()时检查请求是否成功设置。3. 在CaptureCallback中监听CaptureResult打印LENS_OPTICAL_STABILIZATION_MODE和CONTROL_VIDEO_STABILIZATION_MODE的实际值确认与请求一致。支持OIS但LENS_OPTICAL_STABILIZATION_MODE_ON设置无效。可能在某些模式下如手动对焦CONTROL_AF_MODE_OFFOIS被强制禁用。1. 检查对焦模式。尝试使用CONTROL_AF_MODE_CONTINUOUS_VIDEO或CONTROL_AF_MODE_CONTINUOUS_PICTURE。2. 检查是否处于高分辨率拍照模式如全像素模式有些设备在该模式下会禁用OIS。6.2 通过CaptureResult验证状态调试防抖问题最有效的方法之一是检查从相机返回的CaptureResult它反映了请求参数的实际生效状态。private CameraCaptureSession.CaptureCallback mCaptureCallback new CameraCaptureSession.CaptureCallback() { Override public void onCaptureCompleted(NonNull CameraCaptureSession session, NonNull CaptureRequest request, NonNull TotalCaptureResult result) { Integer opticalStabMode result.get(CaptureResult.LENS_OPTICAL_STABILIZATION_MODE); Integer videoStabMode result.get(CaptureResult.CONTROL_VIDEO_STABILIZATION_MODE); Log.d(TAG, “CaptureResult - OIS Mode: ” opticalStabMode “, VideoStab Mode: ” videoStabMode); // 对比你设置的请求值看是否一致 // 如果不一致说明HAL拒绝了你的设置或者有更高优先级的控制逻辑覆盖了它。 } }; // 在设置重复请求时传入这个回调 mCaptureSession.setRepeatingRequest(mPreviewRequest, mCaptureCallback, null);6.3 厂商特定行为与适配“超级防抖”或“运动防抖”模式许多厂商在原生Camera2API之上实现了自己的增强防抖算法通常结合了更激进的EIS裁剪、多帧融合甚至AI预测。这些模式可能无法通过标准的Camera2API开启需要调用厂商私有的SDK或使用特定的Intent跳转到系统相机。如果你的应用对防抖有极致要求需要研究目标机型的具体开发文档。前后摄像头差异后置主摄通常配备OIS而前置摄像头几乎都没有OIS。EIS的支持情况也前后不一。你的代码需要根据摄像头ID分别查询和配置。多摄像头切换在广角、超广角、长焦之间切换时每个摄像头的防抖能力是独立的。必须在每次摄像头切换后重新查询其CameraCharacteristics。7. 超越API算法增强与未来展望对于追求极致稳定性的应用仅仅依赖系统API可能不够。我们可以考虑在应用层进行算法增强。7.1 应用层视频稳定算法即使硬件和系统提供了防抖你仍然可以在获取到视频帧数据例如通过ImageReader后使用软件算法进行二次稳定。开源库如Google的GyroStabilizer原理基于陀螺仪数据或基于特征点光流的算法如OpenCV中的videostab模块可以作为参考。基本思路在录制视频时同步高频率地收集陀螺仪和加速度计数据并打上精确的时间戳。对每一视频帧根据其时间戳找到对应的传感器数据序列。使用传感器数据计算相机在曝光期间的运动轨迹并进行平滑滤波。对该帧图像进行相应的仿射变换旋转、平移来抵消运动。将处理后的帧重新编码到输出视频流。挑战性能开销CPU/GPU上进行逐帧图像变换非常耗电对实时性要求高的场景如直播挑战巨大。时间戳同步精确对齐传感器数据和视频帧时间戳是关键难点微小的偏差会导致明显的果冻效应。画质损失与EIS类似需要进行裁剪和插值导致分辨率损失。因此应用层算法更适合后期处理或者在系统防抖效果不理想时作为补充。7.2 Android 13 与 CameraX 的进展在最新的Android版本和Jetpack CameraX库中Google正在简化相机开发防抖配置也不例外。CameraX提供了更高级的APIVideoCapture。你可以通过VideoCapture.Builder.setVideoStabilizationEnabled()来启用防抖库会帮你处理大部分兼容性逻辑。这是新项目的推荐方式能减少大量样板代码和兼容性处理工作。Android 13 (API 33)引入了CONTROL_VIDEO_STABILIZATION_MODE_PREVIEW_STABILIZATION的完善支持并可能在未来提供更精细的防抖强度控制。对于新项目强烈建议评估使用CameraX。对于需要深度定制或维护现有Camera2代码库的项目理解本文所述的底层原理依然至关重要。7.3 实战心得防抖配置的“黄金法则”在我经手的多个相机相关项目中总结出几条关于防抖配置的实用经验先查后用永远不要假设在任何设备上防抖都是可选的增强功能。代码必须健壮地处理“不支持”的情况并优雅降级。OIS优先EIS补充如果设备支持OIS在大多数情况下都应该开启它。它从物理层面改善画质且通常功耗可接受。EIS则作为处理大幅度运动的补充手段。预览与录制区别对待预览更注重低延迟和流畅录制更注重高质量稳定输出。利用好PREVIEW_STABILIZATION和标准VIDEO_STABILIZATION模式的区别。分辨率是朋友也是敌人更高的分辨率给EIS提供了更多裁剪空间但也带来了更大的计算负担和功耗。找到设备在该分辨率下支持防抖的“甜点”很重要通常1080p是兼容性最好的选择。用结果验证请求一定要通过CaptureResult监听关键模式的实际生效状态。这是排查兼容性问题最直接的证据。用户感知至上防抖的最终目的是提升体验。如果开启防抖导致预览卡顿、耗电剧增或视野损失过大需要考虑提供开关让用户选择。技术是为体验服务的。
有限公司新闻资讯优化方案)
