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