鸿蒙开发接口媒体：【@ohos.multimedia.camera (相机管理)】

 相机管理

说明：
开发前请熟悉鸿蒙开发指导文档： gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。
本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import camera from '@ohos.multimedia.camera';

camera.getCameraManager

getCameraManager(context: Context, callback: AsyncCallback<CameraManager>): void

获取相机管理器实例，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
contextContext是应用上下文。
callbackAsyncCallback<[CameraManager]>是回调函数，用于获取相机管理器实例。

示例：

camera.getCameraManager(context, (err, cameraManager) => {if (err) {console.error('Failed to get the CameraManager instance ${err.message}');return;}console.log('Callback returned with the CameraManager instance');
});

camera.getCameraManager

getCameraManager(context: Context): Promise<CameraManager>

获取相机管理器实例，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
contextContext是应用上下文。

返回值：

类型说明
Promise<[CameraManager]>使用Promise的方式获取一个相机管理器实例。

示例：

camera.getCameraManager(context).then((cameraManager) => {console.log('Promise returned with the CameraManager instance.');
})

CameraStatus

枚举，相机状态。

系统能力：  SystemCapability.Multimedia.Camera.Core

名称值说明
CAMERA_STATUS_APPEAR0相机存在。
CAMERA_STATUS_DISAPPEAR1相机不存在。
CAMERA_STATUS_AVAILABLE2相机就绪。
CAMERA_STATUS_UNAVAILABLE3相机未就绪。

CameraPosition

枚举，相机方向。

系统能力：  SystemCapability.Multimedia.Camera.Core

名称值说明
CAMERA_POSITION_UNSPECIFIED0未指定方向相机。
CAMERA_POSITION_BACK1后置相机。
CAMERA_POSITION_FRONT2前置相机。

CameraType

枚举，相机类型。

系统能力：  SystemCapability.Multimedia.Camera.Core

名称值说明
CAMERA_TYPE_UNSPECIFIED0未指定相机类型。
CAMERA_TYPE_WIDE_ANGLE1广角相机。
CAMERA_TYPE_ULTRA_WIDE2超级广角相机。
CAMERA_TYPE_TELEPHOTO3长焦相机。
CAMERA_TYPE_TRUE_DEPTH4深度相机。

ConnectionType

枚举，相机连接类型。

系统能力：  SystemCapability.Multimedia.Camera.Core

名称值说明
CAMERA_CONNECTION_BUILT_IN0内置相机。
CAMERA_CONNECTION_USB_PLUGIN1外置USB相机。
CAMERA_CONNECTION_REMOTE2分布式相机。

Size

用于表示相机预览、照片、视频支持的尺寸大小。

系统能力：  SystemCapability.Multimedia.Camera.Core

名称类型可读可写说明
heightstring是是图像的高度。
widthnumber是是图像的宽度。

CameraManager

相机管理器类，使用前需要通过getCameraManager获取相机管理实例。

getCameras

getCameras(callback: AsyncCallback<Array<Camera>>): void

异步获取设备支持的相机列表，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
callbackAsyncCallback<Array<[Camera]>>是使用callback方式获取支持的相机列表。

示例：

cameraManager.getCameras((err, cameras) => {if (err) {console.error('Failed to get the cameras. ${err.message}');return;}console.log('Callback returned with an array of supported cameras: ' + cameras.length);
})

getCameras

getCameras(): Promise<Array<Camera>>

异步获取设备支持的相机列表，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

返回值：

类型说明
Promise<Array<[Camera]>>使用promise获取支持相机列表。

示例：

cameraManager.getCameras().then((cameraArray) => {console.log('Promise returned with an array of supported cameras: ' + cameraArray.length);
})

createCameraInput

createCameraInput(cameraId: string, callback: AsyncCallback<CameraInput>): void

使用相机ID异步创建CameraInput实例，通过注册回调函数获取结果。

需要权限：  ohos.permission.CAMERA

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
cameraIdstring是指定相机ID。
callbackAsyncCallback<[CameraInput]>是回调函数，用于获取CameraInput实例。

示例：

cameraManager.createCameraInput(cameraId, (err, cameraInput) => {if (err) {console.error('Failed to create the CameraInput instance. ${err.message}');return;}console.log('Callback returned with the CameraInput instance.');
})

createCameraInput

createCameraInput(cameraId: string): Promise<CameraInput>

使用相机ID异步创建CameraInput实例，通过Promise获取结果。

需要权限：  ohos.permission.CAMERA

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
cameraIdstring是指定相机ID。

返回值：

类型说明
Promise<[CameraInput]>使用Promise的方式获取CameraInput的实例。

示例：

cameraManager.createCameraInput(cameraId).then((cameraInput) => {console.log('Promise returned with the CameraInput instance');
})

createCameraInput

createCameraInput(position: CameraPosition, type: CameraType, callback: AsyncCallback<CameraInput>): void

使用相机位置和相机类型异步创建CameraInput实例，通过注册回调函数获取结果。

需要权限：  ohos.permission.CAMERA

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
position[CameraPosition]是相机位置。
type[CameraType]是相机类型。
callbackAsyncCallback<[CameraInput]>是回调函数，用于获取CameraInput实例。

示例：

cameraManager.createCameraInput(camera.CameraPosition.CAMERA_POSITION_BACK, camera.CameraType.CAMERA_TYPE_UNSPECIFIED, (err, cameraInput) => {if (err) {console.error('Failed to create the CameraInput instance. ${err.message}');return;}console.log('Callback returned with the CameraInput instance');
})

createCameraInput

createCameraInput(position: CameraPosition, type: CameraType): Promise<CameraInput>

使用相机位置和相机类型异步创建CameraInput实例，通过Promise获取结果。

需要权限：  ohos.permission.CAMERA

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
position[CameraPosition]是相机位置。
type[CameraType]是相机类型。

返回值：

类型说明
Promise<[CameraInput]>使用Promise的方式获取CameraInput的实例。

示例：

cameraManager.createCameraInput(camera.CameraPosition.CAMERA_POSITION_BACK, camera.CameraType.CAMERA_TYPE_UNSPECIFIED).then((cameraInput) => {console.log('Promise returned with the CameraInput instance.');
})

on('cameraStatus')

on(type: 'cameraStatus', callback: AsyncCallback<CameraStatusInfo>): void

监听相机的状态变化，通过注册回调函数获取相机的状态变化。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
typestring是监听事件，固定为'cameraStatus'，即相机状态变化事件。
callbackAsyncCallback<[CameraStatusInfo]>是回调函数，用于获取相机状态变化信息。

示例：

cameraManager.on('cameraStatus', (err, cameraStatusInfo) => {if (err) {console.error('Failed to get cameraStatus callback. ${err.message}');return;}console.log('camera : ' + cameraStatusInfo.camera.cameraId);console.log('status: ' + cameraStatusInfo.status);
})

