• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 设备输入(ArkTS)
2
3在开发相机应用时，需要先申请相机相关权限[开发准备](camera-preparation.md)。
4相机应用可通过调用和控制相机设备，完成预览、拍照和录像等基础操作。
5
6## 开发步骤
7
8详细的API说明请参考[Camera API参考](../../reference/apis-camera-kit/js-apis-camera.md)。
9
101. 导入camera接口，接口中提供了相机相关的属性和方法，导入方法如下。
11
12   ```ts
13   import { camera } from '@kit.CameraKit';
14   import { BusinessError } from '@kit.BasicServicesKit';
15   ```
16
17   > **说明：**
18   >
19   > 在相机设备输入之前需要先完成相机管理，详细开发步骤请参考[相机管理](camera-device-management.md)。
20
212. 通过[cameraManager](../../reference/apis-camera-kit/js-apis-camera.md#cameramanager)类中的[createCameraInput](../../reference/apis-camera-kit/js-apis-camera.md#createcamerainput)方法创建相机输入流。
22
23   ```ts
24   async function createInput(cameraDevice: camera.CameraDevice, cameraManager: camera.CameraManager): Promise<camera.CameraInput | undefined> {
25     // 创建相机输入流
26     let cameraInput: camera.CameraInput | undefined = undefined;
27     try {
28       cameraInput = cameraManager.createCameraInput(cameraDevice);
29     } catch (error) {
30       let err = error as BusinessError;
31       console.error('Failed to createCameraInput errorCode = ' + err.code);
32     }
33     if (cameraInput === undefined) {
34       return undefined;
35     }
36     // 监听cameraInput错误信息
37     cameraInput.on('error', cameraDevice, (error: BusinessError) => {
38       console.error(`Camera input error code: ${error.code}`);
39     });
40     // 打开相机
41     await cameraInput.open();
42     return cameraInput;
43   }
44   ```
45
463. 通过[getSupportedSceneModes](../../reference/apis-camera-kit/js-apis-camera.md#getsupportedscenemodes11)方法，获取当前相机设备支持的模式列表，列表中存储了相机设备支持的所有模式[SceneMode](../../reference/apis-camera-kit/js-apis-camera.md#scenemode11)。
47
48    ```ts
49    function getSupportedSceneMode(cameraDevice: camera.CameraDevice, cameraManager: camera.CameraManager): Array<camera.SceneMode> {
50      // 获取相机设备支持的模式列表
51      let sceneModeArray: Array<camera.SceneMode> = cameraManager.getSupportedSceneModes(cameraDevice);
52      if (sceneModeArray != undefined && sceneModeArray.length > 0) {
53        for (let index = 0; index < sceneModeArray.length; index++) {
54          console.info('Camera SceneMode : ' + sceneModeArray[index]);
55      }
56        return sceneModeArray;
57      } else {
58          console.error("cameraManager.getSupportedSceneModes error");
59          return [];
60      }
61    }
62    ```
63
644. 通过[getSupportedOutputCapability](../../reference/apis-camera-kit/js-apis-camera.md#getsupportedoutputcapability11)方法，获取当前相机设备支持的所有输出流，如预览流、拍照流、录像流等。输出流在[CameraOutputCapability](../../reference/apis-camera-kit/js-apis-camera.md#cameraoutputcapability)中的各个profile字段中，根据相机设备指定模式[SceneMode](../../reference/apis-camera-kit/js-apis-camera.md#scenemode11)的不同，需要添加不同类型的输出流。
65
66   ```ts
67   async function getSupportedOutputCapability(cameraDevice: camera.CameraDevice, cameraManager: camera.CameraManager, sceneMode: camera.SceneMode): Promise<camera.CameraOutputCapability | undefined> {
68      // 获取相机设备支持的输出流能力
69      let cameraOutputCapability: camera.CameraOutputCapability = cameraManager.getSupportedOutputCapability(cameraDevice, sceneMode);
70      if (!cameraOutputCapability) {
71        console.error("cameraManager.getSupportedOutputCapability error");
72        return undefined;
73      }
74      console.info("outputCapability: " + JSON.stringify(cameraOutputCapability));
75      // 以NORMAL_PHOTO模式为例，需要添加预览流、拍照流
76      // previewProfiles属性为获取当前设备支持的预览输出流
77      let previewProfilesArray: Array<camera.Profile> = cameraOutputCapability.previewProfiles;
78      if (!previewProfilesArray) {
79        console.error("createOutput previewProfilesArray == null || undefined");
80      }
81      //photoProfiles属性为获取当前设备支持的拍照输出流
82      let photoProfilesArray: Array<camera.Profile> = cameraOutputCapability.photoProfiles;
83      if (!photoProfilesArray) {
84        console.error("createOutput photoProfilesArray == null || undefined");
85      }
86      return cameraOutputCapability;
87   }
88   ```