Flutter基于Google ML Kit人脸识别：横屏无法检测人脸问题求助

问题描述 #

开发基于Flutter的实时人脸识别应用时，竖屏模式下人脸检测功能正常，但切换至横屏模式后无法检测到人脸。

可能原因及解决方案 #

1. 相机预览方向未适配横屏 #

横屏时相机预览的输出方向若未正确旋转，会导致人脸检测模型接收到旋转后的图像，无法正常识别。

• 监听屏幕旋转事件，动态更新相机方向参数：

  WidgetsBinding.instance.addObserver(
    LifecycleEventHandler(
      didChangeMetrics: () {
        final orientation = MediaQuery.of(context).orientation;
        cameraController.setPreferredCameraOrientation(
          orientation == Orientation.portrait
              ? DeviceOrientation.portraitUp
              : DeviceOrientation.landscapeLeft,
        );
      },
    ),
  );
  

• 确保相机预览输出尺寸匹配横屏分辨率，避免图像拉伸变形影响检测精度。

2. 人脸检测模型的输入图像方向未校正 #

多数人脸检测模型默认基于竖屏图像训练，横屏时需先将图像旋转至模型预期方向再检测：

• 获取相机帧数据后，根据当前屏幕方向处理图像：

  Future<void> processCameraImage(CameraImage image) async {
    final orientation = MediaQuery.of(context).orientation;
    final processedImage = await rotateImage(image, orientation);
    final faces = await faceDetector.processImage(processedImage);
  }
  

• 若使用第三方检测库（如google_mlkit_face_detection），检查是否支持自动方向适配，或手动传入方向参数。

3. 检测区域未适配横屏布局 #

竖屏时设置的固定检测区域，在横屏时可能偏离实际画面，导致检测失效：

• 动态计算横屏模式下的检测区域，确保覆盖相机预览有效画面：

  final Size previewSize = cameraController.value.previewSize!;
  final Rect detectionRegion = orientation == Orientation.landscape
      ? Rect.fromLTWH(0, previewSize.height * 0.2, previewSize.width, previewSize.height * 0.6)
      : Rect.fromLTWH(previewSize.width * 0.2, 0, previewSize.width * 0.6, previewSize.height);
  

• 将动态计算的区域传入人脸检测器配置。

4. 屏幕旋转时未重新初始化检测资源 #

部分人脸检测组件在屏幕旋转后未重新初始化，会导致功能异常：

• 方向变化时销毁并重建检测器实例：

  void _onOrientationChanged(Orientation orientation) {
    faceDetector.close();
    faceDetector = FaceDetector(options: FaceDetectorOptions());
  }
  

额外排查点 #

• 检查项目是否锁定屏幕方向，导致横屏时相机仍以竖屏模式输出画面。
• 在不同设备上测试横屏表现，部分设备的相机传感器方向存在差异，需针对性适配。

项目代码仓库：https://github.com/maneesh8123/https---github.com-maneesh8123-Realtime-Face-Recognition
相关截图说明：包含竖屏正常识别状态、横屏无检测结果状态、应用横屏界面三张截图。

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