Camera

调用[camera.getCameraManager]后，将返回Camera实例，包括相机ID、位置、类型、连接类型等相机相关的元数据。

系统能力：  SystemCapability.Multimedia.Camera.Core。

名称类型只读说明
cameraIdstring是相机ID。
cameraPosition[CameraPosition]是相机位置。
cameraType[CameraType]是相机类型。
connectionType[ConnectionType]是相机连接类型。

示例：

async function getCameraInfo("cameraId") {var cameraManager = await camera.getCameraManager();var cameras = await cameraManager.getCameras();var cameraObj = cameras[0];var cameraId = cameraObj.cameraId;var cameraPosition = cameraObj.cameraPosition;var cameraType = cameraObj.cameraType;var connectionType = cameraObj.connectionType;
}

CameraStatusInfo

相机管理器回调返回的接口实例，表示相机状态信息。

系统能力：  SystemCapability.Multimedia.Camera.Core。

名称类型说明
camera[Camera]相机信息。
status[CameraStatus]相机状态。

CameraInput

相机输入类。在使用该类的方法前，需要先构建一个CameraInput实例。

getCameraId

getCameraId(callback: AsyncCallback<string>): void

异步获取该CameraInput实例的相机ID，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
callbackAsyncCallback<string>是回调函数，用于获取相机ID。

示例：

cameraInput.getCameraId((err, cameraId) => {if (err) {console.error('Failed to get the camera ID. ${err.message}');return;}console.log('Callback returned with the camera ID: ' + cameraId);
})

getCameraId

getCameraId(): Promise<string>

异步获取该CameraInput实例的相机ID，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

返回值：

类型说明
Promise<string>使用Promise的方式获取相机ID。

示例：

cameraInput.getCameraId().then((cameraId) => {console.log('Promise returned with the camera ID:' + cameraId);
})

hasFlash

hasFlash(callback: AsyncCallback<boolean>): void

判断设备是否支持闪光灯，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
callbackAsyncCallback<boolean>是回调函数，返回true表示设备支持闪光灯。

示例：

cameraInput.hasFlash((err, status) => {if (err) {console.error('Failed to check whether the device has flash light. ${err.message}');return;}console.log('Callback returned with flash light support status: ' + status);
})

hasFlash

hasFlash(): Promise<boolean>

判断设备是否支持闪光灯，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

返回值：

类型说明
Promise<boolean>使用Promise的方式获取结果，返回true表示设备支持闪光灯。

示例：

cameraInput.hasFlash().then((status) => {console.log('Promise returned with the flash light support status:' + status);
})

isFlashModeSupported

isFlashModeSupported(flashMode: FlashMode, callback: AsyncCallback<boolean>): void

判断设备是否支持指定闪光灯模式，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
flashMode[FlashMode]是指定闪光灯模式。
callbackAsyncCallback<boolean>是回调函数，返回true表示支持该闪光灯模式。

示例：

cameraInput.isFlashModeSupported(camera.FlashMode.FLASH_MODE_AUTO, (err, status) => {if (err) {console.error('Failed to check whether the flash mode is supported. ${err.message}');return;}console.log('Callback returned with the flash mode support status: ' + status);
})

isFlashModeSupported

isFlashModeSupported(flashMode: FlashMode): Promise<boolean>

判断设备是否支持指定闪光灯模式，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
flashMode[FlashMode]是指定闪光灯模式。

返回值：

类型说明
Promise<boolean>使用Promise的方式获取结果，返回true表示设备支持该闪光灯模式。

示例：

cameraInput.isFlashModeSupported(camera.FlashMode.FLASH_MODE_AUTO).then((status) => {console.log('Promise returned with flash mode support status.' + status);
})

setFlashMode

setFlashMode(flashMode: FlashMode, callback: AsyncCallback<void>): void

设置闪光灯模式，通过注册回调函数获取结果。

进行设置之前，需要先检查：

  1. 设备是否支持闪光灯，可使用方法[hasFlash]。
  2. 设备是否支持指定的闪光灯模式，可使用方法[isFlashModeSupported]。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
flashMode[FlashMode]是指定闪光灯模式。
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

cameraInput.setFlashMode(camera.FlashMode.FLASH_MODE_AUTO, (err) => {if (err) {console.error('Failed to set the flash mode  ${err.message}');return;}console.log('Callback returned with the successful execution of setFlashMode.');
})

setFlashMode

setFlashMode(flashMode: FlashMode): Promise<void>

设置闪光灯模式，通过Promise获取结果。

进行设置之前，需要先检查：

  1. 设备是否支持闪光灯，可使用方法[hasFlash]。
  2. 设备是否支持指定的闪光灯模式。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
flashMode[FlashMode]是指定闪光灯模式。

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

cameraInput.setFlashMode(camera.FlashMode.FLASH_MODE_AUTO).then(() => {console.log('Promise returned with the successful execution of setFlashMode.');
})

getFlashMode

getFlashMode(callback: AsyncCallback<FlashMode>): void

获取当前设备的闪光灯模式，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
callbackAsyncCallback<[FlashMode]>是回调函数，用于获取当前设备的闪光灯模式。

示例：

cameraInput.getFlashMode((err, flashMode) => {if (err) {console.error('Failed to get the flash mode  ${err.message}');return;}console.log('Callback returned with current flash mode: ' + flashMode);
})

getFlashMode

getFlashMode(): Promise<FlashMode>

获取当前设备的闪光灯模式，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

返回值：

类型说明
Promise<[FlashMode]>使用Promise的方式获取当前的闪光灯模式。

示例：

cameraInput.getFlashMode().then((flashMode) => {console.log('Promise returned with current flash mode : ' + flashMode);
})

isFocusModeSupported

isFocusModeSupported(afMode: FocusMode, callback: AsyncCallback<boolean>): void

判断设备是否支持指定的焦距模式，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
afMode[FocusMode]是指定的焦距模式。
callbackAsyncCallback<boolean>是回调函数，返回true表示支持该焦距模式。

示例：

cameraInput.isFocusModeSupported(camera.FocusMode.FOCUS_MODE_AUTO, (err, status) => {if (err) {console.error('Failed to check whether the focus mode is supported. ${err.message}');return;}console.log('Callback returned with the focus mode support status: ' + status);
})

isFocusModeSupported

isFocusModeSupported(afMode: FocusMode): Promise<boolean>

判断设备是否支持指定的焦距模式，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
afMode[FocusMode]是指定的焦距模式。

返回值：

类型说明
Promise<boolean>使用Promise的方式获取结果，返回true表示设备支持该焦距模式。

示例：

