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