1# @ohos.multimedia.cameraPicker (相机选择器)
2
3本模块提供相机拍照与录制的能力。应用可以自行选择媒体类型实现拍照和录制的功能。该类接口,需要应用在界面UIAbility中调用,否则无法拉起cameraPicker应用。
4
5开发者需在release模式下调用系统相机(CameraPicker),在debug模式下会显示异常。
6
7> **说明:**
8>
9> 本模块首批接口从API version 11开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
10
11## 导入模块
12
13```ts
14import { cameraPicker as picker } from '@kit.CameraKit';
15```
16
17## pick
18
19pick(context: Context, mediaTypes: Array\<PickerMediaType\>, pickerProfile: PickerProfile): Promise\<PickerResult\>
20
21拉起相机选择器,根据媒体类型进入相应的模式。操作结束通过Promise形式获取结果。
22
23**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
24
25**系统能力:** SystemCapability.Multimedia.Camera.Core
26
27**参数:**
28
29| 参数名          | 类型                                              | 必填 | 说明                           |
30| -------------- |-------------------------------------------------| ---- | ---------------------------- |
31| context        | [Context](../apis-ability-kit/js-apis-inner-application-context.md) | 是   | 应用上下文。                   |
32| mediaTypes     | Array\<[PickerMediaType](#pickermediatype)\>    | 是   | 媒体类型。                    |
33| pickerProfile  | [PickerProfile](#pickerprofile)                 | 是   | pickerProfile对象。            |
34
35**返回值:**
36
37| 类型                                             | 说明                                                                                   |
38| ----------------------------------------------- | -------------------------------------------------------------------------------------- |
39| Promise\<PickerResult\>                         | 使用Promise的方式获取相机选择器的处理结果。具体返回值[PickerResult](#pickerresult)           |
40
41
42**示例:**
43
44```ts
45import { cameraPicker as picker } from '@kit.CameraKit';
46import { camera } from '@kit.CameraKit';
47import { common } from '@kit.AbilityKit';
48import { BusinessError } from '@kit.BasicServicesKit';
49let mContext = getContext(this) as common.Context;
50
51async function demo() {
52  try {
53    let pickerProfile: picker.PickerProfile = {
54      cameraPosition: camera.CameraPosition.CAMERA_POSITION_BACK
55    };
56    let pickerResult: picker.PickerResult = await picker.pick(mContext,
57      [picker.PickerMediaType.PHOTO, picker.PickerMediaType.VIDEO], pickerProfile);
58    console.log("the pick pickerResult is:" + JSON.stringify(pickerResult));
59  } catch (error) {
60    let err = error as BusinessError;
61    console.error(`the pick call failed. error code: ${err.code}`);
62  }
63}
64```
65
66## PickerMediaType
67
68枚举,相机选择器的媒体类型。
69
70**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
71
72**系统能力:** SystemCapability.Multimedia.Camera.Core
73
74| 名称             | 值    | 说明     |
75| ----------------| ----  | ---------|
76| PHOTO           | photo | 拍照模式  |
77| VIDEO           | video | 录制模式  |
78
79
80## PickerProfile
81
82相机选择器的配置信息。
83
84**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
85
86**系统能力:** SystemCapability.Multimedia.Camera.Core
87
88| 名称           | 类型                               | 必填   | 说明         |
89| -------------- | --------------------------------- | ----- | ------------ |
90| cameraPosition       | [camera.CameraPosition](js-apis-camera.md#cameraposition) | 是    | 相机的位置。   |
91| saveUri        | string                            | 否    | 保存配置信息的uri。|
92| videoDuration  | number                            | 否    | 录制的最大时长。|
93
94
95## PickerResult
96
97相机选择器的处理结果。
98
99**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。
100
101**系统能力:** SystemCapability.Multimedia.Camera.Core
102
103| 名称           | 类型                                | 必填  | 说明                            |
104| -------------- | ---------------------------------- | ----- | -------------------------------- |
105| resultCode     | number                             | 是    | 处理的结果,成功返回0,失败返回-1。 |
106| resultUri      | string                             | 是    | 返回的uri地址。若saveUri为空,resultUri为公共媒体路径。若saveUri不为空且具备写权限,resultUri与saveUri相同。若saveUri不为空且不具备写权限,则无法获取到resultUri。|
107| mediaType      | [PickerMediaType](#pickermediatype)| 是    | 返回的媒体类型。                  |