cameraInput.isFocusModeSupported(camera.FocusMode.FOCUS_MODE_AUTO).then((status) => {console.log('Promise returned with focus mode support status.' + status);
})

setFocusMode

setFocusMode(afMode: FocusMode, callback: AsyncCallback<void>): void

设置焦距模式，通过注册回调函数获取结果。

进行设置之前，需要先检查设备是否支持指定的焦距模式。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
afMode[FocusMode]是指定的焦距模式。
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

cameraInput.setFocusMode(camera.FocusMode.FOCUS_MODE_AUTO, (err) => {if (err) {console.error('Failed to set the focus mode  ${err.message}');return;}console.log('Callback returned with the successful execution of setFocusMode.');
})

setFocusMode

setFocusMode(afMode: FocusMode): Promise<void>

设置焦距模式，通过Promise获取结果。

进行设置之前，需要先检查设备是否支持指定的焦距模式，可使用方法[isFocusModeSupported]。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
afMode[FocusMode]是指定的焦距模式。

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

cameraInput.setFocusMode(camera.FocusMode.FOCUS_MODE_AUTO).then(() => {console.log('Promise returned with the successful execution of setFocusMode.');
})

getFocusMode

getFocusMode(callback: AsyncCallback<FocusMode>): void

获取当前设备的焦距模式，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
callbackAsyncCallback<[FocusMode]>是回调函数，用于获取当前设备的焦距模式。

示例：

cameraInput.getFocusMode((err, afMode) => {if (err) {console.error('Failed to get the focus mode  ${err.message}');return;}console.log('Callback returned with current focus mode: ' + afMode);
})

getFocusMode

getFocusMode(): Promise<FocusMode>

获取当前设备的焦距模式，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

返回值：

类型说明
Promise<FocusMode>使用Promise的方式获取当前的焦距模式。

示例：

cameraInput.getFocusMode().then((afMode) => {console.log('Promise returned with current focus mode : ' + afMode);
})

getZoomRatioRange

getZoomRatioRange(callback: AsyncCallback<Array<number>>): void

获取可变焦距比范围，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
callbackAsyncCallback<Array<number>>是回调函数，用于获取结果。

示例：

cameraInput.getZoomRatioRange((err, zoomRatioRange) => {if (err) {console.error('Failed to get the zoom ratio range. ${err.message}');return;}console.log('Callback returned with zoom ratio range: ' + zoomRatioRange.length);
})

getZoomRatioRange

getZoomRatioRange(): Promise<Array<number>>

获取可变焦距比范围，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

返回值：

类型说明
Promise<Array<number>>使用Promise的方式获取当前的可变焦距比范围。

示例：

cameraInput.getZoomRatioRange().then((zoomRatioRange) => {console.log('Promise returned with zoom ratio range: ' + zoomRatioRange.length);
})

setZoomRatio

setZoomRatio(zoomRatio: number, callback: AsyncCallback<void>): void

设置可变焦距比，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
zoomRationumber是可变焦距比。
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

cameraInput.setZoomRatio(1, (err) => {if (err) {console.error('Failed to set the zoom ratio value ${err.message}');return;}console.log('Callback returned with the successful execution of setZoomRatio.');
})

setZoomRatio

setZoomRatio(zoomRatio: number): Promise<void>

设置可变焦距比，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
zoomRationumber是可变焦距比。

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

cameraInput.setZoomRatio(1).then(() => {console.log('Promise returned with the successful execution of setZoomRatio.');
})

getZoomRatio

getZoomRatio(callback: AsyncCallback<number>): void

获取当前的可变焦距比，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
callbackAsyncCallback<number>是回调函数，用于获取结果。

示例：

cameraInput.getZoomRatio((err, zoomRatio) => {if (err) {console.error('Failed to get the zoom ratio ${err.message}');return;}console.log('Callback returned with current zoom ratio: ' + zoomRatio);
})

getZoomRatio

getZoomRatio(): Promise<number>

获取当前的可变焦距比，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

返回值：

类型说明
Promise<number>使用Promise的方式获取结果。

示例：

cameraInput.getZoomRatio().then((zoomRatio) => {console.log('Promise returned with current zoom ratio : ' + zoomRatio);
})

release

release(callback: AsyncCallback<void>): void

释放相机实例，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

cameraInput.release((err) => {if (err) {console.error('Failed to release the CameraInput instance ${err.message}');return;}console.log('Callback invoked to indicate that the CameraInput instance is released successfully.');
});

release

release(): Promise<void>

释放相机实例，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

cameraInput.release().then(() => {console.log('Promise returned to indicate that the CameraInput instance is released successfully.');
})

on('focusStateChange')

on(type: 'focusStateChange', callback: AsyncCallback<FocusState>): void

监听焦距的状态变化，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
typestring是监听事件，固定为'focusStateChange'，即焦距状态变化事件。
callbackAsyncCallback<[FocusState]>是回调函数，用于获取焦距状态。

示例：

cameraInput.on('focusStateChange', (focusState) => {console.log('Focus state  : ' + focusState);
})

on('error')

on(type: 'error', callback: ErrorCallback<CameraInputError>): void

监听CameraInput的错误事件，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
typestring是监听事件，固定为'error'，即CameraInput错误事件。
callbackErrorCallback<[CameraInputError]>是回调函数，用于获取结果。

示例：

cameraInput.on('error', (cameraInputError) => {console.log('Camera input error code: ' + cameraInputError.code);
})

CameraInputErrorCode

枚举，CameraInput的错误码。

系统能力：  SystemCapability.Multimedia.Camera.Core

名称值说明
ERROR_UNKNOWN-1未知错误。

CameraInputError

CameraInput错误对象。

系统能力：  SystemCapability.Multimedia.Camera.Core

名称类型说明
code[CameraInputErrorCode]CameraInput中的错误码。

FlashMode

枚举，闪光灯模式。

系统能力：  SystemCapability.Multimedia.Camera.Core。

名称值说明
FLASH_MODE_CLOSE0闪光灯关闭。
FLASH_MODE_OPEN1闪光灯开启。
FLASH_MODE_AUTO2自动闪光灯。
FLASH_MODE_ALWAYS_OPEN3闪光灯常亮。

FocusMode

枚举，焦距模式。

系统能力：  SystemCapability.Multimedia.Camera.Core。

名称值说明
FOCUS_MODE_MANUAL0手动变焦模式。
FOCUS_MODE_CONTINUOUS_AUTO1连续自动变焦模式。
FOCUS_MODE_AUTO2自动变焦模式。
FOCUS_MODE_LOCKED3定焦模式。

FocusState

枚举，焦距状态。

系统能力：  SystemCapability.Multimedia.Camera.Core。

