• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 设备输入
2
3在开发一个相机应用前，需要先创建一个独立的相机设备，应用通过调用和控制相机设备，完成预览、拍照和录像等基础操作。
4
5## 开发步骤
6
7详细的API说明请参考[Camera API参考](../reference/apis/js-apis-camera.md)。
8
91. 导入camera接口，接口中提供了相机相关的属性和方法，导入方法如下。
10
11   ```ts
12   import camera from '@ohos.multimedia.camera';
13   import { BusinessError } from '@ohos.base';
14   import common from '@ohos.app.ability.common';
15   ```
16
172. 通过getCameraManager()方法，获取cameraManager对象。
18   [BaseContext获取方式](../reference/apis/js-apis-inner-application-baseContext.md)。
19   ```ts
20   function getCameraManager(context: common.BaseContext): camera.CameraManager {
21     let cameraManager: camera.CameraManager = camera.getCameraManager(context);
22     return cameraManager;
23   }
24   ```
25
26   > **说明：**
27   >
28   > 如果获取对象失败，说明相机可能被占用或无法使用。如果被占用，须等到相机被释放后才能重新获取。
29
303. 通过cameraManager类中的getSupportedCameras()方法，获取当前设备支持的相机列表，列表中存储了设备支持的所有相机ID。若列表不为空，则说明列表中的每个ID都支持独立创建相机对象；否则，说明当前设备无可用相机，不可继续后续操作。
31
32   ```ts
33   function getCameraDevices(cameraManager: camera.CameraManager): Array<camera.CameraDevice> {
34     let cameraArray: Array<camera.CameraDevice> = cameraManager.getSupportedCameras();
35     if (cameraArray != undefined && cameraArray.length <= 0) {
36       console.error("cameraManager.getSupportedCameras error");
37       return [];
38     }
39     for (let index = 0; index < cameraArray.length; index++) {
40       console.info('cameraId : ' + cameraArray[index].cameraId);  // 获取相机ID
41       console.info('cameraPosition : ' + cameraArray[index].cameraPosition);  // 获取相机位置
42       console.info('cameraType : ' + cameraArray[index].cameraType);  // 获取相机类型
43       console.info('connectionType : ' + cameraArray[index].connectionType);  // 获取相机连接类型
44     }
45     return cameraArray;
46   }
47   ```
48
494. 通过getSupportedOutputCapability()方法，获取当前设备支持的所有输出流，如预览流、拍照流等。输出流在CameraOutputCapability中的各个profile字段中。
50
51   ```ts
52   async function getSupportedOutputCapability(cameraDevice: camera.CameraDevice, cameraManager: camera.CameraManager): Promise<camera.CameraOutputCapability | undefined> {
53     // 创建相机输入流
54     let cameraInput: camera.CameraInput | undefined = undefined;
55     try {
56       cameraInput = cameraManager.createCameraInput(cameraDevice);
57     } catch (error) {
58       let err = error as BusinessError;
59       console.error('Failed to createCameraInput errorCode = ' + err.code);
60     }
61     if (cameraInput === undefined) {
62       return undefined;
63     }
64     // 监听cameraInput错误信息
65     cameraInput.on('error', cameraDevice, (error: BusinessError) => {
66       console.info(`Camera input error code: ${error.code}`);
67     });
68     // 打开相机
69     await cameraInput.open();
70     // 获取相机设备支持的输出流能力
71     let cameraOutputCapability: camera.CameraOutputCapability = cameraManager.getSupportedOutputCapability(cameraDevice);
72     if (!cameraOutputCapability) {
73       console.error("cameraManager.getSupportedOutputCapability error");
74       return undefined;
75     }
76     console.info("outputCapability: " + JSON.stringify(cameraOutputCapability));
77     return cameraOutputCapability;
78   }
79   ```
80
81
82## 状态监听
83
84在相机应用开发过程中，可以随时监听相机状态，包括新相机的出现、相机的移除、相机的可用状态。在回调函数中，通过相机ID、相机状态这两个参数进行监听，如当有新相机出现时，可以将新相机加入到应用的备用相机中。
85
86  通过注册cameraStatus事件，通过回调返回监听结果，callback返回CameraStatusInfo参数，参数的具体内容可参考相机管理器回调接口实例[CameraStatusInfo](../reference/apis/js-apis-camera.md#camerastatusinfo)。
87
88```ts
89function onCameraStatus(cameraManager: camera.CameraManager): void {
90  cameraManager.on('cameraStatus', (err: BusinessError, cameraStatusInfo: camera.CameraStatusInfo) => {
91    console.info(`camera: ${cameraStatusInfo.camera.cameraId}`);
92    console.info(`status: ${cameraStatusInfo.status}`);
93  });
94}
95```
96