1# 相机管理(ArkTS) 2 3在开发一个相机应用前,需要先通过调用相机接口来创建一个独立的相机设备。 4 5## 开发步骤 6 7详细的API说明请参考[Camera API参考](../../reference/apis-camera-kit/js-apis-camera.md)。 8 91. 导入camera接口,接口中提供了相机相关的属性和方法,导入方法如下。 10 11 ```ts 12 import { camera } from '@kit.CameraKit'; 13 import { BusinessError } from '@kit.BasicServicesKit'; 14 import { common } from '@kit.AbilityKit'; 15 ``` 16 172. 通过[getCameraManager](../../reference/apis-camera-kit/js-apis-camera.md#cameragetcameramanager)方法,获取cameraManager对象。 18 19 Context获取方式请参考:[获取UIAbility的上下文信息](../../application-models/uiability-usage.md#获取uiability的上下文信息)。 20 21 ```ts 22 function getCameraManager(context: common.BaseContext): camera.CameraManager { 23 let cameraManager: camera.CameraManager = camera.getCameraManager(context); 24 return cameraManager; 25 } 26 ``` 27 28 > **说明:** 29 > 30 > 如果获取对象失败,说明相机可能被占用或无法使用。如果被占用,须等到相机被释放后才能重新获取。 31 323. 通过[CameraManager](../../reference/apis-camera-kit/js-apis-camera.md#cameramanager)类中的[getSupportedCameras](../../reference/apis-camera-kit/js-apis-camera.md#getsupportedcameras)方法,获取当前设备支持的相机列表,列表中存储了设备支持的所有相机ID。若列表不为空,则说明列表中的每个ID都支持独立创建相机对象;否则,说明当前设备无可用相机,不可继续后续操作。 33 34 ```ts 35 function getCameraDevices(cameraManager: camera.CameraManager): Array<camera.CameraDevice> { 36 let cameraArray: Array<camera.CameraDevice> = cameraManager.getSupportedCameras(); 37 if (cameraArray != undefined && cameraArray.length > 0) { 38 for (let index = 0; index < cameraArray.length; index++) { 39 console.info('cameraId : ' + cameraArray[index].cameraId); // 获取相机ID 40 console.info('cameraPosition : ' + cameraArray[index].cameraPosition); // 获取相机位置 41 console.info('cameraType : ' + cameraArray[index].cameraType); // 获取相机类型 42 console.info('connectionType : ' + cameraArray[index].connectionType); // 获取相机连接类型 43 } 44 return cameraArray; 45 } else { 46 console.error("cameraManager.getSupportedCameras error"); 47 return []; 48 } 49 } 50 ``` 51 52 53## 状态监听 54 55在相机应用开发过程中,可以随时监听相机状态,包括新相机的出现、相机的移除、相机的可用状态。在回调函数中,通过相机ID、相机状态这两个参数进行监听,如当有新相机出现时,可以将新相机加入到应用的备用相机中。 56 57 通过注册cameraStatus事件,通过回调返回监听结果,callback返回CameraStatusInfo参数,参数的具体内容可参考相机管理器回调接口实例[CameraStatusInfo](../../reference/apis-camera-kit/js-apis-camera.md#camerastatusinfo)。 58 59```ts 60function onCameraStatusChange(cameraManager: camera.CameraManager): void { 61 cameraManager.on('cameraStatus', (err: BusinessError, cameraStatusInfo: camera.CameraStatusInfo) => { 62 if (err !== undefined && err.code !== 0) { 63 console.error(`Callback Error, errorCode: ${err.code}`); 64 return; 65 } 66 // 如果当通过USB连接相机设备时,回调函数会返回新的相机出现状态 67 if (cameraStatusInfo.status == camera.CameraStatus.CAMERA_STATUS_APPEAR) { 68 console.info(`New Camera device appear.`); 69 } 70 // 如果当断开相机设备USB连接时,回调函数会返回相机被移除状态 71 if (cameraStatusInfo.status == camera.CameraStatus.CAMERA_STATUS_DISAPPEAR) { 72 console.info(`Camera device has been removed.`); 73 } 74 // 相机被关闭时,回调函数会返回相机可用状态 75 if (cameraStatusInfo.status == camera.CameraStatus.CAMERA_STATUS_AVAILABLE) { 76 console.info(`Current Camera is available.`); 77 } 78 // 相机被打开/占用时,回调函数会返回相机不可用状态 79 if (cameraStatusInfo.status == camera.CameraStatus.CAMERA_STATUS_UNAVAILABLE) { 80 console.info(`Current Camera has been occupied.`); 81 } 82 console.info(`camera: ${cameraStatusInfo.camera.cameraId}`); 83 console.info(`status: ${cameraStatusInfo.status}`); 84 }); 85} 86```