名称值说明
FOCUS_STATE_SCAN0扫描状态。
FOCUS_STATE_FOCUSED1相机已对焦。
FOCUS_STATE_UNFOCUSED2相机未对焦。

camera.createCaptureSession

createCaptureSession(context: Context, callback: AsyncCallback<CaptureSession>): void

获取CaptureSession实例，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
contextContext是应用上下文。
callbackAsyncCallback<[CaptureSession]>是回调函数，用于获取CaptureSession实例。

示例：

camera.createCaptureSession((context), (err, captureSession) => {if (err) {console.error('Failed to create the CaptureSession instance. ${err.message}');return;}console.log('Callback returned with the CaptureSession instance.' + captureSession);
});

camera.createCaptureSession

createCaptureSession(context: Context): Promise<CaptureSession>;

获取CaptureSession实例，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
contextContext是应用上下文。

返回值：

类型说明
Promise<[CaptureSession]>使用Promise的方式获取CaptureSession实例。

示例：

camera.createCaptureSession(context).then((captureSession) => {console.log('Promise returned with the CaptureSession instance');
})

CaptureSession

拍照会话类。

beginConfig

beginConfig(callback: AsyncCallback<void>): void

开始配置会话，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

captureSession.beginConfig((err) => {if (err) {console.error('Failed to start the configuration. ${err.message}');return;}console.log('Callback invoked to indicate the begin config success.');
});

beginConfig

beginConfig(): Promise<void>

开始配置会话，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

captureSession.beginConfig().then(() => {console.log('Promise returned to indicate the begin config success.');
})

commitConfig

commitConfig(callback: AsyncCallback<void>): void

提交会话配置，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

captureSession.commitConfig((err) => {if (err) {console.error('Failed to commit the configuration. ${err.message}');return;}console.log('Callback invoked to indicate the commit config success.');
});

commitConfig

commitConfig(): Promise<void>

提交会话配置，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

captureSession.commitConfig().then(() => {console.log('Promise returned to indicate the commit config success.');
})

addInput

addInput(cameraInput: CameraInput, callback: AsyncCallback<void>): void

在当前会话中，添加一个CameraInput实例，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
cameraInput[CameraInput]是需要添加的CameraInput实例。
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

captureSession.addInput(cameraInput, (err) => {if (err) {console.error('Failed to add the CameraInput instance. ${err.message}');return;}console.log('Callback invoked to indicate that the CameraInput instance is added.');
});

addInput

addInput(cameraInput: CameraInput): Promise<void>

在当前会话中，添加一个CameraInput实例，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
cameraInput[CameraInput]是需要添加的CameraInput实例。

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

captureSession.addInput(cameraInput).then(() => {console.log('Promise used to indicate that the CameraInput instance is added.');
})

addOutput

addOutput(previewOutput: PreviewOutput, callback: AsyncCallback<void>): void

在当前会话中，添加一个PreviewOutput实例，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
previewOutput[PreviewOutput]是需要添加的PreviewOutput实例。
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

captureSession.addOutput(previewOutput, (err) => {if (err) {console.error('Failed to add the PreviewOutput instance ${err.message}');return;}console.log('Callback invoked to indicate that the PreviewOutput instance is added.');
});

addOutput

addOutput(previewOutput: PreviewOutput): Promise<void>

在当前会话中，添加一个PreviewOutput实例，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
previewOutput[PreviewOutput]是需要添加的PreviewOutput实例。

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

captureSession.addOutput(previewOutput).then(() => {console.log('Promise used to indicate that the PreviewOutput instance is added.');
})

addOutput

addOutput(photoOutput: PhotoOutput, callback: AsyncCallback<void>): void

在当前会话中，添加一个PhotoOutput实例，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
photoOutput[PhotoOutput]是需要添加的PhotoOutput实例。
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

captureSession.addOutput(photoOutput, (err) => {if (err) {console.error('Failed to add the PhotoOutput instance ${err.message}');return;}console.log('Callback invoked to indicate that the PhotoOutput instance is added.');
});

addOutput

addOutput(photoOutput: PhotoOutput): Promise<void>

在当前会话中，添加一个PhotoOutput实例，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
photoOutput[PhotoOutput]是需要添加的PhotoOutput实例。

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

captureSession.addOutput(photoOutput).then(() => {console.log('Promise used to indicate that the PhotoOutput instance is added.');
})

addOutput

addOutput(videoOutput: VideoOutput, callback: AsyncCallback<void>): void

在当前会话中，添加一个VideoOutput实例，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
videoOutput[VideoOutput]是需要添加的VideoOutput实例。
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

captureSession.addOutput(videoOutput, (err) => {if (err) {console.error('Failed to add the VideoOutput instance ${err.message}');return;}console.log('Callback invoked to indicate that the VideoOutput instance is added.');
});

addOutput

addOutput(videoOutput: VideoOutput): Promise<void>

在当前会话中，添加一个VideoOutput实例，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
videoOutput[VideoOutput]是需要添加的VideoOutput实例。

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

captureSession.addOutput(videoOutput).then(() => {console.log('Promise used to indicate that the VideoOutput instance is added.');
})

removeInput

removeInput(cameraInput: CameraInput, callback: AsyncCallback<void>): void

在当前会话中，移除一个CameraInput实例，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
cameraInput[CameraInput]是需要移除的CameraInput实例。
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

captureSession.removeInput(cameraInput, (err) => {if (err) {console.error('Failed to remove the CameraInput instance. ${err.message}');return;}console.log('Callback invoked to indicate that the cameraInput instance is removed.');
});

removeInput

removeInput(cameraInput: CameraInput): Promise<void>

在当前会话中，移除一个CameraInput实例，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
cameraInput[CameraInput]是需要移除的CameraInput实例。

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

captureSession.removeInput(cameraInput).then(() => {console.log('Promise returned to indicate that the cameraInput instance is removed.');
})

removeOutput

removeOutput(previewOutput: PreviewOutput, callback: AsyncCallback<void>): void

在当前会话中，移除一个PreviewOutput实例，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
previewOutput[PreviewOutput]是需要移除的PreviewOutput实例。
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

captureSession.removeOutput(previewOutput, (err) => {if (err) {console.error('Failed to remove the PreviewOutput instance. ${err.message}');return;}console.log('Callback invoked to indicate that the PreviewOutput instance is removed.');
});

removeOutput

removeOutput(previewOutput: PreviewOutput): Promise<void>

在当前会话中，移除一个PreviewOutput实例，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
previewOutput[PreviewOutput]是需要移除的PreviewOutput实例。

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

captureSession.removeOutput(previewOutput).then(() => {console.log('Promise returned to indicate that the PreviewOutput instance is removed.');
})

removeOutput

removeOutput(photoOutput: PhotoOutput, callback: AsyncCallback<void>): void

