harmony 鸿蒙设备输入(ArkTS)

2025-06-12
浏览 (5)

设备输入(ArkTS)

在开发相机应用时，需要先参考开发准备申请相关权限。

相机应用可通过调用和控制相机设备，完成预览、拍照和录像等基础操作。

开发步骤

详细的API说明请参考Camera API参考。

导入camera接口，接口中提供了相机相关的属性和方法，导入方法如下。

   import { camera } from '@kit.CameraKit';
   import { BusinessError } from '@kit.BasicServicesKit';

说明：

在相机设备输入之前需要先完成相机管理，详细开发步骤请参考相机管理。

通过cameraManager类中的createCameraInput方法创建相机输入流。

   async function createInput(cameraDevice: camera.CameraDevice, cameraManager: camera.CameraManager): Promise<camera.CameraInput|undefined> {
     // 创建相机输入流。
     let cameraInput: camera.CameraInput|undefined = undefined;
     try {
       cameraInput = cameraManager.createCameraInput(cameraDevice);
     } catch (error) {
       let err = error as BusinessError;
       console.error('Failed to createCameraInput errorCode = ' + err.code);
     }
     if (cameraInput === undefined) {
       return undefined;
     }
     // 监听cameraInput错误信息。
     cameraInput.on('error', cameraDevice, (error: BusinessError) => {
       console.error(`Camera input error code: ${error.code}`);
     });
     // 打开相机。
     await cameraInput.open();
     return cameraInput;
   }

通过getSupportedSceneModes方法，获取当前相机设备支持的模式列表，列表中存储了相机设备支持的所有模式SceneMode。

function getSupportedSceneMode(cameraDevice: camera.CameraDevice, cameraManager: camera.CameraManager): Array<camera.SceneMode> {
  // 获取相机设备支持的模式列表。
  let sceneModeArray: Array<camera.SceneMode> = cameraManager.getSupportedSceneModes(cameraDevice);
  if (sceneModeArray != undefined && sceneModeArray.length > 0) {
    for (let index = 0; index < sceneModeArray.length; index++) {
      console.info('Camera SceneMode : ' + sceneModeArray[index]);  
  }
    return sceneModeArray;
  } else {
      console.error("cameraManager.getSupportedSceneModes error");
      return [];
  }
}

通过getSupportedOutputCapability方法，获取当前相机设备支持的所有输出流，如预览流、拍照流、录像流等。输出流在CameraOutputCapability中的各个profile字段中，根据相机设备指定模式SceneMode的不同，需要添加不同类型的输出流。

   async function getSupportedOutputCapability(cameraDevice: camera.CameraDevice, cameraManager: camera.CameraManager, sceneMode: camera.SceneMode): Promise<camera.CameraOutputCapability|undefined> {
      // 获取相机设备支持的输出流能力。
      let cameraOutputCapability: camera.CameraOutputCapability = cameraManager.getSupportedOutputCapability(cameraDevice, sceneMode);
      if (!cameraOutputCapability) {
        console.error("cameraManager.getSupportedOutputCapability error");
        return undefined;
      }
      console.info("outputCapability: " + JSON.stringify(cameraOutputCapability));
      // 以NORMAL_PHOTO模式为例，需要添加预览流、拍照流。
      // previewProfiles属性为获取当前设备支持的预览输出流。
      let previewProfilesArray: Array<camera.Profile> = cameraOutputCapability.previewProfiles;
      if (!previewProfilesArray) {
        console.error("createOutput previewProfilesArray == null||undefined");
      }
      //photoProfiles属性为获取当前设备支持的拍照输出流。
      let photoProfilesArray: Array<camera.Profile> = cameraOutputCapability.photoProfiles;
      if (!photoProfilesArray) {
        console.error("createOutput photoProfilesArray == null||undefined");
      }
      return cameraOutputCapability;
   }