You need to enable JavaScript to run this app. Flutter中减小Camera预览容器高度时画面拉伸该如何解决
优惠活动
大模型
产品
解决方案
定价
更多

Flutter中减小Camera预览容器高度时画面拉伸该如何解决

Flutter相机预览拉伸变形解决方案

问题根因

CameraPreview 默认会直接填充父容器的全部尺寸,不会主动维持相机硬件输出的原生预览宽高比,当父容器宽高比和相机预览原生宽高比不一致时,就会出现画面拉伸变形的问题。

最优修复方案

无需修改外层固定宽高的Container代码,仅需要调整_cameraPreviewWidget中CameraPreview的包裹逻辑即可:

/// Display Camera preview.
Widget _cameraPreviewWidget() {
  if (controller == null || !controller.value.isInitialized) {
    return const Text(
      'Loading',
      style: TextStyle(
        color: Colors.white,
        fontSize: 20.0,
        fontWeight: FontWeight.w900,
      ),
    );
  }
  return ClipRect(
    child: FittedBox(
      // 根据需求选适配模式:
      // BoxFit.cover = 等比缩放铺满父容器,超出部分裁剪(无黑边,推荐)
      // BoxFit.contain = 等比缩放完整显示预览,父容器留白边(无内容裁剪)
      fit: BoxFit.cover,
      child: AspectRatio(
        // 用相机原生宽高比保证预览比例正确
        aspectRatio: controller.value.aspectRatio,
        child: CameraPreview(controller),
      ),
    ),
  );
}

逻辑说明

  • 先通过controller.value.aspectRatio获取相机硬件输出预览的原生宽高比,从根源保证预览比例正确
  • AspectRatio组件按照原生比例约束CameraPreview的布局,避免预览本身被拉伸
  • FittedBox组件根据设置的适配模式,将固定比例的预览画面等比缩放到适配外层固定尺寸的Container
  • ClipRect组件裁剪超出父容器范围的预览内容,避免布局溢出

注意事项

  • 如果你的应用支持横竖屏切换,需要在屏幕方向变更时触发组件刷新,重新读取最新的相机宽高比
  • 部分老旧设备可能出现系统返回的相机宽高比异常的情况,可以手动替换controller.value.aspectRatio为常用的16/9、4/3比例测试适配效果

内容的提问来源于stack exchange,提问作者JSDrogon

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.21 00:57:03