在当前会话中，移除一个PhotoOutput实例，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
photoOutput[PhotoOutput]是需要移除的PhotoOutput实例。
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

captureSession.removeOutput(photoOutput, (err) => {if (err) {console.error('Failed to remove the PhotoOutput instance. ${err.message}');return;}console.log('Callback invoked to indicate that the PhotoOutput instance is removed.');
});

removeOutput

removeOutput(photoOutput: PhotoOutput): Promise<void>

在当前会话中，移除一个PhotoOutput实例，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
photoOutput[PhotoOutput]是需要移除的PhotoOutput实例。

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

captureSession.removeOutput(photoOutput).then(() => {console.log('Promise returned to indicate that the PhotoOutput instance is removed.');
})

removeOutput

removeOutput(videoOutput: VideoOutput, callback: AsyncCallback<void>): void

在当前会话中，移除一个VideoOutput实例，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
videoOutput[VideoOutput]是需要移除的VideoOutput实例。
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

captureSession.removeOutput(videoOutput, (err) => {if (err) {console.error('Failed to remove the VideoOutput instance. ${err.message}');return;}console.log('Callback invoked to indicate that the VideoOutput instance is removed.');
});

removeOutput

removeOutput(videoOutput: VideoOutput): Promise<void>

在当前会话中，移除一个VideoOutput实例，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
videoOutput[VideoOutput]是需要移除的VideoOutput实例。

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

captureSession.removeOutput(videoOutput).then(() => {console.log('Promise returned to indicate that the VideoOutput instance is removed.');
})

start

start(callback: AsyncCallback<void>): void

启动拍照会话，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

captureSession.start((err) => {if (err) {console.error('Failed to start the session ${err.message}');return;}console.log('Callback invoked to indicate the session start success.');
});

start

start(): Promise<void>

启动拍照会话，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

captureSession.start().then(() => {console.log('Promise returned to indicate the session start success.');
})

stop

stop(callback: AsyncCallback<void>): void

停止拍照会话，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

captureSession.stop((err) => {if (err) {console.error('Failed to stop the session ${err.message}');return;}console.log('Callback invoked to indicate the session stop success.');
});

stop

stop(): Promise<void>

停止拍照会话，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

captureSession.stop().then(() => {console.log('Promise returned to indicate the session stop success.');
})

release

release(callback: AsyncCallback<void>): void

释放CaptureSession实例，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

captureSession.release((err) => {if (err) {console.error('Failed to release the CaptureSession instance ${err.message}');return;}console.log('Callback invoked to indicate that the CaptureSession instance is released successfully.');
});

release

release(): Promise<void>

释放CaptureSession实例，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

captureSession.release().then(() => {console.log('Promise returned to indicate that the CaptureSession instance is released successfully.');
})

on('error')

on(type: 'error', callback: ErrorCallback<CaptureSessionError>): void

监听拍照会话的错误事件，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
typestring是监听事件，固定为'error'，即拍照会话错误事件。
callbackErrorCallback<[CaptureSessionError]>是回调函数，用于获取错误信息。

示例：

captureSession.on('error', (captureSessionError) => {console.log('Capture session error code: ' + captureSessionError.code);
})

CaptureSessionErrorCode

枚举，拍照会话的错误码。

系统能力：  SystemCapability.Multimedia.Camera.Core

名称值说明
ERROR_UNKNOWN-1未知错误。

CaptureSessionError

拍照会话错误对象。

系统能力：  SystemCapability.Multimedia.Camera.Core

名称类型说明
code[CaptureSessionError]CaptureSession中的错误码。

camera.createPreviewOutput

createPreviewOutput(surfaceId: string, callback: AsyncCallback<PreviewOutput>): void

获取PreviewOutput实例，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
surfaceIdstring是从XComponent组件获取的Surface ID。
callbackAsyncCallback<[PreviewOutput]>是回调函数，用于获取PreviewOutput实例。

示例：

camera.createPreviewOutput(("surfaceId"), (err, previewOutput) => {if (err) {console.error('Failed to create the PreviewOutput instance. ${err.message}');return;}console.log('Callback returned with previewOutput instance');
});

camera.createPreviewOutput

createPreviewOutput(surfaceId: string): Promise<PreviewOutput>

获取PreviewOutput实例，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
surfaceIdstring是从XComponent组件获取的Surface ID。

返回值：

类型说明
Promise<[PreviewOutput]>使用Promise的方式获取结果。

示例：

camera.createPreviewOutput("surfaceId").then((previewOutput) => {console.log('Promise returned with the PreviewOutput instance');
})

PreviewOutput

预览输出类。

release

release(callback: AsyncCallback<void>): void

释放PreviewOutput实例，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

previewOutput.release((err) => {if (err) {console.error('Failed to release the PreviewOutput instance ${err.message}');return;}console.log('Callback invoked to indicate that the PreviewOutput instance is released successfully.');
});

release

release(): Promise<void>

释放PreviewOutput实例，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

previewOutput.release().then(() => {console.log('Promise returned to indicate that the PreviewOutput instance is released successfully.');
})

on('frameStart')

on(type: 'frameStart', callback: AsyncCallback<void>): void

监听预览帧启动，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
typestring是监听事件，固定为'frameStart'，即帧启动事件。
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

previewOutput.on('frameStart', () => {console.log('Preview frame started');
})

on('frameEnd')

on(type: 'frameEnd', callback: AsyncCallback<void>): void

监听预览帧结束，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
typestring是监听事件，固定为'frameEnd'，即帧结束事件。
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

previewOutput.on('frameEnd', () => {console.log('Preview frame ended');
})

on('error')

on(type: 'error', callback: ErrorCallback<PreviewOutputError>): void

监听预览输出的错误事件，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
typestring是监听事件，固定为'error'，即预览输出错误事件。
callbackErrorCallback<[PreviewOutputErrorCode]>是回调函数，用于获取错误信息。

示例：

previewOutput.on('error', (previewOutputError) => {console.log('Preview output error code: ' + previewOutputError.code);
})

PreviewOutputErrorCode

枚举，预览输出的错误码。

系统能力：  SystemCapability.Multimedia.Camera.Core

名称值说明
ERROR_UNKNOWN-1未知错误。

PreviewOutputError

预览输出错误对象。

系统能力：  SystemCapability.Multimedia.Camera.Core

名称类型说明
code[PreviewOutputErrorCode]PreviewOutput中的错误码。

camera.createPhotoOutput

createPhotoOutput(surfaceId: string, callback: AsyncCallback<PhotoOutput>): void

获取PhotoOutput实例，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
surfaceIdstring是从[ImageReceiver]获取的Surface ID。
callbackAsyncCallback<[PhotoOutput]>是回调函数，用于获取PhotoOutput实例。

