鸿蒙PC相机开发中的旋转适配技术解析

1. 鸿蒙PC相机开发中的旋转适配挑战

最近在开发一款面向鸿蒙PC（特别是折叠屏笔记本形态设备）的相机应用时，遇到了一个棘手的问题：当用户旋转或折叠屏幕时，相机预览画面会出现方向错乱。这看似简单的问题背后，实际上涉及到硬件安装角度、屏幕旋转补偿和图像处理等多个技术层面的协同工作。

在传统PC上，相机通常固定安装在屏幕上方，开发者很少需要考虑旋转适配问题。但折叠屏设备带来了全新的使用场景：设备可能处于笔记本模式、平板模式、帐篷模式等多种形态，每种形态下屏幕的物理朝向都可能不同。这就意味着我们必须动态计算相机预览的正确方向。

2. 核心概念解析与技术方案设计

2.1 关键角度定义与计算逻辑

要解决这个问题，首先需要理解三个核心角度概念：

1. 镜头安装角度：这是相机硬件在设备上的物理安装角度。比如在传统笔记本上，摄像头通常安装在屏幕顶部中央，安装角度为0°；而在某些二合一设备中，摄像头可能以90°或270°的角度安装。这个角度可以通过CameraManager.getSupportedCameras()接口获取。

2. 屏幕显示补偿角度：当用户旋转或折叠设备时，屏幕的物理朝向发生变化，需要通过这个角度来补偿。可以通过Display.rotation获取当前屏幕的旋转状态（0°、90°、180°或270°）。

3. 预览旋转角度：这是最终需要设置的角度值，计算公式为：

   code复制预览旋转角度 = (镜头安装角度 + 屏幕显示补偿角度) % 360
   

2.2 系统API深度解析

鸿蒙系统提供了完整的API支持来实现这一功能：

typescript复制// 获取显示设备信息
const defaultDisplay = display.getDefaultDisplaySync();
const screenRotation = defaultDisplay.rotation; // 屏幕当前旋转角度

// 获取相机信息
const cameraManager = camera.getCameraManager();
const cameras = cameraManager.getSupportedCameras();
const backCamera = cameras.find(info => info.position === camera.CameraPosition.CAMERA_POSITION_BACK);
const lensAngle = backCamera?.orientation || 0; // 镜头安装角度

// 设置预览旋转
const previewRotation = (lensAngle + screenRotation) % 360;
cameraSession.setPreviewRotation(previewRotation);

3. 完整实现方案与代码详解

3.1 项目配置与权限申请

在开始编码前，需要在module.json5中配置必要的权限：

json复制{
  "module": {
    "requestPermissions": [
      {
        "name": "ohos.permission.CAMERA",
        "reason": "用于相机预览和拍照"
      },
      {
        "name": "ohos.permission.MICROPHONE",
        "reason": "如需视频录制需要麦克风权限"
      }
    ]
  }
}

注意：鸿蒙系统采用动态权限机制，除了在配置文件中声明，还需要在运行时请求用户授权。

3.2 相机管理器封装实现

我们创建一个CameraRotationAdapter类来封装所有相机相关操作：

typescript复制import camera from '@ohos.multimedia.camera';
import display from '@ohos.display';
import { BusinessError } from '@ohos.base';

export class CameraRotationAdapter {
  private cameraManager: camera.CameraManager | null = null;
  private currentCamera: camera.CameraDevice | null = null;
  private cameraSession: camera.CameraSession | null = null;

  // 初始化相机管理器
  public initCameraManager(): void {
    try {
      this.cameraManager = camera.getCameraManager();
      console.info('相机管理器初始化成功');
    } catch (error) {
      this.handleError('相机管理器初始化失败', error);
    }
  }

  // 获取镜头安装角度
  private getLensInstallAngle(): number {
    if (!this.cameraManager) return 0;
    
    try {
      const cameraInfos = this.cameraManager.getSupportedCameras();
      const backCamera = cameraInfos.find(info => 
        info.position === camera.CameraPosition.CAMERA_POSITION_BACK
      );
      return backCamera?.orientation || 0;
    } catch (error) {
      this.handleError('获取镜头安装角度失败', error);
      return 0;
    }
  }

  // 错误处理统一方法
  private handleError(context: string, error: unknown): void {
    const err = error as BusinessError;
    console.error(`${context}: ${err.code} - ${err.message}`);
  }
}

3.3 屏幕旋转监听与实时适配

为了实现实时旋转适配，我们需要监听屏幕旋转事件：

typescript复制// 在CameraRotationAdapter类中添加
private rotationListener: display.DisplayRotationListener | null = null;

