@ohos.multimedia.cameraPicker (相机选择器)
本模块提供相机拍照与录制的能力。应用可以自行选择媒体类型实现拍照和录制的功能。该类接口,需要应用在界面UIAbility中调用,否则无法拉起cameraPicker应用。
说明:
本模块首批接口从API version 11开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
导入模块
import picker from '@ohos.multimedia.cameraPicker';
pick
pick(context: Context, mediaTypes: Array<PickerMediaType>, pickerProfile: PickerProfile): Promise<PickerResult>
拉起相机选择器,根据媒体类型进入相应的模式。操作结束通过Promise形式获取结果。
系统能力: SystemCapability.Multimedia.Camera.Core
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
context | Context | 是 | 应用上下文。 |
mediaTypes | Array<PickerMediaType> | 是 | 媒体类型。 |
pickerProfile | PickerProfile | 是 | pickerProfile对象。 |
返回值:
类型 | 说明 |
---|---|
Promise<PickerResult> | 使用Promise的方式获取相机选择器的处理结果。具体返回值PickerResult |
示例:
import picker from '@ohos.multimedia.cameraPicker';
import camera from '@ohos.multimedia.camera';
import common from '@ohos.app.ability.common';
import { BusinessError } from '@ohos.base';
let mContext = getContext(this) as common.Context;
async function demo() {
try {
let pickerProfile: picker.PickerProfile = {
cameraPosition: camera.CameraPosition.CAMERA_POSITION_BACK
};
let pickerResult: picker.PickerResult = await picker.pick(mContext,
[picker.PickerMediaType.PHOTO, picker.PickerMediaType.VIDEO], pickerProfile);
console.log("the pick pickerResult is:" + JSON.stringify(pickerResult));
} catch (error) {
let err = error as BusinessError;
console.error(`the pick call failed. error code: ${err.code}`);
}
}
PickerMediaType
枚举,相机选择器的媒体类型。
系统能力: SystemCapability.Multimedia.Camera.Core
名称 | 值 | 说明 |
---|---|---|
PHOTO | photo | 拍照模式 |
VIDEO | video | 录制模式 |
PickerProfile
相机选择器的配置信息。
系统能力: SystemCapability.Multimedia.Camera.Core
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
cameraPosition | CameraPosition | 是 | 相机的位置。 |
saveUri | string | 否 | 保存配置信息的uri。 |
videoDuration | number | 否 | 录制的最大时长。 |
PickerResult
相机选择器的处理结果。
系统能力: SystemCapability.Multimedia.Camera.Core
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
resultCode | number | 是 | 处理的结果,成功返回0,失败返回-1。 |
resultUri | string | 是 | 返回的uri地址。若saveUri为空,resultUri为公共媒体路径。若saveUri不为空且具备写权限,resultUri与saveUri相同。若saveUri不为空且不具备写权限,则无法获取到resultUri。 |
mediaType | PickerMediaType | 是 | 返回的媒体类型。 |