示例：

camera.createPhotoOutput(("surfaceId"), (err, photoOutput) => {if (err) {console.error('Failed to create the PhotoOutput instance. ${err.message}');return;}console.log('Callback returned with the PhotoOutput instance.');
});

camera.createPhotoOutput

createPhotoOutput(surfaceId: string): Promise<PhotoOutput>

获取PhotoOutput实例，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
surfaceIdstring是从[ImageReceiver]获取的Surface ID。

返回值：

类型说明
Promise<[PhotoOutput]>使用Promise的方式获取PhotoOutput实例。

示例：

camera.createPhotoOutput("surfaceId").then((photoOutput) => {console.log('Promise returned with PhotoOutput instance');
})

ImageRotation

枚举，图片旋转角度。

系统能力：  SystemCapability.Multimedia.Camera.Core

名称值说明
ROTATION_00图片旋转0度。
ROTATION_9090图片旋转90度。
ROTATION_180180图片旋转180度。
ROTATION_270270图片旋转270度。

QualityLevel

枚举，图片质量。

系统能力：  SystemCapability.Multimedia.Camera.Core

名称值说明
QUALITY_LEVEL_HIGH0图片质量高。
QUALITY_LEVEL_MEDIUM1图片质量中等。
QUALITY_LEVEL_LOW2图片质量差。

PhotoCaptureSetting

拍摄照片的设置。

系统能力：  SystemCapability.Multimedia.Camera.Core

名称类型必填说明
quality[QualityLevel]否图片质量。
rotation[ImageRotation]否图片旋转角度。

PhotoOutput

照片输出类。

capture

capture(callback: AsyncCallback<void>): void

拍照，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

photoOutput.capture((err) => {if (err) {console.error('Failed to capture the photo ${err.message}');return;}console.log('Callback invoked to indicate the photo capture request success.');
});

capture

capture(setting: PhotoCaptureSetting, callback: AsyncCallback<void>): void

根据拍照设置拍照，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
setting[PhotoCaptureSetting]是拍照设置。
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

photoOutput.capture(settings, (err) => {if (err) {console.error('Failed to capture the photo ${err.message}');return;}console.log('Callback invoked to indicate the photo capture request success.');
});

capture

capture(setting?: PhotoCaptureSetting): Promise<void>

根据拍照设置拍照，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
setting[PhotoCaptureSetting]否拍照设置。

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

photoOutput.capture().then(() => {console.log('Promise returned to indicate that photo capture request success.');
})

release

release(callback: AsyncCallback<void>): void

释放PhotoOutput实例，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

photoOutput.release((err) => {if (err) {console.error('Failed to release the PhotoOutput instance ${err.message}');return;}console.log('Callback invoked to indicate that the PhotoOutput instance is released successfully.');
});

release

release(): Promise<void>

释放PhotoOutput实例，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

photoOutput.release().then(() => {console.log('Promise returned to indicate that the PhotoOutput instance is released successfully.');
})

on('captureStart')

on(type: 'captureStart', callback: AsyncCallback<number>): void

监听拍照启动，通过注册回调函数获取Capture ID。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
typestring是监听事件，固定为'captureStart'，即拍照启动事件。
callbackAsyncCallback<number>是使用callback的方式获取Capture ID。

示例：

photoOutput.on('captureStart', (err, captureId) => {console.log('photo capture stated, captureId : ' + captureId);
})

on('frameShutter')

on(type: 'frameShutter', callback: AsyncCallback<FrameShutterInfo>): void

监听快门，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
typestring是监听事件，固定为'frameShutter'，即帧刷新事件。
callbackAsyncCallback<[FrameShutterInfo]>是回调函数，用于获取相关信息。

示例：

photoOutput.on('frameShutter', (frameShutterInfo) => {console.log('photo capture end, captureId : ' + frameShutterInfo.captureId);console.log('Timestamp for frame : ' + frameShutterInfo.timestamp);
})

on('captureEnd')

on(type: 'captureEnd', callback: AsyncCallback<CaptureEndInfo>): void

监听拍照停止，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
typestring是监听事件，固定为'captureEnd'，即拍照停止事件。
callbackAsyncCallback<[CaptureEndInfo]>是回调函数，用于获取相关信息。

示例：

photoOutput.on('captureEnd', (captureEndInfo) => {console.log('photo capture end, captureId : ' + captureEndInfo.captureId);console.log('frameCount : ' + captureEndInfo.frameCount);
})

on('error')

on(type: 'error', callback: ErrorCallback<PhotoOutputError>): void

监听拍照的错误事件，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
typestring是监听事件，固定为'error'，即拍照错误事件。
callbackErrorCallback<[PhotoOutputError]>是回调函数，用于获取错误信息。

示例：

photoOutput.on('error', (photoOutputError) => {console.log('Photo output error code: ' + photoOutputError.code);
})

FrameShutterInfo

快门事件信息。

系统能力：  SystemCapability.Multimedia.Camera.Core

名称类型必填说明
captureIdnumber是CaptureId，本次拍摄动作的ID。
timestampnumber是时间戳。

CaptureEndInfo

拍照停止信息。

系统能力：  SystemCapability.Multimedia.Camera.Core

名称类型必填说明
captureIdnumber是CaptureId，本次拍摄动作的ID。
frameCountnumber是帧计数。

PhotoOutputErrorCode

枚举，拍照输出的错误码。

系统能力：  SystemCapability.Multimedia.Camera.Core

名称值说明
ERROR_UNKNOWN-1未知错误。

PhotoOutputError

拍照输出错误对象。

系统能力：  SystemCapability.Multimedia.Camera.Core

名称类型说明
code[PhotoOutputError]PhotoOutput中的错误码。

camera.createVideoOutput

createVideoOutput(surfaceId: string, callback: AsyncCallback<VideoOutput>): void

获取VideoOutput实例，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
surfaceIdstring是从VideoRecorder获取的Surface ID。
callbackAsyncCallback<[VideoOutput]>是回调函数，用于获取VideoOutput实例。

示例：

camera.createVideoOutput(("surfaceId"), (err, videoOutput) => {if (err) {console.error('Failed to create the VideoOutput instance. ${err.message}');return;}console.log('Callback returned with the VideoOutput instance');
});

camera.createVideoOutput

createVideoOutput(surfaceId: string): Promise<VideoOutput>

获取VideoOutput实例，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
surfaceIdstring是从VideoRecorder获取的Surface ID。

返回值：

类型说明
Promise<[VideoOutput]>使用Promise的方式获取VideoOutput实例。

示例：

camera.createVideoOutput("surfaceId"
).then((videoOutput) => {console.log('Promise returned with the VideoOutput instance');
})