// 注册屏幕旋转监听
public registerRotationListener(): void {
  try {
    this.rotationListener = (newRotation: number) => {
      console.info(`屏幕旋转角度变化: ${newRotation}°`);
      this.updatePreviewRotation();
    };
    display.on('rotationChange', this.rotationListener);
  } catch (error) {
    this.handleError('注册旋转监听失败', error);
  }
}

// 更新预览旋转角度
private async updatePreviewRotation(): Promise<void> {
  if (!this.cameraSession) return;
  
  const previewRotation = this.calculatePreviewRotation();
  try {
    await this.cameraSession.setPreviewRotation(previewRotation);
    console.info(`预览旋转角度已更新为: ${previewRotation}°`);
  } catch (error) {
    this.handleError('更新预览旋转失败', error);
  }
}

// 计算预览旋转角度
private calculatePreviewRotation(): number {
  const lensAngle = this.getLensInstallAngle();
  const screenAngle = this.getScreenRotationAngle();
  return (lensAngle + screenAngle) % 360;
}

4. 高级应用场景与性能优化

4.1 预览流二次处理方案

当需要对相机预览流进行自定义处理（如添加滤镜、人脸识别等）时，旋转适配会更加复杂。我们提供两种方案：

方案一：镜像成像场景（推荐）

typescript复制public processMirrorFrame(frame: Image): Image {
  const rotation = this.calculatePreviewRotation();
  // 使用系统提供的图像旋转方法
  return image.createRotatedImage(frame, rotation);
}

方案二：非镜像成像场景（高性能）

typescript复制public processNonMirrorFrame(frame: Image): Image {
  const rotation = this.calculatePreviewRotation();
  // 使用硬件加速的自定义旋转
  return this.hardwareRotate(frame, rotation);
}

private hardwareRotate(frame: Image, angle: number): Image {
  // 实际实现会使用鸿蒙的Native层能力
  // 这里简化为示意代码
  const processor = new image.ImageProcessor();
  return processor.rotate(frame, angle);
}

4.2 性能优化关键点

1. 减少角度计算频率：只在屏幕旋转或相机初始化时计算角度，避免每帧都计算
2. 使用硬件加速：对于图像旋转操作，尽量使用ImageProcessor等硬件加速API
3. 避免内存拷贝：处理预览帧时尽量使用零拷贝技术
4. 异步处理：将耗时的旋转操作放在工作线程中执行

5. 实战经验与常见问题排查

5.1 开发中的六个关键注意事项

1. 设备兼容性测试：不同型号的鸿蒙PC可能有不同的镜头安装角度，必须实际测试
2. 权限时序控制：确保在调用相机API前已经获得用户授权
3. 资源释放：在页面销毁时务必释放相机资源
4. 异常处理：妥善处理相机被其他应用占用等情况
5. 性能监控：在折叠屏设备上持续旋转可能导致性能问题，需要做好降级方案
6. 多窗口适配：当应用处于分屏模式时，需要额外处理窗口尺寸变化

5.2 常见问题排查指南

6. 完整示例项目结构

建议的项目目录结构如下：

code复制/src/main/ets/
├── CameraComponents
│   ├── CameraRotationAdapter.ets  # 相机旋转适配核心类
│   └── CameraPreview.ets         # 预览组件
├── model
│   └── CameraModel.ets           # 相机业务逻辑
├── pages
│   └── CameraPage.ets            # 相机页面
└── resources
    └── media                     # 资源文件

在CameraPage中的基本使用示例：

typescript复制import { CameraRotationAdapter } from '../CameraComponents/CameraRotationAdapter';

@Entry
@Component
struct CameraPage {
  private cameraAdapter: CameraRotationAdapter = new CameraRotationAdapter();

  aboutToAppear() {
    this.cameraAdapter.initCameraManager();
    this.cameraAdapter.registerRotationListener();
  }

  onPageShow() {
    this.startCameraPreview();
  }

  onPageHide() {
    this.cameraAdapter.releaseCamera();
  }

  private async startCameraPreview() {
    const surface = await this.getPreviewSurface();
    await this.cameraAdapter.configCameraSession(surface);
  }

  // ...其他方法实现
}

在实际开发中，我发现正确处理相机生命周期与页面生命周期的关系至关重要。特别是在折叠屏设备上，应用可能频繁在前后台切换，必须确保相机资源及时释放和重新初始化。同时，对于需要高性能处理的场景，建议将图像处理逻辑放在Worker线程中执行，避免阻塞UI线程导致界面卡顿。