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)| 是 | 返回的媒体类型。 |