VideoOutput

视频输出类。

start

start(callback: AsyncCallback<void>): void

开始拍摄视频，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

videoOutput.start((err) => {if (err) {console.error('Failed to start the video output ${err.message}');return;}console.log('Callback invoked to indicate the video output start success.');
});

start

start(): Promise<void>

开始拍摄视频，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

videoOutput.start().then(() => {console.log('Promise returned to indicate that start method execution success.');
})

stop

stop(callback: AsyncCallback<void>): void

停止拍摄视频，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

videoOutput.stop((err) => {if (err) {console.error('Failed to stop the video output ${err.message}');return;}console.log('Callback invoked to indicate the video output stop success.');
});

stop

stop(): Promise<void>

停止拍摄视频，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

videoOutput.start().then(() => {console.log('Promise returned to indicate that stop method execution success.');
})

release

release(callback: AsyncCallback<void>): void

释放VideoOutput实例，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

videoOutput.release((err) => {if (err) {console.error('Failed to release the VideoOutput instance ${err.message}');return;}console.log('Callback invoked to indicate that the VideoOutput instance is released successfully.');
});

release

release(): Promise<void>

释放VideoOutput实例，通过Promise获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

返回值：

类型说明
Promise<void>使用Promise的方式获取结果。

示例：

videoOutput.release().then(() => {console.log('Promise returned to indicate that the VideoOutput instance is released successfully.');
})

on('frameStart')

on(type: 'frameStart', callback: AsyncCallback<void>): void

监听视频帧开启，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
typestring是监听事件，固定为'frameStart'，即视频帧开启事件。
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

videoOutput.on('frameStart', () => {console.log('Video frame started');
})

on('frameEnd')

on(type: 'frameEnd', callback: AsyncCallback<void>): void

监听视频帧结束，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
typestring是监听事件，固定为'frameEnd'，即视频帧结束事件。
callbackAsyncCallback<void>是回调函数，用于获取结果。

示例：

videoOutput.on('frameEnd', () => {console.log('Video frame ended');
})

on('error')

on(type: 'error', callback: ErrorCallback<VideoOutputError>): void

监听视频输出的错误事件，通过注册回调函数获取结果。

系统能力：  SystemCapability.Multimedia.Camera.Core

参数：

名称类型必填说明
typestring是监听事件，固定为'error'，即视频输出错误事件。
callbackCallback<[VideoOutputError]>是回调函数，用于获取错误信息。

示例：

videoOutput.on('error', (VideoOutputError) => {console.log('Video output error code: ' + VideoOutputError.code);
})

VideoOutputErrorCode

枚举，视频输出的错误码。

系统能力：  SystemCapability.Multimedia.Camera.Core

名称 HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿值说明
ERROR_UNKNOWN-1未知错误。

搜狗高速浏览器截图20240326151450.png

VideoOutputError

视频输出错误对象。

系统能力：  SystemCapability.Multimedia.Camera.Core

名称类型说明
code[PhotoOutputError]VideoOutput中的错误码。

2024年，已有许多程序员把未来投向了鸿蒙开发，想必也在网上寻找过【鸿蒙学习资料】，然而搜索到的资料都是七零八碎比较杂乱，对于新入门的人来说增加了时间成本；为了避免大家在学习过程中浪费过多时间。对此录制了一套鸿蒙基础进阶视频（HarmonyOS NEXT）开发入门&实战教学视频（200集+）发放给大家。↓↓↓点击即可

《鸿蒙 (HarmonyOS NEXT)开发入门&实战教学视频》

《鸿蒙ArkTS语言》

《鸿蒙ArkUI声明式》

《鸿蒙开发环境搭建》

另外还根据鸿蒙官方发布的文档结合华为内部人员分享，经过反复修改整理得出的一整套鸿蒙（HarmonyOS NEXT）学习手册（共计2000页+）想要鸿蒙进阶文档的开发者有福了！

内容包含了：（ArkTS、ArkUI、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、鸿蒙南向开发、鸿蒙项目实战）等技术知识点。帮助大家在学习鸿蒙路上少走弯路！点击即可↓↓↓

《鸿蒙 (HarmonyOS NEXT)开发基础与实战手册》

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/diannao/19962.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

低边驱动与高边驱动

低边驱动与高边驱动

一.高边驱动和低边驱动 低边驱动(LSD): 在电路的接地端加了一个可控开关&#xff0c;低边驱动就是通过闭合地线来控制这个开关的开关。容易实现&#xff08;电路也比较简单&#xff0c;一般由MOS管加几个电阻、电容&#xff09;、适用电路简化和成本控制的情况。 高边驱动&am…
阅读更多...
Qt 窗口

Qt 窗口

在Qt Creator 中创建项目的时候&#xff0c;我们能够选择创建QMainWindow 还是 QWidget 两种窗口。 二者有什么区别呢&#xff1f;其中 QMainWindow 是一种主窗口&#xff0c;包含菜单栏&#xff0c;工具栏&#xff0c;状态栏&#xff0c;中心窗口和浮动窗口等多个窗口组合&…
阅读更多...
位置参数

位置参数

自学python如何成为大佬(目录):https://blog.csdn.net/weixin_67859959/article/details/139049996?spm1001.2014.3001.5501 位置参数也称必备参数&#xff0c;是必须按照正确的顺序传到函数中&#xff0c;即调用时的数量和位置必须和定义时是一样的。 &#xff08;1&#x…
阅读更多...
stack和queue(1)

stack和queue(1)

一、stack的简单介绍和使用 1.1 stack的介绍 1.stack是一种容器适配器&#xff0c;专门用在具有先进后出&#xff0c;后进先出操作的上下文环境中&#xff0c;其删除只能从容器的一端进行元素的插入和弹出操作。 2.stack是作为容器适配器被实现的&#xff0c;容器适配器即是…
阅读更多...
信号与槽函数的魔法：QT 5编程中的核心机制

信号与槽函数的魔法：QT 5编程中的核心机制

新书上架~&#x1f447;全国包邮奥~ python实用小工具开发教程http://pythontoolsteach.com/3 欢迎关注我&#x1f446;&#xff0c;收藏下次不迷路┗|&#xff40;O′|┛ 嗷~~ 目录 一、信号与槽函数的基本概念 二、信号与槽函数的实现原理 三、信号与槽函数的代码实例 四…
阅读更多...
搭载算能 BM1684 芯片，面向AI推理计算加速卡

搭载算能 BM1684 芯片，面向AI推理计算加速卡

搭载算能 BM1684 芯片&#xff0c;是面向AI推理的算力卡。可集成于服务器、工控机中&#xff0c;高效适配市场上所有AI算法&#xff0c;实现视频结构化、人脸识别、行为分析、状态监测等应用&#xff0c;为智慧城市、智慧交通、智慧能源、智慧金融、智慧电信、智慧工业等领域进…
阅读更多...
实用软件分享---- i茅台 在windows上自动预约和自动获取小茅运的软件

