相机管理(ArkTS)
===========

在开发一个相机应用前，需要先通过调用相机接口来创建一个相机管理实例。

#### 开发步骤

详细的API说明请参考[@ohos.multimedia.camera (相机管理)](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-camera)。

1.  导入camera接口，接口中提供了相机相关的属性和方法，导入方法如下。
    
    import { camera } from '@kit.CameraKit';
    import { BusinessError } from '@kit.BasicServicesKit';
    import { common } from '@kit.AbilityKit';
    
2.  通过[getCameraManager](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-camera-f#cameragetcameramanager)方法，获取cameraManager对象。
    
    Context获取方式请参考：[获取UIAbility的上下文信息](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/uiability-usage#获取uiability的上下文信息)。
    
    function getCameraManager(context: common.BaseContext): camera.CameraManager | undefined {
      let cameraManager: camera.CameraManager;
      try {
        cameraManager = camera.getCameraManager(context);
      } catch (error) {
        let err = error as BusinessError;
        console.error(\`getCameraManager error, errCode: ${err.code}\`);
        return undefined;
      }
      return cameraManager;
    }
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/56/v3/ApL5UD4zRV6ljNimo_TLBA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073512Z&HW-CC-Expire=86400&HW-CC-Sign=BFC6A7DC1251CEF9FDA22A1ECA3DAC00E16C7E03363E3F0075B606F8261047BE)
    
    如果获取对象失败，说明相机可能被占用或无法使用。如果被占用，须等到相机被释放后才能重新获取。
    
3.  通过[CameraManager](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-camera-cameramanager)中的[getSupportedCameras](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-camera-cameramanager#getsupportedcameras)方法，获取当前设备支持的相机列表，列表中存储了设备支持的所有相机ID。若列表不为空，则说明列表中的每个ID都支持独立创建相机对象；否则，说明当前设备无可用相机，无法进行后续操作。
    
    function getCameraDevices(cameraManager: camera.CameraManager): Array<camera.CameraDevice> {
      let cameraArray: Array<camera.CameraDevice> = cameraManager.getSupportedCameras();
      if (cameraArray != undefined && cameraArray.length > 0) {
        for (let index = 0; index < cameraArray.length; index++) {
          console.info('cameraId : ' + cameraArray\[index\].cameraId);  // 获取相机ID。
          console.info('cameraPosition : ' + cameraArray\[index\].cameraPosition);  // 获取相机位置。
          console.info('cameraType : ' + cameraArray\[index\].cameraType);  // 获取相机类型。
          console.info('connectionType : ' + cameraArray\[index\].connectionType);  // 获取相机连接类型。
        }
        return cameraArray;
      } else {
        console.error("cameraManager.getSupportedCameras error");
        return \[\];
      }
    }
    

#### 状态监听

在相机应用开发过程中，可以随时监听相机状态，包括新相机的出现、相机的移除、相机的可用状态。在回调函数中，通过相机ID、相机状态这两个参数进行监听，如当有新相机出现时，可以将新相机加入到应用的备用相机中。

通过注册cameraStatus事件，通过回调返回监听结果，callback返回CameraStatusInfo参数，参数的具体内容可参考相机管理器回调接口实例[CameraStatusInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-camera-i#camerastatusinfo)。

function onCameraStatusChange(cameraManager: camera.CameraManager): void {
  cameraManager.on('cameraStatus', (err: BusinessError, cameraStatusInfo: camera.CameraStatusInfo) => {
    if (err !== undefined && err.code !== 0) {
      console.error(\`Callback Error, errorCode: ${err.code}\`);
      return;
    }
    // 如果当通过USB连接相机设备时，回调函数会返回新的相机出现状态。
    if (cameraStatusInfo.status == camera.CameraStatus.CAMERA\_STATUS\_APPEAR) {
      console.info(\`New Camera device appear.\`);
    }
    // 如果当断开相机设备USB连接时，回调函数会返回相机被移除状态。
    if (cameraStatusInfo.status == camera.CameraStatus.CAMERA\_STATUS\_DISAPPEAR) {
      console.info(\`Camera device has been removed.\`);
    }
    // 相机被关闭时，回调函数会返回相机可用状态。
    if (cameraStatusInfo.status == camera.CameraStatus.CAMERA\_STATUS\_AVAILABLE) {
      console.info(\`Current Camera is available.\`);
    }
    // 相机被打开/占用时，回调函数会返回相机不可用状态。
    if (cameraStatusInfo.status == camera.CameraStatus.CAMERA\_STATUS\_UNAVAILABLE) {
      console.info(\`Current Camera has been occupied.\`);
    }
    console.info(\`camera: ${cameraStatusInfo.camera.cameraId}\`);
    console.info(\`status: ${cameraStatusInfo.status}\`);
  });
}