实用软件分享---- i茅台 在windows上自动预约和自动获取小茅运的软件

专栏介绍：本专栏主要分享一些实用的软件（Po Jie版）； 声明1：软件不保证时效性；只能保证在写本文时，该软件是可用的；不保证后续时间该软件能一直正常运行；不保证没有bug；如果软件不可用了，我知道后会第一时间在题目上注明（已失效）。介意者请勿订阅。 声明2：本专栏的…
阅读更多...
计算机基础学习路线

计算机基础学习路线

计算机基础学习路线 整理自学计算机基础的过程&#xff0c;虽学习内容众多&#xff0c;然始终相信世上无难事&#xff0c;只怕有心人&#xff0c;期间也遇到许多志同道合的同学&#xff0c;现在也分享自己的学习过程来帮助有需要的。 一、数据结构与算法 视频方面我看的是青…
阅读更多...
C++_list简单源码剖析：list模拟实现

C++_list简单源码剖析：list模拟实现

文章目录 &#x1f680;1. ListNode模板&#x1f680;2. List_iterator模板(重要)&#x1f331;2.1 List_iterator的构造函数&#x1f331;2.2 List_iterator的关于ListNode的行为 &#x1f680;3. Reverse_list_iterator模板(拓展)&#x1f680;4. List模板(核心)&#x1f331…
阅读更多...
【计算机毕设】基于SpringBoot的房产销售系统设计与实现 - 源码免费（私信领取）

【计算机毕设】基于SpringBoot的房产销售系统设计与实现 - 源码免费（私信领取）

免费领取源码 &#xff5c; 项目完整可运行 &#xff5c; v&#xff1a;chengn7890 诚招源码校园代理&#xff01; 1. 研究目的 随着房地产市场的发展和互联网技术的进步&#xff0c;传统的房产销售模式逐渐向线上转移。设计并实现一个基于Spring Boot的房产销售系统&#xff0…
阅读更多...
SpringCloud学习笔记（一）

SpringCloud学习笔记（一）

SpringCloud、SpringCloud Alibaba 前置知识&#xff1a; 核心新组件&#xff1a; 所用版本&#xff1a; 学习方法&#xff1a; 1.看理论&#xff1a;官网 2.看源码&#xff1a;github 一、微服务理论知识 二、关于SpringCloud各种组件的停更/升级/替换 主业务逻辑是&#x…
阅读更多...
尝试用智谱机器人+知识库,制作pytorch测试用例生成器

尝试用智谱机器人+知识库,制作pytorch测试用例生成器

尝试用智谱机器人知识库,制作pytorch测试用例生成器 1 保存pytorch算子文档到txt2 创建知识库3 创建聊天机器人4 测试效果5 分享 背景:是否能将API的接口文档和sample放到RAG知识库,让LLM编写API相关的程序呢 小结:当前的实验效果并不理想,可以生成代码,但几乎都存在BUG 1 保存…
阅读更多...
星闪在智能汽车端的应用

星闪在智能汽车端的应用

随着智能汽车、智能终端、智能家居和智能制造等多产业的快速发展&#xff0c;多应用领域对无线短距通信技术在低延时、高可靠、低功耗等方面提出共性要求&#xff0c;现有主流无线短距通信技术的先天局限和技术潜力无法满足新应用的技术要求&#xff0c;针对解决行业技术痛点的…
阅读更多...
StrApi基本使用

StrApi基本使用

1.创建项目(这里只使用默认的sqllite) 点击链接进入官网查看先决条件,看看自己的node,python等是否符合版本要求 运行以下命令进行创建项目(网慢导致下载失败的话可以尝试使用手机热点给电脑使用,我就是这样解决的,也可以看我csdn的资源这里进行下载) yarn create strapi-ap…
阅读更多...
5.25.1 用于组织病理学图像分类的深度注意力特征学习

5.25.1 用于组织病理学图像分类的深度注意力特征学习

提出了一种基于深度学习的组织病理学图像分类新方法。我们的方法建立在标准卷积神经网络 (CNN) 的基础上，并结合了两个独立的注意力模块，以实现更有效的特征学习。 具体而言，注意力模块沿不同维度推断注意力图，这有助于将 CNN 聚焦于关键图像区域，并突出显示判别性特征通…
阅读更多...
基于Python的校园预约打印网站的实现

基于Python的校园预约打印网站的实现

基于Python的校园预约打印网站的实现 开发语言:Python 数据库&#xff1a;MySQL所用到的知识&#xff1a;Django框架工具&#xff1a;pycharm、Navicat、Maven 系统功能实现 注册 新用户首先要进行注册信息填写&#xff0c;填写完成以后进行登录即可使用此网站 打印社 分别有…
阅读更多...
同元软控受邀出席2024工业软件创新发展学术会议

同元软控受邀出席2024工业软件创新发展学术会议

5月24日至26日&#xff0c;以“工业软件与新质生产力”为主题的2024工业软件创新发展学术会议在武汉顺利召开。会议由《软件导刊》编辑部主办&#xff0c;复杂关键软件环境全国重点实验室、武汉人工智能研究院、武汉轻工大学电气与电子工程学院承办&#xff0c;百度公司等单位协…
阅读更多...
RandLA-Net 训练自定义数据集

RandLA-Net 训练自定义数据集

https://arxiv.org/abs/1911.11236 搭建训练环境 git clone https://github.com/QingyongHu/RandLA-Net.git搭建 python 环境 , 这里我用的 3.9conda create -n randlanet python3.9 source activate randlanet pip install tensorflow2.15.0 -i https://pypi.tuna.tsinghua.e…
阅读更多...
数据结构与算法 ：数据结构绪论，时间和空间复杂度 推导大O阶

数据结构与算法 ：数据结构绪论，时间和空间复杂度 推导大O阶

各位少年 大家好 我是博主那一脸阳光&#xff0c;今天开始给大家分享数据结构&#xff0c;由于我个人当初学的时候是自学&#xff0c;并没有看培训机构的视频 所以接下来我分享的数据结构的内容&#xff0c;源头来自一本书叫做大话数据结构。顺便一提为了方面大家理解&#xff…
阅读更多...
unicloud 云对象

unicloud 云对象

背景和优势 20年前&#xff0c;restful接口开发开始流行&#xff0c;服务器编写接口&#xff0c;客户端调用接口&#xff0c;传输json。 现在&#xff0c;替代restful的新模式来了。 云对象&#xff0c;服务器编写API&#xff0c;客户端调用API&#xff0c;不再开发传输json…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023