@ohos.multimedia.camera (Camera Management) (System API)

The module provides a set of camera service APIs for you to easily develop a camera application. The application can access and operate the camera hardware to implement basic operations, such as preview, taking photos, and recording videos. It can also perform more operations, for example, controlling the flash and exposure time, and focusing or adjusting the focus.

NOTE

The initial APIs of this module are supported since API version 10. Newly added APIs will be marked with a superscript to indicate their earliest API version.

This topic describes only system APIs provided by the module. For details about its public APIs, see @ohos.multimedia.camera (Camera Management).

Modules to Import

import { camera } from '@kit.CameraKit';

SceneMode¹¹⁺

Enumerates the camera scene modes.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
PORTRAIT_PHOTO	3	Portrait photo mode. System API: This is a system API.
NIGHT_PHOTO	4	Night photo mode. System API: This is a system API.
PROFESSIONAL_PHOTO¹²⁺	5	Professional photo mode. System API: This is a system API.
PROFESSIONAL_VIDEO¹²⁺	6	Professional video mode. System API: This is a system API.
SLOW_MOTION_VIDEO¹²⁺	7	Slow-motion video mode. System API: This is a system API.
MACRO_PHOTO¹²⁺	8	Macro photo mode. System API: This is a system API.
MACRO_VIDEO¹²⁺	9	Macro video mode. System API: This is a system API.
LIGHT_PAINTING_PHOTO¹²⁺	10	Light painting mode. System API: This is a system API.
HIGH_RESOLUTION_PHOTO¹²⁺	11	High-resolution photo mode. System API: This is a system API.
QUICK_SHOT_PHOTO¹²⁺	13	Quick snap mode. System API: This is a system API.
APERTURE_VIDEO¹²⁺	14	Large aperture video mode. System API: This is a system API.
PANORAMA_PHOTO¹²⁺	15	Panoramic photo mode. System API: This is a system API.
TIME_LAPSE_PHOTO¹²⁺	16	Time-lapse photo mode. System API: This is a system API.
FLUORESCENCE_PHOTO¹³⁺	17	Fluorescence photo mode. System API: This is a system API.

SlowMotionStatus¹²⁺

Enumerates the slow-motion states.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
DISABLED	0	Disabled.
READY	1	Ready.
VIDEO_START	2	Video start.
VIDEO_DONE	3	Video complete.
FINISHED	4	Finished.

LcdFlashStatus¹²⁺

Describes the LCD flash information.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Type	Read-only	Optional	Description
isLcdFlashNeeded	boolean	Yes	No	Whether the LCD flash is required. true if required, false otherwise.
lcdCompensation	number	Yes	No	LCD flash compensation.

Photo¹¹⁺

Defines a higher-resolution image object.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Type	Read-only	Optional	Description
raw¹²⁺	image.Image	No	Yes	Raw image.

PolicyType¹²⁺

Enumerates the policy types.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
PRIVACY¹²⁺	1	Privacy.

LightPaintingType¹²⁺

Enumerates the types of light painting shutter modes.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
TRAFFIC_TRAILS	0	Traffic trails.
STAR_TRAILS	1	Star trails.
SILKY_WATER	2	Silky water.
LIGHT_GRAFFITI	3	Light graffiti.

CameraManager

Implements camera management. Before calling any API in CameraManager, you must use getCameraManager to obtain a CameraManager instance.

createDepthDataOutput¹³⁺

createDepthDataOutput(profile: DepthProfile): DepthDataOutput

Creates a DepthDataOutput instance. This API returns the result synchronously.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
profile	DepthProfile	Yes	Supported preview profile, which is obtained through getSupportedOutputCapability.

Return value

Type	Description
DepthDataOutput	DepthDataOutput instance. If the operation fails, an error code defined in CameraErrorCode is returned.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400101	Parameter missing or parameter type incorrect.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function createDepthDataOutput(cameraOutputCapability: camera.CameraOutputCapability, cameraManager: camera.CameraManager): camera.DepthDataOutput | undefined {
  let profile: camera.DepthProfile = cameraOutputCapability.depthProfiles[0];
  let depthDataOutput: camera.DepthDataOutput | undefined = undefined;
  try {
    depthDataOutput = cameraManager.createDepthDataOutput(profile);
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The createDepthDataOutput call failed. error code: ${err.code}`);
  }
  return depthDataOutput;
}

isCameraMuteSupported

isCameraMuteSupported(): boolean

Checks whether the camera device can be muted.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
boolean	Check result for whether the camera device can be muted. true if it can be muted, false otherwise.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.

Example

function isCameraMuteSupported(cameraManager: camera.CameraManager): boolean {
  let isMuteSupported: boolean = cameraManager.isCameraMuteSupported();
  return isMuteSupported;
}

muteCamera^(deprecated)

muteCamera(mute: boolean): void

Mutes or unmutes the camera device.

NOTE This API is supported since API version 10 and deprecated since API version 12. You are advised to use muteCameraPersistent instead.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
mute	boolean	Yes	Whether to mute the camera device. true to mute, false otherwise.

Example

function muteCamera(cameraManager: camera.CameraManager): void {
  let mute: boolean = true;
  cameraManager.muteCamera(mute);
}

muteCameraPersistent¹²⁺

muteCameraPersistent(mute: boolean, type: PolicyType): void

Mutes the camera device permanently.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
mute	boolean	Yes	Whether to mute the camera device. true to mute, false otherwise.
type	PolicyType	Yes	Policy type. For details about the available options, see PolicyType.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
201	Permission denied.
202	Not System Application.
7400101	Parameter missing or parameter type incorrect.

Example

function muteCameraPersistent(cameraManager: camera.CameraManager): void {
  let mute: boolean = true;
  cameraManager.muteCameraPersistent(mute, camera.PolicyType.PRIVACY);
}

on('cameraMute')

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

Subscribes to camera mute status events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'cameraMute', indicating the camera mute status. The event can be listened for when a CameraManager instance is obtained. This event is triggered and the status is returned when the camera device is muted or unmuted.
callback	AsyncCallback<boolean>	Yes	Callback used to return the camera mute status. true if muted, false otherwise.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, curMuted: boolean): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  let isMuted: boolean = curMuted;
  console.info(`cameraMute status: ${isMuted}`);
}

function registerCameraMute(cameraManager: camera.CameraManager): void {
  cameraManager.on('cameraMute', callback);
}

off('cameraMute')

off(type: 'cameraMute', callback?: AsyncCallback<boolean>): void

Unsubscribes from camera mute status events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'cameraMute', indicating the camera mute status. The event can be listened for when a CameraManager instance is obtained.
callback	AsyncCallback<boolean>	No	Callback used to return the camera mute status. true if muted, false otherwise. This parameter is optional. If this parameter is specified, the subscription to the specified event on('cameraMute') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, curMuted: boolean): void {
  let isMuted: boolean = curMuted;
}

function unregisterCameraMute(cameraManager: camera.CameraManager): void {
  cameraManager.off('cameraMute', callback);
}

isPrelaunchSupported

isPrelaunchSupported(camera: CameraDevice): boolean

Checks whether a camera device supports prelaunch.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
camera	CameraDevice	Yes	Camera device.

Return value

Type	Description
boolean	Check result for the support of prelaunch. true if supported, false otherwise.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
7400101	Parameter missing or parameter type incorrect.

Example

import { common } from '@kit.AbilityKit';

function isPreLaunchSupported(context: common.BaseContext): boolean {
  let cameraManager: camera.CameraManager = camera.getCameraManager(context);
  let cameras: Array<camera.CameraDevice> = cameraManager.getSupportedCameras();
  let isSupported: boolean = false;
  if (cameras && cameras.length >= 1) {
    isSupported = cameraManager.isPrelaunchSupported(cameras[0]);
    console.info(`PreLaunch supported states: ${isSupported}`);
    return isSupported;
  }
  return isSupported;
}

setPrelaunchConfig

setPrelaunchConfig(prelaunchConfig: PrelaunchConfig): void

Sets prelaunch configuration.

Before the setting, call isPrelaunchSupported to check whether the camera device supports prelaunch.

System API: This is a system API.

Required permissions: ohos.permission.CAMERA

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
prelaunchConfig	PrelaunchConfig	Yes	Prelaunch configuration.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400101	Parameter missing or parameter type incorrect.
7400102	Operation not allowed.
7400201	Camera service fatal error.

Example

import { common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

function setPrelaunchConfig(context: common.BaseContext): void {
  let cameraManager: camera.CameraManager = camera.getCameraManager(context);
  let cameras: Array<camera.CameraDevice> = cameraManager.getSupportedCameras();
  if (cameras && cameras.length >= 1) {
    let cameraDevice: camera.CameraDevice = cameras[0];
    if(cameraManager.isPrelaunchSupported(cameraDevice)) {
      try {
        cameraManager.setPrelaunchConfig({cameraDevice: cameraDevice});
      } catch (error) {
        let err = error as BusinessError;
        console.error(`setPrelaunchConfig error. Code: ${err.code}, message: ${err.message}`);
      }
    }
  }
}

prelaunch

prelaunch(): void

Prelaunches the camera device. This API is called when a user clicks the system camera icon to start the camera application.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { camera } from '@kit.CameraKit';

function preLaunch(context: common.BaseContext): void {
  let cameraManager: camera.CameraManager = camera.getCameraManager(context);
  try {
    cameraManager.prelaunch();
  } catch (error) {
    let err = error as BusinessError;
    console.error(`prelaunch error. Code: ${err.code}, message: ${err.message}`);
  }
}

preSwitchCamera¹¹⁺

preSwitchCamera(cameraId: string): void

Pre-switches a camera device to speed up its startup.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
cameraId	string	Yes	Camera ID.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400101	Parameter missing or parameter type incorrect.
7400201	Camera service fatal error.

Example

import { common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

function preSwitch(cameraDevice: camera.CameraDevice, context: common.BaseContext): void {
  let cameraManager: camera.CameraManager = camera.getCameraManager(context);
  try {
    cameraManager.preSwitchCamera(cameraDevice.cameraId);
  } catch (error) {
    let err = error as BusinessError;
    console.error(`prelaunch error. Code: ${err.code}, message: ${err.message}`);
  }
}

CameraOutputCapability

Describes the camera output capability.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Type	Read-only	Optional	Description
depthProfiles¹³⁺	Array<DepthProfile>	Yes	No	Supported depth stream profiles.

CameraFormat

Enumerates the camera output formats.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
CAMERA_FORMAT_DNG_XDRAW¹⁸⁺	5	Image in extreme digital format.
CAMERA_FORMAT_DEPTH_16¹³⁺	3000	Depth map in DEPTH_16 format.
CAMERA_FORMAT_DEPTH_32¹³⁺	3001	Depth map in DEPTH_32 format.

CameraInput

Defines the camera input object.

It provides camera device information used in Session.

DepthDataAccuracy¹³⁺

Describes the accuracy of depth data.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
DEPTH_DATA_ACCURACY_RELATIVE	0	Relative accuracy, which is the depth map calculated based on the disparity.
DEPTH_DATA_ACCURACY_ABSOLUTE	1	Absolute accuracy, which is the depth map calculated from distance measurement.

DepthProfile¹³⁺

Describes the profile of depth data. It inherits from Profile.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Type	Read-only	Optional	Description
dataAccuracy	DepthDataAccuracy	Yes	No	Accuracy of the depth data, which can be either relative accuracy or absolute accuracy.

DepthDataQualityLevel¹³⁺

Enumerates the quality levels of depth data.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
DEPTH_DATA_QUALITY_BAD	0	The depth map is of poor quality and cannot be used for blurring.
DEPTH_DATA_QUALITY_FAIR	1	The depth map is of average quality and cannot be used for high-quality blurring.
DEPTH_DATA_QUALITY_GOOD	2	The depth map is of high quality and can be used for high-quality blurring.

DepthData¹³⁺

Describes a depth data object.

Properties

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Type	Read-only	Optional	Description
format	CameraFormat	Yes	No	Camera output format.
depthMap	image.PixelMap	Yes	No	Depth map.
qualityLevel	DepthDataQualityLevel	Yes	No	Quality level of the depth map.
dataAccuracy	DepthDataAccuracy	Yes	No	Accuracy of the depth map.

release¹³⁺

release(): Promise<void>

Releases depth data output resources. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
Promise<void>	Promise that returns no value.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

async function releaseDepthData(depthData: camera.DepthData): Promise<void> {
  await depthData.release();
}

DepthDataOutput¹³⁺

Implements depth data output. It inherits from CameraOutput.

start¹³⁺

start(): Promise<void>

Starts depth data output. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
Promise<void>	Promise that returns no value.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config.
7400201	Camera service fatal error.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function startDepthDataOutput(depthDataOutput: camera.DepthDataOutput): void {
  depthDataOutput.start().then(() => {
    console.info('Promise returned to indicate that start method execution success.');
  }).catch((error: BusinessError) => {
    console.error(`Failed to depth data output start, error code: ${error.code}.`);
  });
}

stop¹³⁺

stop(): Promise<void>

Stops depth data output. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
Promise<void>	Promise that returns no value.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config.
7400201	Camera service fatal error.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function stopDepthDataOutput(depthDataOutput: camera.DepthDataOutput): void {
  depthDataOutput.stop().then(() => {
    console.info('Promise returned to indicate that stop method execution success.');
  }).catch((error: BusinessError) => {
    console.error(`Failed to depth data output stop, error code: ${error.code}.`);
  });
}

on('depthDataAvailable')¹³⁺

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

Subscribes to depth data availability events. This API uses an asynchronous callback to return the result.

NOTE

Currently, you cannot use off() to unregister the callback in the callback method of on().

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'depthDataAvailable'. The event can be listened for when a depthDataOutput instance is created.
callback	AsyncCallback<DepthData>	Yes	Callback used to listen for depth data.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, depthData: camera.DepthData): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
}

function registerDepthDataAvailable(depthDataOutput: camera.DepthDataOutput): void {
  depthDataOutput.on('depthDataAvailable', callback);
}

off('depthDataAvailable')¹³⁺

off(type: 'depthDataAvailable', callback?: AsyncCallback<DepthData>): void

Unsubscribes from depth data availability events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'depthDataAvailable'. The event can be listened for when a depthDataOutput instance is created.
callback	AsyncCallback<DepthData>	No	Callback used to return the result. If this parameter is specified, the subscription to the specified event with the specified callback is canceled. (The callback object cannot be an anonymous function.) Otherwise, the subscriptions to the specified event with all the callbacks are canceled.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, depthData: camera.DepthData): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
}

function unRegisterDepthDataAvailable(depthDataOutput: camera.DepthDataOutput): void {
  depthDataOutput.off('depthDataAvailable', callback);
}

on('error')¹³⁺

on(type: 'error', callback: ErrorCallback): void

Subscribes to DepthDataOutput error events. This API uses an asynchronous callback to return the result.

NOTE

Currently, you cannot use off() to unregister the callback in the callback method of on().

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a depthDataOutput instance is created.
callback	ErrorCallback	Yes	Callback used to return an error code defined in CameraErrorCode.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(depthDataOutputError: BusinessError): void {
  console.error(`Depth data output error code: ${depthDataOutputError.code}`);
}

function registerDepthDataOutputError(depthDataOutput: camera.DepthDataOutput): void {
  depthDataOutput.on('error', callback);
}

off('error')¹³⁺

off(type: 'error', callback?: ErrorCallback): void

Unsubscribes from DepthDataOutput error events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a depthDataOutput instance is created.
callback	ErrorCallback	No	Callback used to return the result. If this parameter is specified, the subscription to the specified event with the specified callback is canceled. (The callback object cannot be an anonymous function.) Otherwise, the subscriptions to the specified event with all the callbacks are canceled.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterDepthDataOutputError(depthDataOutput: camera.DepthDataOutput): void {
  depthDataOutput.off('error');
}

DepthFusionQuery¹⁴⁺

A class for querying depth fusion capabilities.

isDepthFusionSupported¹⁴⁺

isDepthFusionSupported(): boolean

Checks whether depth fusion is supported.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
boolean	Check result for the support of depth fusion. true if supported, false otherwise.

Error codes

For details about the error codes, see Universal Error Codes and Camera Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config, only throw in session usage.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function isDepthFusionSupported(DepthFusionQuery: camera.DepthFusionQuery): void {
  try {
    let isSupported: boolean = DepthFusionQuery.isDepthFusionSupported();
    console.info('Indicate that isDepthFusionSupported method execution success.');
  } catch (error) {
    let err = error as BusinessError;
    console.error(`Failed to depth fusion query  isDepthFusionSupported, error code: ${err.code}.`);
  }
}

getDepthFusionThreshold¹⁴⁺

getDepthFusionThreshold(): Array<number>

Obtains the depth fusion threshold.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
Array<number>	Depth fusion threshold.

Error codes

For details about the error codes, see Universal Error Codes and Camera Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config, only throw in session usage.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function getDepthFusionThreshold(DepthFusionQuery: camera.DepthFusionQuery): void {
  try {
    let threshold: Array<number> = DepthFusionQuery.getDepthFusionThreshold();
    console.info('Promise returned to indicate that getDepthFusionThreshold method execution success.');
  } catch (error) {
    let err = error as BusinessError;
    console.error(`Failed to depth fusion query  getDepthFusionThreshold, error code: ${err.code}.`);
  }
}

DepthFusion¹⁴⁺

Depth fusion class. It inherits from DepthFusionQuery.

isDepthFusionEnabled¹⁴⁺

isDepthFusionEnabled(): boolean

Checks whether depth fusion is enabled.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
boolean	Check result for whether depth fusion is enabled. true if enabled, false otherwise.

Error codes

For details about the error codes, see Universal Error Codes and Camera Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function isDepthFusionEnabled(DepthFusion: camera.DepthFusion): boolean {
  let isEnable: boolean = false;
  try {
    isEnable = DepthFusion.isDepthFusionEnabled();
    console.info('Promise returned to indicate that isDepthFusionEnabled method execution success.');
  } catch (error) {
    let err = error as BusinessError;
    console.error(`Failed to depth fusion isDepthFusionEnabled, error code: ${err.code}.`);
  };
  return isEnable;
}

enableDepthFusion¹⁴⁺

enableDepthFusion(enabled: boolean): void

Enables depth fusion.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
enabled	boolean	Yes	Whether to enable depth fusion. true to enable, false otherwise.

Error codes

For details about the error codes, see Universal Error Codes and Camera Error Codes.

ID	Error Message
202	Not System Application.
7400101	Parameter missing or parameter type incorrect.
7400103	Session not config.
7400201	Camera service fatal error.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function enableDepthFusion(DepthFusion: camera.DepthFusion): void {
  try {
    let enabled: boolean = true;
    DepthFusion.enableDepthFusion(enabled);
    console.info('Promise returned to indicate that enableDepthFusion method execution success.');
  } catch (error) {
    let err = error as BusinessError;
    console.error(`Failed to depth fusion enableDepthFusion, error code: ${err.code}.`);
  };
}

PrelaunchConfig

Defines the camera prelaunch configuration.

Currently, the configuration is used for sensor-level prelaunch. It will be used for stream-level prelaunch in a later version.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Type	Read-only	Optional	Description
cameraDevice	CameraDevice	No	No	Camera device.
restoreParamType¹¹⁺	RestoreParamType	No	Yes	Type of the parameter used for prelaunch.
activeTime¹¹⁺	number	No	Yes	Activation time, in minutes.
settingParam¹¹⁺	SettingParam	No	Yes	Setting parameter.

RestoreParamType¹¹⁺

Enumerates the types of the parameters used for prelaunch.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
NO_NEED_RESTORE_PARAM	0	The parameter used for prelaunch is not required.
PRESISTENT_DEFAULT_PARAM	1	Persistent parameter type. This parameter is used to restore stream information with the specified time point.
TRANSIENT_ACTIVE_PARAM	2	Temporary parameter type. This parameter is used to restore stream information only within a period of time after the camera application is closed. Its priority is higher than that of the persistent parameter.

SettingParam¹¹⁺

Defines the effect parameters used to preheat an image.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Type	Read-only	Optional	Description
skinSmoothLevel	number	No	No	Skin smoothing level, which is obtained through Beauty.getSupportedBeautyRange. For example, the value 1 indicates level-1 smoothing.
faceSlender	number	No	No	Face slimming level, which is obtained through Beauty.getSupportedBeautyRange. For example, the value 1 indicates level-1 slimming.
skinTone	number	No	No	Skin tone perfection level, which is obtained through Beauty.getSupportedBeautyRange. For example, the value 0xBF986C indicates a specific color.

PreviewOutput

Implements preview output. It inherits from CameraOutput.

isSketchSupported¹¹⁺

isSketchSupported(): boolean

Checks whether Picture-in-Picture (PiP) preview is supported.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
boolean	Check result for the support of the PiP preview. true if supported, false otherwise.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function isSketchSupported(previewOutput: camera.PreviewOutput): boolean {
  try {
    let isSupported: boolean = previewOutput.isSketchSupported();
    return isSupported;
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The isSketchSupported call failed. error code: ${err.code}`);
  }
  return false;
}

getSketchRatio¹¹⁺

getSketchRatio(): number

Obtains the zoom ratio when PiP preview is enabled.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
number	Zoom ratio. If PiP preview is not supported, the value -1 is returned.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
7400103	Session not config.
202	Not System Application.

Example

function getSketchRatio(previewOutput: camera.PreviewOutput): number {
  let sketchRatio: number = previewOutput.getSketchRatio();
  return sketchRatio;
}

enableSketch¹¹⁺

enableSketch(enabled: boolean): void

Enables or disables PiP preview.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
enabled	boolean	Yes	Whether to enable or disable PiP view. true to enable, false otherwise.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400102	Operation not allowed.
7400103	Session not config.
7400201	Camera service fatal error.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function enableSketch(previewOutput: camera.PreviewOutput, session: camera.Session, cameraInput: camera.CameraInput): void {
  try {
    session.beginConfig();
    session.addInput(cameraInput);
    session.addOutput(previewOutput);
    previewOutput.enableSketch(true);
    session.commitConfig();
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The enableSketch call failed. error code: ${err.code}`);
  }
}

attachSketchSurface¹¹⁺

attachSketchSurface(surfaceId: string): void

Attaches a surface for PiP preview.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
surfaceId	string	Yes	Surface ID, which is obtained from XComponent.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400101	Parameter missing or parameter type incorrect.
7400103	Session not config.
7400201	Camera service fatal error.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function attachSketchSurface(previewOutput: camera.PreviewOutput, session: camera.Session, cameraInput: camera.CameraInput, sketchSurfaceId: string): void {
  try {
    session.beginConfig();
    session.addInput(cameraInput);
    session.addOutput(previewOutput);
    previewOutput.enableSketch(true);
    session.commitConfig();
    previewOutput.attachSketchSurface(sketchSurfaceId);
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The attachSketchSurface call failed. error code: ${err.code}`);
  }
}

on('sketchStatusChanged')¹¹⁺

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

Subscribes to PiP status change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'sketchStatusChanged'. The event can be listened for when a PiP preview stream is created. This event is triggered when PiP preview is enabled or disabled or the zoom ratio changes while PiP preview is enabled.
callback	AsyncCallback<SketchStatusData>	Yes	Callback used to return the PiP status data.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(error: BusinessError, data: camera.SketchStatusData): void {
  if (error !== undefined && error.code !== 0) {
    console.error(`Callback Error, errorCode: ${error.code}`);
    return;
  }
  console.info(`sketch errorCode is ${error.code}, data is ${JSON.stringify(data)}`);
}

function registerSketchStatusChanged(previewOutput: camera.PreviewOutput): void {
  previewOutput.on('sketchStatusChanged', callback);
}

off('sketchStatusChanged')¹¹⁺

off(type: 'sketchStatusChanged', callback?: AsyncCallback<SketchStatusData>): void

Unsubscribes from PiP status change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'sketchStatusChanged'. The event can be listened for when a PiP preview stream is created.
callback	AsyncCallback<SketchStatusData>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('sketchStatusChanged') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterSketchStatusChanged(previewOutput: camera.PreviewOutput): void {
  previewOutput.off('sketchStatusChanged');
}

DeferredDeliveryImageType¹¹⁺

Enumerates the deferred delivery image types. In deferred delivery, photo and video capture are divided into two phases. In the first phase, an image or video is output to users at a relatively fast speed. In the second phase, a higher-resolution image or video is output again after optimization processing.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
NONE	0	Deferred delivery is not supported.
PHOTO	1	Deferred delivery for photo capture.
VIDEO	2	Deferred delivery for video capture.

DeferredPhotoProxy¹¹⁺

A class object that functions as a thumbnail proxy.

getThumbnail¹¹⁺

getThumbnail(): Promise<image.PixelMap>

Obtains the PixelMap of a thumbnail. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
Promise<image.PixelMap>	PixelMap of the thumbnail.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { image } from '@kit.ImageKit';

function getThumbnail(proxyObj: camera.DeferredPhotoProxy): void {
  proxyObj.getThumbnail().then((thumbnail: image.PixelMap) => {
    AppStorage.setOrCreate('proxyThumbnail', thumbnail);
  });
}

release¹¹⁺

release(): Promise<void>

Releases depth data output resources. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
Promise<void>	Promise that returns no value.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

async function releaseDeferredPhotoProxy(proxyObj: camera.DeferredPhotoProxy): Promise<void> {
  await proxyObj.release();
}

PhotoOutput

Implements output information used in a photo session. It inherits from CameraOutput.

burstCapture¹²⁺

burstCapture(setting: PhotoCaptureSetting): Promise<void>

Starts the burst mode, in which users can capture a series of photos in quick succession. This API is generally used in photo mode. After the burst mode starts, the bottom layer continues displaying photos. You can call confirmCapture to cancel the burst mode. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
setting	PhotoCaptureSetting	Yes	Shooting parameters. The input of undefined is processed as if no parameters were passed.

Return value

Type	Description
Promise<void>	Promise that returns no value.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400101	Parameter missing or parameter type incorrect.
7400104	Session not running.
7400201	Camera service fatal error.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function burstCapture(photoOutput: camera.PhotoOutput): void {
  let captureLocation: camera.Location = {
    latitude: 0,
    longitude: 0,
    altitude: 0
  }
  let settings: camera.PhotoCaptureSetting = {
    quality: camera.QualityLevel.QUALITY_LEVEL_LOW,
    rotation: camera.ImageRotation.ROTATION_0,
    location: captureLocation,
    mirror: false
  }
  photoOutput.burstCapture(settings).then(() => {
    console.info('Promise returned to indicate that photo burstCapture request success.');
  }).catch((error: BusinessError) => {
    console.error(`Failed to photo output burstCapture, error code: ${error.code}.`);
  });
}

confirmCapture¹¹⁺

confirmCapture(): void

Confirms photo capture. This API is generally used in night photo mode when users need to stop the exposure countdown and take a photo in advance.

This API is used to end the burst mode, which is started by calling burstCapture.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400104	Session not running.
7400201	Camera service fatal error.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function confirmCapture(photoOutput: camera.PhotoOutput): void {
  try {
    photoOutput.confirmCapture();
  } catch (error) {
    let err = error as BusinessError;
    console.error(`The confirmCapture call failed. error code: ${err.code}`);
  }
}

isDeferredImageDeliverySupported¹¹⁺

isDeferredImageDeliverySupported(type: DeferredDeliveryImageType): boolean

Checks whether deferred delivery of a certain type is supported.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	DeferredDeliveryImageType	Yes	Deferred delivery image type.

Return value

Type	Description
boolean	Check result for the support of deferred delivery. true if supported, false otherwise.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
7400101	Parameter missing or parameter type incorrect.
7400104	Session not running.
7400201	Camera service fatal error.
202	Not System Application.

Example

function isDeferredImageDeliverySupported(photoOutput: camera.PhotoOutput, type: camera.DeferredDeliveryImageType): boolean {
  let res: boolean = false;
  res = photoOutput.isDeferredImageDeliverySupported(type);
  return res;
}

isDeferredImageDeliveryEnabled¹¹⁺

isDeferredImageDeliveryEnabled(type: DeferredDeliveryImageType): boolean

Checks whether deferred delivery of a certain type is enabled.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	DeferredDeliveryImageType	Yes	Deferred delivery image type.

Return value

Type	Description
boolean	Check result for whether deferred delivery is enabled. true if enabled, false otherwise.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
7400101	Parameter missing or parameter type incorrect.
7400104	Session not running.
7400201	Camera service fatal error.
202	Not System Application.

Example

function isDeferredImageDeliveryEnabled(photoOutput: camera.PhotoOutput, type: camera.DeferredDeliveryImageType): boolean {
  let res: boolean = false;
  res = photoOutput.isDeferredImageDeliveryEnabled(type);
  return res;
}

deferImageDelivery¹¹⁺

deferImageDelivery(type: DeferredDeliveryImageType): void

Enables deferred delivery of a certain type.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	DeferredDeliveryImageType	Yes	Deferred delivery image type.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
7400101	Parameter missing or parameter type incorrect.
7400104	Session not running.
7400201	Camera service fatal error.
202	Not System Application.

Example

function deferImageDelivery(photoOutput: camera.PhotoOutput, type: camera.DeferredDeliveryImageType): void {
  photoOutput.deferImageDelivery(type);
}

isAutoHighQualityPhotoSupported¹³⁺

isAutoHighQualityPhotoSupported(): boolean

Checks whether automatic high quality is supported for photos.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
boolean	Check result for whether automatic high quality is supported. true if supported, false otherwise.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400104	Session not running.
7400201	Camera service fatal error.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function isAutoHighQualityPhotoSupported(photoOutput: camera.PhotoOutput): boolean {
  return photoOutput.isAutoHighQualityPhotoSupported();
}

enableAutoHighQualityPhoto¹³⁺

enableAutoHighQualityPhoto(enabled: boolean): void

Enables automatic high quality for photos. Before using this API, call isAutoHighQualityPhotoSupported to check whether automatic high quality is supported.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
enabled	boolean	Yes	Whether to enable or disable automatic high quality for photos. true to enable, false otherwise.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400101	Parameter missing or parameter type incorrect.
7400104	Session not running.
7400201	Camera service fatal error.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function enableAutoHighQualityPhoto(photoOutput: camera.PhotoOutput): void {
  return photoOutput.enableAutoHighQualityPhoto(true);
}

on('deferredPhotoProxyAvailable')¹¹⁺

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

Subscribes to events indicating available thumbnail proxies. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'deferredPhotoProxyAvailable'. The event can be listened for when a photoOutput instance is created.
callback	AsyncCallback<DeferredPhotoProxy>	Yes	Callback used to return the thumbnail proxy.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';
import { image } from '@kit.ImageKit';

function callback(err: BusinessError, proxyObj: camera.DeferredPhotoProxy): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  proxyObj.getThumbnail().then((thumbnail: image.PixelMap) => {
    AppStorage.setOrCreate('proxyThumbnail', thumbnail);
  });
}

function registerPhotoOutputDeferredPhotoProxyAvailable(photoOutput: camera.PhotoOutput): void {
  photoOutput.on('deferredPhotoProxyAvailable', callback);
}

off('deferredPhotoProxyAvailable')¹¹⁺

off(type: 'deferredPhotoProxyAvailable', callback?: AsyncCallback<DeferredPhotoProxy>): void

Unsubscribes from events indicating available thumbnail proxies.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'deferredPhotoProxyAvailable'. The event can be listened for when a photoOutput instance is created.
callback	AsyncCallback<DeferredPhotoProxy>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('deferredPhotoProxyAvailable') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';
import { image } from '@kit.ImageKit';

function callback(err: BusinessError, proxyObj: camera.DeferredPhotoProxy): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  proxyObj.getThumbnail().then((thumbnail: image.PixelMap) => {
    AppStorage.setOrCreate('proxyThumbnail', thumbnail);
  });
}

function unRegisterPhotoOutputDeferredPhotoProxyAvailable(photoOutput: camera.PhotoOutput): void {
  photoOutput.off('deferredPhotoProxyAvailable', callback);
}

isQuickThumbnailSupported

isQuickThumbnailSupported(): boolean

Checks whether the quick thumbnail feature is supported.

This API takes effect after addOutput and addInput and before commitConfig.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
boolean	Check result for the support of the quick thumbnail feature. true if supported, false otherwise.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400104	session is not running.

Example

import { common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

async function isQuickThumbnailSupported(context: common.BaseContext, mode: camera.SceneMode, photoProfile: camera.Profile): Promise<boolean> {
  let cameraManager: camera.CameraManager = camera.getCameraManager(context);
  let cameras: Array<camera.CameraDevice> = cameraManager.getSupportedCameras();
  // Create a CaptureSession instance.
  let session: camera.Session = cameraManager.createSession(mode);
  // Start configuration for the session.
  session.beginConfig();
  // Add a CameraInput instance to the session.
  if (cameras.length <= 0) {
    console.info('Get supported cameras is null or [].');
    return false;
  }
  let cameraInput: camera.CameraInput = cameraManager.createCameraInput(cameras[0]);
  await cameraInput.open();
  session.addInput(cameraInput);
  // Add a PhotoOutput instance to the session.
  let photoOutput: camera.PhotoOutput = cameraManager.createPhotoOutput(photoProfile);
  try {
    session.addOutput(photoOutput);
  } catch (error) {
    let err = error as BusinessError;
    console.error(`AddOutput called failed. error code: ${err.code}`);
    return false;
  }
  let isSupported: boolean = photoOutput.isQuickThumbnailSupported();
  return isSupported;
}

enableQuickThumbnail

enableQuickThumbnail(enabled: boolean): void

Enables or disables the quick thumbnail feature.

This API takes effect after addOutput and addInput and before commitConfig.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
enabled	boolean	Yes	Whether to enable the quick thumbnail feature. true to enable, false otherwise.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400101	Parameter missing or parameter type incorrect.
7400104	session is not running.
7400201	Camera service fatal error.

Example

import { common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { camera } from '@kit.CameraKit';

async function enableQuickThumbnail(context: common.BaseContext, mode: camera.SceneMode, photoProfile: camera.Profile): Promise<void> {
  let cameraManager: camera.CameraManager = camera.getCameraManager(context);
  let cameras: Array<camera.CameraDevice> = cameraManager.getSupportedCameras();
  // Create a CaptureSession instance.
  let session: camera.Session = cameraManager.createSession(mode);
  // Start configuration for the session.
  session.beginConfig();
  // Add a CameraInput instance to the session.
  let cameraInput: camera.CameraInput = cameraManager.createCameraInput(cameras[0]);
  await cameraInput.open();
  session.addInput(cameraInput);
  // Add a PhotoOutput instance to the session.
  let photoOutput: camera.PhotoOutput = cameraManager.createPhotoOutput(photoProfile);
  session.addOutput(photoOutput);
  let isSupported: boolean = photoOutput.isQuickThumbnailSupported();
  if (!isSupported) {
    console.info('Quick Thumbnail is not supported to be turned on.');
    return;
  }
  try {
    photoOutput.enableQuickThumbnail(true);
  } catch (error) {
    let err = error as BusinessError;
    console.error(`The enableQuickThumbnail call failed. error code: ${err.code}`);
  }
}

on('quickThumbnail')

on(type: 'quickThumbnail', callback: AsyncCallback<image.PixelMap>): void

Subscribes to quick thumbnail output events. This API uses an asynchronous callback to return the result.

The listening takes effect after enableQuickThumbnail(true) is called.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'quickThumbnail'.
callback	AsyncCallback<image.PixelMap>	Yes	Callback that returns a PixelMap instance.

Example

import { common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { image } from '@kit.ImageKit';
import { camera } from '@kit.CameraKit';

function callback(err: BusinessError, pixelMap: image.PixelMap): void {
  if (err || pixelMap === undefined) {
      console.error('photoOutput on thumbnail failed');
      return;
  }
  // Display or save the PixelMap instance.
  // Execute the operation.
}

async function registerQuickThumbnail(context: common.BaseContext, mode: camera.SceneMode, photoProfile: camera.Profile): Promise<void> {
  let cameraManager: camera.CameraManager = camera.getCameraManager(context);
  let cameras: Array<camera.CameraDevice> = cameraManager.getSupportedCameras();
  // Create a CaptureSession instance.
  let session: camera.Session = cameraManager.createSession(mode);
  // Start configuration for the session.
  session.beginConfig();
  // Add a CameraInput instance to the session.
  let cameraInput: camera.CameraInput = cameraManager.createCameraInput(cameras[0]);
  await cameraInput.open();
  session.addInput(cameraInput);
  // Add a PhotoOutput instance to the session.
  let photoOutput: camera.PhotoOutput = cameraManager.createPhotoOutput(photoProfile);
  session.addOutput(photoOutput);
  let isSupported: boolean = photoOutput.isQuickThumbnailSupported();
  if (!isSupported) {
    console.info('Quick Thumbnail is not supported to be turned on.');
    return;
  }
  try {
    photoOutput.enableQuickThumbnail(true);
  } catch (error) {
    let err = error as BusinessError;
    console.error(`The enableQuickThumbnail call failed. error code: ${err.code}`);
  }

  photoOutput.on('quickThumbnail', callback);
}

off('quickThumbnail')

off(type: 'quickThumbnail', callback?: AsyncCallback<image.PixelMap>): void

Unsubscribes from quick thumbnail output events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'quickThumbnail'.
callback	AsyncCallback<image.PixelMap>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('quickThumbnail') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Example

function unregisterQuickThumbnail(photoOutput: camera.PhotoOutput): void {
  photoOutput.off('quickThumbnail');
}

MetadataOutput

Implements metadata streams. It inherits from CameraOutput.

MetadataObjectType

Enumerates the types of metadata objects used for camera detection.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
HUMAN_BODY¹³⁺	1	Metadata object used for human body detection.
CAT_FACE¹³⁺	2	Metadata object used for cat face detection.
CAT_BODY¹³⁺	3	Metadata object used for cat body detection.
DOG_FACE¹³⁺	4	Metadata object used for dog face detection.
DOG_BODY¹³⁺	5	Metadata object used for dog body detection.
SALIENT_DETECTION¹³⁺	6	Metadata object used for salient detection.

Emotion¹³⁺

Enumerates the types of emotions in the detected human face information.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
NEUTRAL	0	Quiet and calm.
SADNESS	1	Sad.
SMILE	2	Smile.
SURPRISE	3	Surprise.

MetadataObject

Implements the basic metadata object used for camera detection. It serves as the data source of the camera information in CameraInput. It is obtained by calling metadataOutput.on('metadataObjectsAvailable').

System capability: SystemCapability.Multimedia.Camera.Core

Name	Type	Read-only	Optional	Description
objectId¹³⁺	number	Yes	No	Metadata object ID.
confidence¹³⁺	number	Yes	No	Confidence of the detection, with a value range of [0, 1].

MetadataFaceObject¹³⁺

Implements the human face metadata object used for camera detection. It inherits from MetadataObject and is the data source of the camera information in CameraInput. It is obtained by calling metadataOutput.on('metadataObjectsAvailable').

System capability: SystemCapability.Multimedia.Camera.Core

Name	Type	Read-only	Optional	Description
leftEyeBoundingBox	Rect	Yes	No	Left eye area.
rightEyeBoundingBox	Rect	Yes	No	Right eye area.
emotion	Emotion	Yes	No	Detected emotion.
emotionConfidence	number	Yes	No	Confidence of the emotion detection, with a value range of [0, 1].
pitchAngle	number	Yes	No	Pitch angle, with a value range of [-90, 90], where downward is positive.
yawAngle	number	Yes	No	Yaw angle, with a value range of [-90, 90], where rightward is positive.
rollAngle	number	Yes	No	Row angle, with a value range of [-180, 180], where clockwise direction is positive.

MetadataHumanBodyObject¹³⁺

Implements the human body metadata object used for camera detection. It inherits from MetadataObject and is the data source of the camera information in CameraInput. It is obtained by calling metadataOutput.on('metadataObjectsAvailable').

System capability: SystemCapability.Multimedia.Camera.Core

MetadataCatFaceObject¹³⁺

Implements the cat face metadata object used for camera detection. It inherits from MetadataObject and is the data source of the camera information in CameraInput. It is obtained by calling metadataOutput.on('metadataObjectsAvailable').

System capability: SystemCapability.Multimedia.Camera.Core

Name	Type	Read-only	Optional	Description
leftEyeBoundingBox	Rect	Yes	No	Left eye area.
rightEyeBoundingBox	Rect	Yes	No	Right eye area.

MetadataCatBodyObject¹³⁺

Implements the cat body metadata object used for camera detection. It inherits from MetadataObject and is the data source of the camera information in CameraInput. It is obtained by calling metadataOutput.on('metadataObjectsAvailable').

System capability: SystemCapability.Multimedia.Camera.Core

MetadataDogFaceObject¹³⁺

Implements the dog face metadata object used for camera detection. It inherits from MetadataObject and is the data source of the camera information in CameraInput. It is obtained by calling metadataOutput.on('metadataObjectsAvailable').

System capability: SystemCapability.Multimedia.Camera.Core

Name	Type	Read-only	Optional	Description
leftEyeBoundingBox	Rect	Yes	No	Left eye area.
rightEyeBoundingBox	Rect	Yes	No	Right eye area.

MetadataDogBodyObject¹³⁺

Implements the dog body metadata object used for camera detection. It inherits from MetadataObject and is the data source of the camera information in CameraInput. It is obtained by calling metadataOutput.on('metadataObjectsAvailable').

System capability: SystemCapability.Multimedia.Camera.Core

MetadataSalientDetectionObject¹³⁺

Implements the salient detection metadata object used for camera detection. It inherits from MetadataObject and is the data source of the camera information in CameraInput. It is obtained by calling metadataOutput.on('metadataObjectsAvailable').

System capability: SystemCapability.Multimedia.Camera.Core

MetadataBarcodeObject¹⁴⁺

Implements the barcode metadata object used for camera detection. It inherits from MetadataObject and is the data source of the camera information in CameraInput. It is obtained by calling metadataOutput.on('metadataObjectsAvailable').

System capability: SystemCapability.Multimedia.Camera.Core

PortraitEffect

Enumerates the portrait effects.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
OFF	0	Disabled.
CIRCLES	1	Circles.
HEART¹¹⁺	2	Heart-shaped.
ROTATED¹¹⁺	3	Rotated.
STUDIO¹¹⁺	4	Studio light.
THEATER¹¹⁺	5	Theater light.

BeautyQuery¹²⁺

Provides APIs to obtain and set the beauty effect.

getSupportedBeautyTypes¹¹⁺

getSupportedBeautyTypes(): Array<BeautyType>

Obtains the supported beauty types.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
Array<BeautyType>	Array of beauty types supported.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config, only throw in session usage.

Example

function getSupportedBeautyTypes(portraitPhotoSession: camera.PortraitPhotoSession): Array<camera.BeautyType> {
  let beautyTypes: Array<camera.BeautyType> = portraitPhotoSession.getSupportedBeautyTypes();
  return beautyTypes;
}

getSupportedBeautyRange¹¹⁺

getSupportedBeautyRange(type: BeautyType): Array<number>

Obtains the levels that can be set a beauty type. The beauty levels vary according to the device type. The following table is only an example.

Input Parameter	Example Return Value	Return Value Description
AUTO	[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10]	Beauty levels supported when type is set to AUTO. The value 0 means that beauty mode is disabled, and other positive values mean the corresponding automatic beauty levels.
SKIN_SMOOTH	[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10]	Beauty levels supported when type is set to SKIN_SMOOTH. The value 0 means that the skin smoothing feature is disabled, and other positive values mean the corresponding skin smoothing levels.
FACE_SLENDER	[0, 1, 2, 3, 4, 5]	Beauty levels supported when type is set to FACE_SLENDER. The value 0 means that the face slimming feature is disabled, and other positive values mean the corresponding face slimming levels.
SKIN_TONE	[-1, 16242611]	Beauty levels supported when type is set to SKIN_TONE. The value -1 means that the skin tone perfection feature is disabled. Other non-negative values mean the skin tone perfection levels represented by RGB, for example, 16242611, which is 0xF7D7B3 in hexadecimal format, where F7, D7, and B3 represent the values of the R channel, G channel, and B channel, respectively.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	BeautyType	Yes	Beauty type.

Return value

Type	Description
Array<number>	Array of levels supported.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config, only throw in session usage.

Example

function getSupportedBeautyRange(portraitPhotoSession: camera.PortraitPhotoSession): Array<number> {
  let beautyTypes: Array<camera.BeautyType> = portraitPhotoSession.getSupportedBeautyTypes();
  if (beautyTypes === undefined || beautyTypes.length <= 0) {
    return [];
  }
  let beautyLevels: Array<number> = portraitPhotoSession.getSupportedBeautyRange(beautyTypes[0]);
  return beautyLevels;
}

BeautyType

Enumerates the beauty types.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
AUTO	0	Automatic.
SKIN_SMOOTH	1	Skin smoothing.
FACE_SLENDER	2	Face slimming.
SKIN_TONE	3	Skin tone perfection.

ManualExposureQuery¹²⁺

Provides APIs to obtain the manual exposure range supported.

getSupportedExposureRange¹¹⁺

getSupportedExposureRange(): Array<number>

Obtains the supported manual exposure durations.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
Array<number>	Array of manual exposure durations supported, in ms.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400101	Parameter missing or parameter type incorrect.
7400103	Session not config, only throw in session usage.

Example

function getSupportedExposureRange(nightPhotoSession: camera.NightPhotoSession): Array<number> {
  let exposureRange: Array<number> = nightPhotoSession.getSupportedExposureRange();
  return exposureRange;
}

ManualExposure¹¹⁺

ManualExposure extends ManualExposureQuery

Provides APIs to obtain and set the exposure duration.

getExposure¹¹⁺

getExposure(): number

Obtains the manual exposure duration in use.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Name	Type	Mandatory	Description
value	number	Yes	Manual exposure duration, in ms.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400101	Parameter missing or parameter type incorrect.
7400103	Session not config.

Example

function getExposure(nightPhotoSession: camera.NightPhotoSession): number | undefined {
  let exposureRange: Array<number> = nightPhotoSession.getSupportedExposureRange();
  if (exposureRange === undefined || exposureRange.length <= 0) {
    return undefined;
  }
  let exposure: number = nightPhotoSession.getExposure();
  return exposure;
}

setExposure¹¹⁺

setExposure(exposure: number): void

Sets the manual exposure duration. Before using this API, call getSupportedExposureRange to obtain the supported manual exposure durations, in ms.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
exposure	number	Yes	Manual exposure duration, which must be one of the supported durations obtained by running getSupportedExposureRange.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400102	Operation not allowed.
7400103	Session not config.

function setExposure(nightPhotoSession: camera.NightPhotoSession): void {
  let exposureRange: Array<number> = nightPhotoSession.getSupportedExposureRange();
  if (exposureRange === undefined || exposureRange.length <= 0) {
    return;
  }
  nightPhotoSession.setExposure(exposureRange[0]);
}

TripodStatus¹³⁺

Enumerates the tripod statuses.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
INVALID	0	Error status, or no tripod detected. System API: This is a system API.
ACTIVE	1	The tripod is active. System API: This is a system API.
ENTERING	2	The system is transitioning into a stable tripod mode. System API: This is a system API.
EXITING	3	The system is leaving the stable tripod mode. System API: This is a system API.

SceneFeatureType¹²⁺

Enumerates the scene features.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
MOON_CAPTURE_BOOST	0	Moon scene. System API: This is a system API.
TRIPOD_DETECTION¹³⁺	1	Scene where a tripod is used for photo capture. System API: This is a system API.
LOW_LIGHT_BOOST¹³⁺	2	Scene for long exposure photography. System API: This is a system API.

SceneFeatureDetectionResult¹²⁺

Describes the scene feature detection result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Type	Read-only	Optional	Description
featureType	SceneFeatureType	Yes	No	Scene feature type.
detected	boolean	Yes	No	Whether the specified scene feature is detected. true if detected, false otherwise.

TripodDetectionResult¹³⁺

TripodDetectionResult extends SceneFeatureDetectionResult

Describes the tripod detection result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Type	Read-only	Optional	Description
tripodStatus	TripodStatus	Yes	No	Tripod status.

SceneDetectionQuery¹²⁺

Provides the scene detection and query capabilities.

isSceneFeatureSupported¹²⁺

isSceneFeatureSupported(type: SceneFeatureType): boolean

Checks whether a scene feature is supported.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	SceneFeatureType	Yes	Scene feature.

Return value

Type	Description
boolean	Check result for the support of the scene feature. true if supported, false otherwise.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application, only throw in session usage.
7400101	Parameter missing or parameter type incorrect.

Example

function isSceneFeatureSupported(photoSessionForSys: camera.PhotoSessionForSys, featureType: camera.SceneFeatureType): boolean {
  let isSupported: boolean = photoSessionForSys.isSceneFeatureSupported(featureType);
  return isSupported;
}

SceneDetection¹²⁺

Provides the scene detection capability. It inherits from SceneDetectionQuery.

enableSceneFeature¹²⁺

enableSceneFeature(type: SceneFeatureType, enabled: boolean): void

Enables or disables a scene feature. This API must be called after SceneFeatureDetectionResult of the corresponding scene feature is received.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	SceneFeatureType	Yes	Scene feature.
enabled	boolean	Yes	Whether to enable the scene feature. true to enable, false otherwise.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400101	Parameter missing or parameter type incorrect.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function enableSceneFeature(photoSession: camera.PhotoSessionForSys, cameraInput: camera.CameraInput, previewOutput: camera.PreviewOutput): void {
  photoSession.beginConfig();
  photoSession.addInput(cameraInput);
  photoSession.addOutput(previewOutput);
  photoSession.commitConfig();

  photoSession.on('featureDetection', camera.SceneFeatureType.MOON_CAPTURE_BOOST,
    (err: BusinessError, statusObject: camera.SceneFeatureDetectionResult) => {
      if (err !== undefined && err.code !== 0) {
        console.error(`Callback Error, errorCode: ${err.code}`);
        return;
      }
      console.info(
        `on featureDetectionStatus featureType:${statusObject.featureType} detected:${statusObject.detected}`);
      if (statusObject.featureType === camera.SceneFeatureType.MOON_CAPTURE_BOOST) {
        try {
          photoSession.enableSceneFeature(statusObject.featureType, statusObject.detected);
        } catch (error) {
          let err = error as BusinessError;
          console.error(`The enableSceneFeature call failed. error code: ${err.code}`);
        }
      }
    });
}

ZoomPointInfo¹²⁺

Describes the equivalent focal length information.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Type	Read-only	Optional	Description
zoomRatio	number	Yes	No	Zoom ratio.
equivalentFocalLength	number	Yes	No	Equivalent focal length corresponding to the current focal length ratio.

ZoomQuery¹²⁺

Provides the API to obtain the equivalent focal length information list in the current mode.

getZoomPointInfos¹²⁺

getZoomPointInfos(): Array<ZoomPointInfo>

Obtains the equivalent focal length information list in the current mode.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
Array<ZoomPointInfo>	Equivalent focal length information list in the current mode.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config, only throw in session usage.

Example

import { camera } from '@kit.CameraKit';
import { BusinessError } from '@kit.BasicServicesKit';

function getZoomPointInfos(photoSessionForSys: camera.PhotoSessionForSys): Array<camera.ZoomPointInfo> {
  let zoomPointInfos: Array<camera.ZoomPointInfo> = [];
  try {
    zoomPointInfos = photoSessionForSys.getZoomPointInfos();
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The getZoomPointInfos call failed. error code: ${err.code}`);
  }
  return zoomPointInfos;
}

Zoom¹¹⁺

Zoom extend ZoomQuery

Provides APIs to process the zoom effect of a camera device, including obtaining the current zoom ratio, setting a zoom ratio, setting a zoom ratio in a smooth manner, and preparing or unpreparing for zooming.

prepareZoom¹¹⁺

prepareZoom(): void

Instructs the bottom layer to prepare for zooming, for example, powering on the sensor.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function prepareZoom(sessionExtendsZoom: camera.Zoom): void {
  try {
    sessionExtendsZoom.prepareZoom();
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The prepareZoom call failed. error code: ${err.code}`);
  }
}

unprepareZoom¹¹⁺

unprepareZoom(): void

Instructs the bottom layer to unprepare for zooming.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function unprepareZoom(sessionExtendsZoom: camera.Zoom): void {
  try {
    sessionExtendsZoom.unprepareZoom();
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The unprepareZoom call failed. error code: ${err.code}`);
  }
}

Beauty¹¹⁺

Beauty extends BeautyQuery

Provides APIs to obtain and set the beauty effect.

setBeauty¹¹⁺

setBeauty(type: BeautyType, value: number): void

Sets a beauty type and its level. Beauty mode is turned off only when all the beauty types obtained through getSupportedBeautyTypes are disabled.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	BeautyType	Yes	Beauty type.
value	number	Yes	Beauty level, which is obtained through getSupportedBeautyRange.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config.

Example

function setBeauty(portraitPhotoSession: camera.PortraitPhotoSession): void {
  let beautyTypes: Array<camera.BeautyType> = portraitPhotoSession.getSupportedBeautyTypes();
  if (beautyTypes === undefined || beautyTypes.length <= 0) {
    return;
  }
  let beautyLevels: Array<number> = portraitPhotoSession.getSupportedBeautyRange(beautyTypes[0]);
  if (beautyLevels === undefined || beautyLevels.length <= 0) {
    return;
  }
  portraitPhotoSession.setBeauty(beautyTypes[0], beautyLevels[0]);
}

getBeauty¹¹⁺

getBeauty(type: BeautyType): number

Obtains the level of the beauty type in use.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	BeautyType	Yes	Beauty type.

Return value

Name	Type	Mandatory	Description
value	number	Yes	Beauty level.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config.

Example

function getBeauty(portraitPhotoSession: camera.PortraitPhotoSession): number {
  const invalidValue: number = -1;
  let beautyTypes = portraitPhotoSession.getSupportedBeautyTypes();
  if (beautyTypes === undefined || beautyTypes.length <= 0) {
    return invalidValue;
  }
  let beautyLevels: Array<number> = portraitPhotoSession.getSupportedBeautyRange(beautyTypes[0]);
  if (beautyLevels === undefined || beautyLevels.length <= 0) {
    return invalidValue;
  }
  portraitPhotoSession.setBeauty(beautyTypes[0], beautyLevels[0]);
  let beautyLevel: number = portraitPhotoSession.getBeauty(beautyTypes[0]);
  return beautyLevel;
}

ColorEffectQuery¹²⁺

Provides the API to obtain the color effects supported.

getSupportedColorEffects¹¹⁺

getSupportedColorEffects(): Array<ColorEffectType>

Obtains the supported color effects.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
Array<ColorEffectType>	Array of color effects supported.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config, only throw in session usage.

Example

function getSupportedColorEffects(session: camera.PhotoSessionForSys): Array<camera.ColorEffectType> {
  let colorEffects: Array<camera.ColorEffectType> = session.getSupportedColorEffects();
  return colorEffects;
}

ColorEffect¹¹⁺

ColorEffect extends ColorEffectQuery

Provides the APIs to obtain and set the lens color effect.

setColorEffect¹¹⁺

setColorEffect(type: ColorEffectType): void

Sets a color effect. Before the setting, call getSupportedColorEffects to obtain the supported color effects.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	ColorEffectType	Yes	Color effect, which can be obtained through getSupportedColorEffects.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
7400103	Session not config.
202	Not System Application.

Example

function setColorEffect(session: camera.PhotoSessionForSys, colorEffect: camera.ColorEffectType): void {
  session.setColorEffect(colorEffect);
}

getColorEffect¹¹⁺

getColorEffect(): ColorEffectType

Obtains the color effect in use.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
ColorEffectType	Color effect.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
7400103	Session not config.
202	Not System Application.

Example

function getColorEffect(session: camera.PhotoSessionForSys): camera.ColorEffectType {
  let colorEffect: camera.ColorEffectType = session.getColorEffect();
  return colorEffect;
}

ColorEffectType¹¹⁺

Enumerates the color effect types.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
NORMAL	0	Regular color effect.
BRIGHT	1	Bright color effect.
SOFT	2	Soft color effect.
BLACK_WHITE¹²⁺	3	Black and white color effect.

PortraitQuery¹²⁺

Queries portrait parameters.

getSupportedPortraitEffects

getSupportedPortraitEffects(): Array<PortraitEffect>

Obtains the supported portrait effects.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
Array<PortraitEffect>	Array of portrait effects supported.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config, only throw in session usage.

Example

function getSupportedPortraitEffects(portraitPhotoSession: camera.PortraitPhotoSession): Array<camera.PortraitEffect> {
  let portraitEffects: Array<camera.PortraitEffect> = portraitPhotoSession.getSupportedPortraitEffects();
  return portraitEffects;
}

Portrait¹¹⁺

Portrait inherits from PortraitQuery.

Provides the APIs for portrait photo settings.

setPortraitEffect

setPortraitEffect(effect: PortraitEffect): void

Sets a portrait effect. Before the setting, use getSupportedPortraitEffects to obtain the supported portrait effects and check whether the target portrait effect is supported.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
effect	PortraitEffect	Yes	Portrait effect, which can be obtained through getSupportedPortraitEffects.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
7400103	Session not config.
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function setPortraitEffect(portraitPhotoSession: camera.PortraitPhotoSession, portraitEffects: Array<camera.PortraitEffect>): void {
  if (portraitEffects === undefined || portraitEffects.length <= 0) {
    return;
  }
  try {
    portraitPhotoSession.setPortraitEffect(portraitEffects[0]);
  } catch (error) {
    let err = error as BusinessError;
    console.error(`The setPortraitEffect call failed. error code: ${err.code}`);
  }
}

getPortraitEffect

getPortraitEffect(): PortraitEffect

Obtains the portrait effect in use.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
PortraitEffect	Portrait effect.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
7400103	Session not config.
202	Not System Application.

Example

function getPortraitEffect(portraitPhotoSession: camera.PortraitPhotoSession): camera.PortraitEffect {
  let portraitEffect: camera.PortraitEffect = portraitPhotoSession.getPortraitEffect();
  return portraitEffect;
}

ApertureQuery¹²⁺

Provides the aperture query capability.

getSupportedVirtualApertures¹¹⁺

getSupportedVirtualApertures(): Array<number>

Obtains the supported virtual apertures.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
Array<number>	Array of virtual apertures supported.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config, only throw in session usage.

Example

function getSupportedVirtualApertures(session: camera.PortraitPhotoSession): Array<number> {
  let virtualApertures: Array<number> = session.getSupportedVirtualApertures();
  return virtualApertures;
}

Aperture¹¹⁺

Provides the APIs for aperture settings. It inherits from ApertureQuery.

getVirtualAperture¹¹⁺

getVirtualAperture(): number

Obtains the virtual aperture in use.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
number	Virtual aperture.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
7400103	Session not config.
202	Not System Application.

Example

function getVirtualAperture(session: camera.PortraitPhotoSession): number {
  let virtualAperture: number = session.getVirtualAperture();
  return virtualAperture;
}

setVirtualAperture¹¹⁺

setVirtualAperture(aperture: number): void

Sets a virtual aperture. Before the setting, call getSupportedVirtualApertures to obtain the supported virtual apertures.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
aperture	number	Yes	Virtual aperture, which can be obtained by calling getSupportedVirtualApertures.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
7400103	Session not config.
202	Not System Application.

Example

function setVirtualAperture(session: camera.PortraitPhotoSession, virtualAperture: number): void {
  session.setVirtualAperture(virtualAperture);
}

CaptureSession^(deprecated)

Implements a capture session, which saves all CameraInput and CameraOutput instances required to run the camera and requests the camera to complete shooting or video recording.

NOTE This API is supported since API version 10 and deprecated since API version 11. You are advised to use PhotoSession and VideoSession instead.

getSupportedBeautyTypes^(deprecated)

getSupportedBeautyTypes(): Array<BeautyType>

Obtains the supported beauty types.

NOTE This API is supported since API version 10 and deprecated since API version 11. You are advised to use Beauty.getSupportedBeautyTypes instead.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
Array<BeautyType>	Array of beauty types supported.

Error codes

For details about the error codes, see Camera Error Codes.

ID	Error Message
7400103	Session not config.

Example

function getSupportedBeautyTypes(captureSession: camera.CaptureSession): Array<camera.BeautyType> {
  let beautyTypes: Array<camera.BeautyType> = captureSession.getSupportedBeautyTypes();
  return beautyTypes;
}

getSupportedBeautyRange^(deprecated)

getSupportedBeautyRange(type: BeautyType): Array<number>

Obtains the levels that can be set a beauty type. The beauty levels vary according to the device type. The following table is only an example.

Input Parameter	Example Return Value	Return Value Description
AUTO	[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10]	Beauty levels supported when type is set to AUTO. The value 0 means that beauty mode is disabled, and other positive values mean the corresponding automatic beauty levels.
SKIN_SMOOTH	[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10]	Beauty levels supported when type is set to SKIN_SMOOTH. The value 0 means that the skin smoothing feature is disabled, and other positive values mean the corresponding skin smoothing levels.
FACE_SLENDER	[0, 1, 2, 3, 4, 5]	Beauty levels supported when type is set to FACE_SLENDER. The value 0 means that the face slimming feature is disabled, and other positive values mean the corresponding face slimming levels.
SKIN_TONE	[-1, 16242611]	Beauty levels supported when type is set to SKIN_TONE. The value -1 means that the skin tone perfection feature is disabled. Other non-negative values mean the skin tone perfection levels represented by RGB, for example, 16242611, which is 0xF7D7B3 in hexadecimal format, where F7, D7, and B3 represent the values of the R channel, G channel, and B channel, respectively.

NOTE This API is supported since API version 10 and deprecated since API version 11. You are advised to use Beauty.getSupportedBeautyRange instead.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	BeautyType	Yes	Beauty type.

Return value

Type	Description
Array<number>	Array of levels supported.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
7400103	Session not config.
202	Not System Application.

Example

function getSupportedBeautyRange(captureSession: camera.CaptureSession): Array<number> {
  let beautyTypes: Array<camera.BeautyType> = captureSession.getSupportedBeautyTypes();
  if (beautyTypes === undefined || beautyTypes.length <= 0) {
    return [];
  }
  let beautyLevels: Array<number> = captureSession.getSupportedBeautyRange(beautyTypes[0]);
  return beautyLevels;
}

setBeauty^(deprecated)

setBeauty(type: BeautyType, value: number): void

Sets a beauty type and its level. Beauty mode is turned off only when all the beauty types obtained through getSupportedBeautyTypes are disabled.

NOTE This API is supported since API version 10 and deprecated since API version 11. You are advised to use Beauty.setBeauty instead.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	BeautyType	Yes	Beauty type.
value	number	Yes	Beauty level, which is obtained through getSupportedBeautyRange.

Error codes

For details about the error codes, see Camera Error Codes.

ID	Error Message
7400103	Session not config.

Example

function setBeauty(captureSession: camera.CaptureSession): void {
  let beautyTypes: Array<camera.BeautyType> = captureSession.getSupportedBeautyTypes();
  if (beautyTypes === undefined || beautyTypes.length <= 0) {
    return;
  }
  let beautyLevels: Array<number> = captureSession.getSupportedBeautyRange(beautyTypes[0]);
  if (beautyLevels === undefined || beautyLevels.length <= 0) {
    return;
  }
  captureSession.setBeauty(beautyTypes[0], beautyLevels[0]);
}

getBeauty^(deprecated)

getBeauty(type: BeautyType): number

Obtains the level of the beauty type in use.

NOTE This API is supported since API version 10 and deprecated since API version 11. You are advised to use Beauty.getBeauty instead.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	BeautyType	Yes	Beauty type.

Return value

Name	Type	Mandatory	Description
value	number	Yes	Beauty level.

Error codes

For details about the error codes, see Camera Error Codes.

ID	Error Message
7400103	Session not config.

Example

function getBeauty(captureSession: camera.CaptureSession): number {
  const invalidValue: number = -1;
  let beautyTypes: Array<camera.BeautyType> = captureSession.getSupportedBeautyTypes();
  if (beautyTypes === undefined || beautyTypes.length <= 0) {
    return invalidValue;
  }
  let beautyLevels: Array<number> = captureSession.getSupportedBeautyRange(beautyTypes[0]);
  if (beautyLevels === undefined || beautyLevels.length <= 0) {
    return invalidValue;
  }
  captureSession.setBeauty(beautyTypes[0], beautyLevels[0]);
  let beautyLevel: number = captureSession.getBeauty(beautyTypes[0]);
  return beautyLevel;
}

PhotoSessionForSys¹¹⁺

PhotoSessionForSys extends PhotoSession, Beauty, ColorEffect, ColorManagement, Macro, SceneDetection, EffectSuggestion, DepthFusion

Implements a photo session for system applications, which sets the parameters of the normal photo mode and saves all CameraInput and CameraOutput instances required to run the camera. It inherits from Session.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

PhotoSession¹¹⁺

PhotoSession extends Session, Flash, AutoExposure, Focus, Zoom, ColorManagement

Implements a photo session, which sets the parameters of the normal photo mode and saves all CameraInput and CameraOutput instances required to run the camera. It inherits from Session.

on('featureDetection')¹²⁺

on(type: 'featureDetection', featureType: SceneFeatureType, callback: AsyncCallback<SceneFeatureDetectionResult>): void

Subscribe to scene feature detection status change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'featureDetection'. The event can be listened for when a photo session is created.
featureType	SceneFeatureType	Yes	Scene feature type.
callback	AsyncCallback<SceneFeatureDetectionResult>	Yes	Callback used to return the status of the scene feature detection.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, result: camera.SceneFeatureDetectionResult): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`feature type: ${result.featureType}`);
  console.info(`feature status: ${result.detected}`);
}

function registerFeatureDetectionStatus(photoSession: camera.PhotoSession, featureType: camera.SceneFeatureType): void {
  photoSession.on('featureDetection', featureType, callback);
}

off('featureDetection')¹²⁺

off(type: 'featureDetection', featureType: SceneFeatureType, callback?: AsyncCallback<SceneFeatureDetectionResult>): void

Unsubscribe from camera feature detection status change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'featureDetection'. The event can be listened for when a session is created.
featureType	SceneFeatureType	Yes	Scene feature type.
callback	AsyncCallback<SceneFeatureDetectionResult>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('featureDetection') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterFeatureDetectionStatus(photoSession: camera.PhotoSession, featureType: camera.SceneFeatureType): void {
  photoSession.off('featureDetection', featureType);
}

on('lcdFlashStatus')¹³⁺

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

Subscribes to LCD flash status change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'lcdFlashStatus'. The event can be listened for when a session is created.
callback	AsyncCallback<LcdFlashStatus>	Yes	Callback used to return the LCD flash status change.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, lcdFlashStatus: camera.LcdFlashStatus): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`isLcdFlashNeeded: ${lcdFlashStatus.isLcdFlashNeeded}`);
  console.info(`lcdCompensation: ${lcdFlashStatus.lcdCompensation}`);
}

function registerLcdFlashStatus(photoSession: camera.PhotoSession): void {
  photoSession.on('lcdFlashStatus', callback);
}

off('lcdFlashStatus')¹³⁺

off(type: 'lcdFlashStatus', callback?: AsyncCallback<LcdFlashStatus>): void

Unsubscribes from LCD flash status change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'lcdFlashStatus'. The event can be listened for when a session is created.
callback	AsyncCallback<LcdFlashStatus>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('lcdFlashStatus') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterLcdFlashStatus(photoSession: camera.PhotoSession): void {
  photoSession.off('lcdFlashStatus');
}

FocusTrackingMode¹⁵⁺

Enumerates the focus tracking modes.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
AUTO	0	Automatic.

FocusTrackingInfo¹⁵⁺

Describes the focus tracking information, which is obtained by calling VideoSessionForSys.on('focusTrackingInfoAvailable').

System capability: SystemCapability.Multimedia.Camera.Core

Name	Type	Read-only	Optional	Description
trackingMode	FocusTrackingMode	No	No	Tracing mode.
trackingRegion	Rect	No	No	Tracking region.

LightStatus¹⁸⁺

Enumerates the camera light statuses, which are obtained by calling VideoSessionForSys.on('lightStatusChange').

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
NORMAL	0	Normal lighting conditions.
INSUFFICIENT	1	Insufficient lighting (too dark).

VideoSessionForSys¹¹⁺

VideoSessionForSys extends VideoSession, Beauty, ColorEffect, ColorManagement, Aperture, ColorReservation

Implements a video session for system applications, which sets the parameters of the normal video mode and saves all CameraInput and CameraOutput instances required to run the camera. It inherits from Session.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

VideoSession¹¹⁺

VideoSession extends Session, Flash, AutoExposure, Focus, Zoom, Stabilization, ColorManagement

Implements a video session, which sets the parameters of the normal video mode and saves all CameraInput and CameraOutput instances required to run the camera. It inherits from Session.

on('lcdFlashStatus')¹³⁺

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

Subscribes to LCD flash status change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'lcdFlashStatus'. The event can be listened for when a session is created.
callback	AsyncCallback<LcdFlashStatus>	Yes	Callback used to return the LCD flash status change.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, lcdFlashStatus: camera.LcdFlashStatus): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`isLcdFlashNeeded: ${lcdFlashStatus.isLcdFlashNeeded}`);
  console.info(`lcdCompensation: ${lcdFlashStatus.lcdCompensation}`);
}

function registerLcdFlashStatus(videoSession: camera.VideoSession): void {
  videoSession.on('lcdFlashStatus', callback);
}

off('lcdFlashStatus')¹³⁺

off(type: 'lcdFlashStatus', callback?: AsyncCallback<LcdFlashStatus>): void

Unsubscribes from LCD flash status change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'lcdFlashStatus'. The event can be listened for when a session is created.
callback	AsyncCallback<LcdFlashStatus>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('lcdFlashStatus') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterLcdFlashStatus(videoSession: camera.VideoSession): void {
  videoSession.off('lcdFlashStatus');
}

on('focusTrackingInfoAvailable')¹⁵⁺

on(type: 'focusTrackingInfoAvailable', callback: Callback<FocusTrackingInfo>): void

Subscribes to focus tracking information events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusTrackingInfoAvailable'. The event can be listened for when a VideoSessionForSys object is created.
callback	Callback<FocusTrackingInfo>	Yes	Callback used to return the focus tracking information.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function callback(focusTrackingInfo: camera.FocusTrackingInfo): void {
  console.info(`Focus tracking mode: ${focusTrackingInfo.trackingMode}`);
  console.info(`Focus tracking Region: topLeftX ${focusTrackingInfo.trackingRegion.topLeftX}
                                       topLeftY ${focusTrackingInfo.trackingRegion.topLeftY}
                                       width ${focusTrackingInfo.trackingRegion.width}
                                       height ${focusTrackingInfo.trackingRegion.height}`);
}

function registerFocusTrackingInfoChanged(session: camera.VideoSessionForSys): void {
  session.on('focusTrackingInfoAvailable', callback);
}

off('focusTrackingInfoAvailable')¹⁵⁺

off(type: 'focusTrackingInfoAvailable', callback?: Callback<FocusTrackingInfo>): void

Unsubscribes from focus tracking information events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusTrackingInfoAvailable'. The event can be listened for when a VideoSessionForSys object is created.
callback	Callback<FocusTrackingInfo>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('focusTrackingInfoAvailable') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterFocusTrackingInfoChanged(session: camera.VideoSessionForSys): void {
  session.off('focusTrackingInfoAvailable');
}

on('lightStatusChange')¹⁸⁺

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

Subscribes to camera light status changes. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'lightStatusChange'. The event can be listened for when a VideoSessionForSys object is created.
callback	AsyncCallback<LightStatus>	Yes	Callback used to return the light status information.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function handleLightStatusCallback(err: BusinessError, lightStatus: camera.LightStatus) : void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`lightStatus: ${lightStatus}`);
}

function handleLightStatusOn(mSession: camera.VideoSessionForSys): void {
  console.info('handleLightStatusOn');
  try {
    mSession.on('lightStatusChange', handleLightStatusCallback);
  } catch (error) {
    let err = error as BusinessError;
    console.error(`handleLightStatusOn err:${err}`);
  }
}

off('lightStatusChange')¹⁸⁺

off(type: 'lightStatusChange', callback?: AsyncCallback<LightStatus>): void

Unsubscribes from camera light status changes.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'lightStatusChange'. The event can be listened for when a VideoSessionForSys object is created.
callback	AsyncCallback<LightStatus>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('lightStatusChange') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function LightStatusCallback(err: BusinessError, lightStatus: camera.LightStatus) : void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`lightStatus: ${lightStatus}`);
}

function handleLightStatusOff(mSession: camera.VideoSessionForSys): void {
  console.info('handleLightStatusOff');
  try {
    mSession.on('lightStatusChange', LightStatusCallback);
  } catch (error) {
    let err = error as BusinessError;
    console.error(`handleLightStatusOff err:${err}`);
  }
}

PortraitPhotoSession¹¹⁺

PortraitPhotoSession extends Session, Flash, AutoExposure, Focus, Zoom, Beauty, ColorEffect, ColorManagement, Portrait, Aperture

Implements a portrait photo session, which sets the parameters of the portrait photo mode and saves all CameraInput and CameraOutput instances required to run the camera. It inherits from Session.

on('error')¹¹⁺

on(type: 'error', callback: ErrorCallback): void

Subscribes to PortraitSession error events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created. This event is triggered and the error message is returned when an error occurs during the calling of a session-related API such as beginConfig, commitConfig, and addInput.
callback	ErrorCallback	Yes	Callback used to return an error code defined in CameraErrorCode.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError): void {
  console.error(`Portrait photo session error code: ${err.code}`);
}

function registerSessionError(portraitPhotoSession: camera.PortraitPhotoSession): void {
  portraitPhotoSession.on('error', callback);
}

off('error')¹¹⁺

off(type: 'error', callback?: ErrorCallback): void

Unsubscribes from PortraitSession error events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created.
callback	ErrorCallback	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('error') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Example

function unregisterSessionError(portraitPhotoSession: camera.PortraitPhotoSession): void {
  portraitPhotoSession.off('error');
}

on('focusStateChange')¹¹⁺

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

Subscribes to focus state change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created. This event is triggered only when the camera focus state changes in auto focus mode.
callback	AsyncCallback<FocusState>	Yes	Callback used to return the focus state change.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, focusState: camera.FocusState): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`Focus state: ${focusState}`);
}

function registerFocusStateChange(portraitPhotoSession: camera.PortraitPhotoSession): void {
  portraitPhotoSession.on('focusStateChange', callback);
}

off('focusStateChange')¹¹⁺

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

Unsubscribes from focus state change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created.
callback	AsyncCallback<FocusState>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('focusStateChange') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Example

function unregisterFocusStateChange(portraitPhotoSession: camera.PortraitPhotoSession): void {
  portraitPhotoSession.off('focusStateChange');
}

on('smoothZoomInfoAvailable')¹¹⁺

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

Subscribes to smooth zoom state change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'smoothZoomInfoAvailable'. The event can be listened for when a session is created.
callback	AsyncCallback<SmoothZoomInfo>	Yes	Callback used to return the smooth zoom state change.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, smoothZoomInfo: camera.SmoothZoomInfo): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`The duration of smooth zoom: ${smoothZoomInfo.duration}`);
}

function registerSmoothZoomInfo(portraitPhotoSession: camera.PortraitPhotoSession): void {
  portraitPhotoSession.on('smoothZoomInfoAvailable', callback);
}

off('smoothZoomInfoAvailable')¹¹⁺

off(type: 'smoothZoomInfoAvailable', callback?: AsyncCallback<SmoothZoomInfo>): void

Unsubscribes from smooth zoom state change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'smoothZoomInfoAvailable'. The event can be listened for when a session is created.
callback	AsyncCallback<SmoothZoomInfo>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('smoothZoomInfoAvailable') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Example

function unregisterSmoothZoomInfo(portraitPhotoSession: camera.PortraitPhotoSession): void {
  portraitPhotoSession.off('smoothZoomInfoAvailable');
}

on('lcdFlashStatus')¹³⁺

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

Subscribes to LCD flash status change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'lcdFlashStatus'. The event can be listened for when a session is created.
callback	AsyncCallback<LcdFlashStatus>	Yes	Callback used to return the LCD flash status change.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, lcdFlashStatus: camera.LcdFlashStatus): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`isLcdFlashNeeded: ${lcdFlashStatus.isLcdFlashNeeded}`);
  console.info(`lcdCompensation: ${lcdFlashStatus.lcdCompensation}`);
}

function registerLcdFlashStatus(portraitPhotoSession: camera.PortraitPhotoSession): void {
  portraitPhotoSession.on('lcdFlashStatus', callback);
}

off('lcdFlashStatus')¹³⁺

off(type: 'lcdFlashStatus', callback?: AsyncCallback<LcdFlashStatus>): void

Unsubscribes from LCD flash status change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'lcdFlashStatus'. The event can be listened for when a session is created.
callback	AsyncCallback<LcdFlashStatus>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('lcdFlashStatus') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterLcdFlashStatus(portraitPhotoSession: camera.PortraitPhotoSession): void {
  portraitPhotoSession.off('lcdFlashStatus');
}

NightPhotoSession¹¹⁺

NightPhotoSession extends Session, Flash, AutoExposure, Focus, Zoom, ColorEffect, ColorManagement, ManualExposure

Implements a night photo session, which sets the parameters of the night photo mode and saves all CameraInput, CameraOutput, and PhotoOutput instances required to run the camera. It inherits from Session.

For night photo capture scenarios, you must listen for the onCaptureEnd event to mark the end of the photo capture session.

on('error')¹¹⁺

on(type: 'error', callback: ErrorCallback): void

Subscribes to NightSession error events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created. This event is triggered and the error message is returned when an error occurs during the calling of a session-related API such as beginConfig, commitConfig, and addInput.
callback	ErrorCallback	Yes	Callback used to return an error code defined in CameraErrorCode.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError): void {
  console.error(`Night photo session error code: ${err.code}`);
}

function registerSessionError(nightPhotoSession: camera.NightPhotoSession): void {
  nightPhotoSession.on('error', callback);
}

off('error')¹¹⁺

off(type: 'error', callback?: ErrorCallback): void

Unsubscribes from NightSession error events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created.
callback	ErrorCallback	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('error') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Example

function unregisterSessionError(nightPhotoSession: camera.NightPhotoSession): void {
  nightPhotoSession.off('error');
}

on('focusStateChange')¹¹⁺

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

Subscribes to focus state change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created. This event is triggered only when the camera focus state changes in auto focus mode.
callback	AsyncCallback<FocusState>	Yes	Callback used to return the focus state change.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, focusState: camera.FocusState): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`Focus state: ${focusState}`);
}

function registerFocusStateChange(nightPhotoSession: camera.NightPhotoSession): void {
  nightPhotoSession.on('focusStateChange', callback);
}

off('focusStateChange')¹¹⁺

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

Unsubscribes from focus state change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created.
callback	AsyncCallback<FocusState>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('focusStateChange') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Example

function unregisterFocusStateChange(nightPhotoSession: camera.NightPhotoSession): void {
  nightPhotoSession.off('focusStateChange');
}

on('smoothZoomInfoAvailable')¹¹⁺

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

Subscribes to smooth zoom state change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'smoothZoomInfoAvailable'. The event can be listened for when a session is created.
callback	AsyncCallback<SmoothZoomInfo>	Yes	Callback used to return the smooth zoom state change.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, smoothZoomInfo: camera.SmoothZoomInfo): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`The duration of smooth zoom: ${smoothZoomInfo.duration}`);
}

function registerSmoothZoomInfo(nightPhotoSession: camera.NightPhotoSession): void {
  nightPhotoSession.on('smoothZoomInfoAvailable', callback);
}

off('smoothZoomInfoAvailable')¹¹⁺

off(type: 'smoothZoomInfoAvailable', callback?: AsyncCallback<SmoothZoomInfo>): void

Unsubscribes from smooth zoom state change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'smoothZoomInfoAvailable'. The event can be listened for when a session is created.
callback	AsyncCallback<SmoothZoomInfo>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('smoothZoomInfoAvailable') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Example

function unregisterSmoothZoomInfo(nightPhotoSession: camera.NightPhotoSession): void {
  nightPhotoSession.off('smoothZoomInfoAvailable');
}

on('lcdFlashStatus')¹²⁺

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

Subscribes to LCD flash status change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'lcdFlashStatus'. The event can be listened for when a session is created.
callback	AsyncCallback<LcdFlashStatus>	Yes	Callback used to return the LCD flash status change.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, lcdFlashStatus: camera.LcdFlashStatus): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`lcdFlashStatus: ${lcdFlashStatus}`);
}

function registerLcdFlashStatus(nightPhotoSession: camera.NightPhotoSession): void {
  nightPhotoSession.on('lcdFlashStatus', callback);
}

off('lcdFlashStatus')¹²⁺

off(type: 'lcdFlashStatus', callback?: AsyncCallback<LcdFlashStatus>): void

Unsubscribes from LCD flash status change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'lcdFlashStatus'. The event can be listened for when a session is created.
callback	AsyncCallback<LcdFlashStatus>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('lcdFlashStatus') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterLcdFlashStatus(nightPhotoSession: camera.NightPhotoSession): void {
  nightPhotoSession.off('lcdFlashStatus');
}

HighResolutionPhotoSession¹²⁺

HighResolutionPhotoSession extends Session, AutoExposure, Focus

Implements a high-resolution photo session, which sets the parameters of the high-resolution photo mode and saves all CameraInput and CameraOutput instances required to run the camera. It inherits from Session.

NOTE

In high-resolution photo capture scenarios, the physical camera lens must be used instead of the logical lens.

on('error')¹²⁺

on(type: 'error', callback: ErrorCallback): void

Subscribes to HighResolutionPhotoSession error events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created. This event is triggered and the error message is returned when an error occurs during the calling of a session-related API such as beginConfig, commitConfig, and addInput.
callback	ErrorCallback	Yes	Callback used to return an error code defined in CameraErrorCode.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError): void {
  console.error(`High resolution photo session error code: ${err.code}`);
}

function registerSessionError(highResolutionPhotoSession: camera.HighResolutionPhotoSession): void {
  highResolutionPhotoSession.on('error', callback);
}

off('error')¹²⁺

off(type: 'error', callback?: ErrorCallback): void

Unsubscribes from HighResolutionPhotoSession error events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created.
callback	ErrorCallback	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('error') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterSessionError(highResolutionPhotoSession: camera.HighResolutionPhotoSession): void {
  highResolutionPhotoSession.off('error');
}

on('focusStateChange')¹²⁺

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

Subscribes to focus state change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created. This event is triggered only when the camera focus state changes in auto focus mode.
callback	AsyncCallback<FocusState>	Yes	Callback used to return the focus state change.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, focusState: camera.FocusState): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`Focus state: ${focusState}`);
}

function registerFocusStateChange(highResolutionPhotoSession: camera.HighResolutionPhotoSession): void {
  highResolutionPhotoSession.on('focusStateChange', callback);
}

off('focusStateChange')¹²⁺

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

Unsubscribes from focus state change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created.
callback	AsyncCallback<FocusState>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('focusStateChange') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Example

function unregisterFocusStateChange(highResolutionPhotoSession: camera.HighResolutionPhotoSession): void {
  highResolutionPhotoSession.off('focusStateChange');
}

SketchStatusData¹¹⁺

Defines the PiP status data.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Type	Read-only	Optional	Description
status	number	No	No	Status of PiP. The options are 0 (stopped), 1 (started), 2 (stopping), and 3 (starting).
sketchRatio	number	No	No	Zoom ratio of PiP.
centerPointOffset²⁰⁺	Point	No	No	Offset of PiP.

SlowMotionVideoSession¹²⁺

SlowMotionVideoSession extends Session, Flash, AutoExposure, Focus, Zoom, ColorEffect

Implements a slow-motion video session, which sets the parameters of the slow-motion video mode and saves all CameraInput and CameraOutput instances required to run the camera. It inherits from Session.

NOTE In slow-motion video mode, only preview streams and video streams can be added.

on('error')¹²⁺

on(type: 'error', callback: ErrorCallback): void

Subscribes to SlowMotionVideoSession error events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created. This event is triggered and the error message is returned when an error occurs during the calling of a session-related API such as beginConfig, commitConfig, and addInput.
callback	ErrorCallback	Yes	Callback used to return an error code defined in CameraErrorCode.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError): void {
  console.error(`Portrait photo session error code: ${err.code}`);
}

function registerSessionError(slowMotionVideoSession: camera.SlowMotionVideoSession): void {
  slowMotionVideoSession.on('error', callback);
}

off('error')¹²⁺

off(type: 'error', callback?: ErrorCallback): void

Unsubscribes from SlowMotionVideoSession error events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created.
callback	ErrorCallback	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('error') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterSessionError(slowMotionVideoSession: camera.SlowMotionVideoSession): void {
  slowMotionVideoSession.off('error');
}

on('focusStateChange')¹²⁺

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

Subscribes to focus state change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created. This event is triggered only when the camera focus state changes in auto focus mode.
callback	AsyncCallback<FocusState>	Yes	Callback used to return the focus state change.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, focusState: camera.FocusState): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`Focus state: ${focusState}`);
}

function registerFocusStateChange(slowMotionVideoSession: camera.SlowMotionVideoSession): void {
  slowMotionVideoSession.on('focusStateChange', callback);
}

off('focusStateChange')¹²⁺

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

Unsubscribes from focus state change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created.
callback	AsyncCallback<FocusState>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('focusStateChange') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterFocusStateChange(slowMotionVideoSession: camera.SlowMotionVideoSession): void {
  slowMotionVideoSession.off('focusStateChange');
}

on('smoothZoomInfoAvailable')¹²⁺

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

Subscribes to smooth zoom state change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'smoothZoomInfoAvailable'. The event can be listened for when a session is created.
callback	AsyncCallback<SmoothZoomInfo>	Yes	Callback used to return the smooth zoom state change.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, smoothZoomInfo: camera.SmoothZoomInfo): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`The duration of smooth zoom: ${smoothZoomInfo.duration}`);
}

function registerSmoothZoomInfo(slowMotionVideoSession: camera.SlowMotionVideoSession): void {
  slowMotionVideoSession.on('smoothZoomInfoAvailable', callback);
}

off('smoothZoomInfoAvailable')¹²⁺

off(type: 'smoothZoomInfoAvailable', callback?: AsyncCallback<SmoothZoomInfo>): void

Unsubscribes from smooth zoom state change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'smoothZoomInfoAvailable'. The event can be listened for when a session is created.
callback	AsyncCallback<SmoothZoomInfo>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('smoothZoomInfoAvailable') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterSmoothZoomInfo(slowMotionVideoSession: camera.SlowMotionVideoSession): void {
  slowMotionVideoSession.off('smoothZoomInfoAvailable');
}

on('slowMotionStatus')¹²⁺

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

Subscribes to slow-motion status change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'slowMotionStatus'. The event can be listened for when a session is created.
callback	AsyncCallback<SlowMotionStatus>	Yes	Callback used to return the slow-motion status change.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, slowMotionStatus: camera.SlowMotionStatus): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`The slow motion status: ${slowMotionStatus}`);
}

function registerSlowMotionStatus(slowMotionVideoSession: camera.SlowMotionVideoSession): void {
  slowMotionVideoSession.on('slowMotionStatus', callback);
}

off('slowMotionStatus')¹²⁺

off(type: 'slowMotionStatus', callback?: AsyncCallback<SlowMotionStatus>): void

Unsubscribes from slow-motion status change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'slowMotionStatus'. The event can be listened for when a session is created.
callback	AsyncCallback<SlowMotionStatus>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('slowMotionStatus') with the specified callback is canceled. (The callback object cannot be an anonymous function.) If the operation fails, an error code defined in CameraErrorCode is returned.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterSlowMotionStatus(slowMotionVideoSession: camera.SlowMotionVideoSession): void {
  slowMotionVideoSession.off('slowMotionStatus');
}

isSlowMotionDetectionSupported¹²⁺

isSlowMotionDetectionSupported(): boolean

Checks whether the device supports slow-motion detection.

NOTE This API must be called after commitConfig is called.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
boolean	Check result for the support of slow-motion detection. true if supported, false otherwise. If the operation fails, an error code defined in CameraErrorCode is returned.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function isSlowMotionDetectionSupported(slowMotionVideoSession: camera.SlowMotionVideoSession): boolean {
  let isSupported: boolean = false;
  try {
    isSupported = slowMotionVideoSession.isSlowMotionDetectionSupported();
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The isFocusModeSupported call failed. error code: ${err.code}`);
  }
  return isSupported;
}

setSlowMotionDetectionArea¹²⁺

setSlowMotionDetectionArea(area: Rect): void

Sets an area for slow-motion detection.

NOTE Before the setting, call isSlowMotionDetectionSupported to check whether the device supports slow-motion detection. This API must be called after commitConfig is called.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
area	Rect	Yes	Area.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function setSlowMotionDetectionArea(slowMotionVideoSession: camera.SlowMotionVideoSession): void {
  try {
    slowMotionVideoSession.setSlowMotionDetectionArea({topLeftX: 0.1, topLeftY: 0.1, width: 0.8, height: 0.8});
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The setSlowMotionDetectionArea call failed. error code: ${err.code}`);
  }
}

PanoramaPhotoSession¹²⁺

PanoramaPhotoSession extends Session, Focus, AutoExposure, WhiteBalance, ColorEffect

Implements a panoramic photo session, which sets the parameters of the panoramic photo mode and saves all CameraInput and CameraOutput instances required to run the camera. It inherits from Session.

on('error')¹²⁺

on(type: 'error', callback: ErrorCallback): void

Subscribes to PanoramaPhotoSession error events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created. This event is triggered and the error message is returned when an error occurs during the calling of a session-related API such as beginConfig, commitConfig, and addInput.
callback	ErrorCallback	Yes	Callback used to return an error code defined in CameraErrorCode.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError): void {
  console.error(`Panorama photo session error code: ${err.code}`);
}

function registerSessionError(panoramaPhotoSession: camera.PanoramaPhotoSession): void {
  panoramaPhotoSession.on('error', callback);
}

off('error')¹²⁺

off(type: 'error', callback?: ErrorCallback): void

Unsubscribes from PanoramaPhotoSession error events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created.
callback	ErrorCallback	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('error') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Example

function unregisterSessionError(panoramaPhotoSession: camera.PanoramaPhotoSession): void {
  panoramaPhotoSession.off('error');
}

on('focusStateChange')¹²⁺

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

Subscribes to focus state change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created. This event is triggered only when the camera focus state changes in auto focus mode.
callback	AsyncCallback<FocusState>	Yes	Callback used to return the focus state change.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, focusState: camera.FocusState): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`Focus state: ${focusState}`);
}

function registerFocusStateChange(panoramaPhotoSession: camera.PanoramaPhotoSession): void {
  panoramaPhotoSession.on('focusStateChange', callback);
}

off('focusStateChange')¹²⁺

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

Unsubscribes from focus state change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created.
callback	AsyncCallback<FocusState>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('focusStateChange') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Example

function unregisterFocusStateChange(panoramaPhotoSession: camera.PanoramaPhotoSession): void {
  panoramaPhotoSession.off('focusStateChange');
}

IsoInfo¹²⁺

Describes the ISO information.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Type	Read-only	Optional	Description
iso	number	Yes	Yes	ISO.

ApertureInfo¹²⁺

Describes the aperture information.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Type	Read-only	Optional	Description
aperture	number	Yes	Yes	Aperture.

LuminationInfo¹²⁺

Describes the illumination information.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Type	Read-only	Optional	Description
lumination	number	Yes	Yes	Illumination. The value range is [0, 1].

CameraFormat

Enumerates the camera output formats.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
CAMERA_FORMAT_DNG_XDRAW¹⁸⁺	5	Enhanced raw image in DNG format, where JPG and raw images are packaged in the same file, and up to 16-bit raw data is supported. System API: This is a system API.

ExposureMeteringMode¹²⁺

Enumerates the exposure metering modes.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
CENTER_HIGHLIGHT_WEIGHTED	3	Center-weighted and highlight metering mode. This mode focuses on the highlight area near the center of the screen.

FocusRangeType¹⁵⁺

Enumerates the focus range types.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
AUTO	0	Auto focus.
NEAR	1	Focus on near objects.

FocusDrivenType¹⁵⁺

Enumerates the focus drive types.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
AUTO	0	Automatic.
FACE	1	Face-driven.

FocusQuery¹²⁺

Provides the API to check whether the focus assist is supported.

isFocusAssistSupported¹²⁺

isFocusAssistSupported(): boolean

Checks whether the focus assist is supported.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
boolean	Check result for the support of the focus assist. true if supported, false otherwise. If the operation fails, an error code defined in CameraErrorCode is returned.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
7400103	Session not config, only throw in session usage.
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function isFocusAssistSupported(professionalPhotoSession: camera.ProfessionalPhotoSession): boolean {
  let status: boolean = false;
  try {
    status = professionalPhotoSession.isFocusAssistSupported();
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The isFocusAssistSupported call failed. error code: ${err.code}`);
  }
  return status;
}

isFocusRangeTypeSupported¹⁵⁺

isFocusRangeTypeSupported(type: FocusRangeType): boolean

Checks whether a focus range type is supported.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	FocusRangeType	Yes	Focus range type.

Return value

Type	Description
boolean	Check result for the support of the focus range type. true if supported, false otherwise. If the operation fails, an error code defined in CameraErrorCode is returned.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.
7400103	Session not config, only throw in session usage.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function isFocusRangeTypeSupported(session: camera.VideoSessionForSys, type: camera.FocusRangeType): boolean {
  let status: boolean = false;
  try {
    status = session.isFocusRangeTypeSupported(type);
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The isFocusRangeTypeSupported call failed. error code: ${err.code}`);
  }
  return status;
}

isFocusDrivenTypeSupported¹⁵⁺

isFocusDrivenTypeSupported(type: FocusDrivenType): boolean

Checks whether a focus drive type is supported.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	FocusDrivenType	Yes	Focus drive type.

Return value

Type	Description
boolean	Check result for the support of the focus drive type. true if supported, false otherwise. If the operation fails, an error code defined in CameraErrorCode is returned.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.
7400103	Session not config, only throw in session usage.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function isFocusDrivenTypeSupported(session: camera.VideoSessionForSys, type: camera.FocusDrivenType): boolean {
  let status: boolean = false;
  try {
    status = session.isFocusDrivenTypeSupported(type);
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The isFocusDrivenTypeSupported call failed. error code: ${err.code}`);
  }
  return status;
}

Focus

Focus extends FocusQuery

Provides APIs to obtain and set the camera focus mode and focus position.

setFocusAssist¹²⁺

setFocusAssist(enabled: boolean): void

Sets the focus assist. Before the setting, call isFocusAssistSupported to check whether the device supports the focus assist.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
enabled	boolean	Yes	Whether to enable or disable focus assist. true to enable, false otherwise.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400101	Parameter missing or parameter type incorrect.
7400103	Session not config.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function setFocusAssist(professionalPhotoSession: camera.ProfessionalPhotoSession): void {
  try {
    professionalPhotoSession.setFocusAssist(false);
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The setFocusAssist call failed. error code: ${err.code}`);
  }
}

getFocusAssist¹²⁺

getFocusAssist(): boolean

Checks whether the focus assist is enabled.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
boolean	Check result for whether the focus assist is enabled. true if enabled, false otherwise.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
7400103	Session not config.
202	Not System Application.

Example

function getFocusAssist(professionalPhotoSession: camera.ProfessionalPhotoSession): boolean {
  let isFocusAssistOpened: boolean = false;
  try {
    isFocusAssistOpened = professionalPhotoSession.getFocusAssist();
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The getFocusAssist call failed. error code: ${err.code}`);
  }
  return isFocusAssistOpened;
}

setFocusRange¹⁵⁺

setFocusRange(type: FocusRangeType): void

Sets a focus range type. Before the setting, call isFocusRangeTypeSupported to check whether the focus range type is supported.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	FocusRangeType	Yes	Focus range type.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3.Parameter verification failed.
7400102	Operation not allowed.
7400103	Session not config.
7400201	Camera service fatal error.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function setFocusRange(session: camera.VideoSessionForSys, type: camera.FocusRangeType): void {
  try {
    session.setFocusRange(type);
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The setFocusRange call failed. error code: ${err.code}`);
  }
}

getFocusRange¹⁵⁺

getFocusRange(): FocusRangeType

Obtains the focus range type in use.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
FocusRangeType	Focus range type.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function getFocusRange(session: camera.VideoSessionForSys): camera.FocusRangeType | undefined {
  let focusRangeType: camera.FocusRangeType | undefined = undefined;
  try {
    focusRangeType = session.getFocusRange();
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The getFocusRange call failed. error code: ${err.code}`);
  }
  return focusRangeType;
}

setFocusDriven¹⁵⁺

setFocusDriven(type: FocusDrivenType): void

Sets a focus drive type. Before the setting, call isFocusDrivenTypeSupported to check whether the focus drive type is supported.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	FocusDrivenType	Yes	Focus drive type.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3.Parameter verification failed.
7400102	Operation not allowed.
7400103	Session not config.
7400201	Camera service fatal error.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function setFocusDriven(session: camera.VideoSessionForSys, type: camera.FocusDrivenType): void {
  try {
    session.setFocusDriven(type);
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The setFocusDriven call failed. error code: ${err.code}`);
  }
}

getFocusDriven¹⁵⁺

getFocusDriven(): FocusDrivenType

Obtains the focus drive type in use.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
FocusDrivenType	Focus drive type.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function getFocusDriven(session: camera.VideoSessionForSys): camera.FocusDrivenType | undefined {
  let focusDrivenType: camera.FocusDrivenType | undefined = undefined;
  try {
    focusDrivenType = session.getFocusDriven();
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The getFocusDriven call failed. error code: ${err.code}`);
  }
  return focusDrivenType;
}

ManualIsoQuery¹²⁺

Provides APIs to check whether a camera device supports manual ISO setting and obtain the ISO range supported by the device.

isManualIsoSupported¹²⁺

isManualIsoSupported(): boolean

Checks whether manual ISO setting is supported.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
boolean	Check result for the support of manual ISO setting. true if supported, false otherwise. If the operation fails, an error code defined in CameraErrorCode is returned.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
7400103	Session not config, only throw in session usage.
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function isManualIsoSupported(professionalPhotoSession: camera.ProfessionalPhotoSession): boolean {
  let status: boolean = false;
  try {
    status = professionalPhotoSession.isManualIsoSupported();
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The isManualIsoSupported call failed. error code: ${err.code}`);
  }
  return status;
}

getIsoRange¹²⁺

getIsoRange(): Array<number>

Obtains the supported ISO range.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
Array<number>	ISO range. The value range is [50, 100, ..., 6400]. The actual value depends on the bottom-layer capability. If the operation fails, an error code defined in CameraErrorCode is returned.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config, only throw in session usage.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function getIsoRange(professionalPhotoSession: camera.ProfessionalPhotoSession): Array<number> {
  let isoRange: Array<number> = [];
  try {
    isoRange = professionalPhotoSession.getIsoRange();
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The getIsoRange call failed. error code: ${err.code}`);
  }
  return isoRange;
}

ProfessionalPhotoSession¹²⁺

ProfessionalPhotoSession extends Session, AutoExposure, ManualExposure, Focus, ManualFocus, WhiteBalance, ManualIso, Flash, Zoom, ColorEffect, Aperture

Implements a professional photo session, which sets the parameters of the professional photo mode and saves all CameraInput and CameraOutput instances required to run the camera. It inherits from Session.

on('error')¹²⁺

on(type: 'error', callback: ErrorCallback): void

Subscribes to ProfessionalPhotoSession error events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created. This event is triggered and the error message is returned when an error occurs during the calling of a session-related API such as beginConfig, commitConfig, and addInput.
callback	ErrorCallback	Yes	Callback used to return an error code defined in CameraErrorCode.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError): void {
  console.error(`Professional photo session error code: ${err.code}`);
}

function registerSessionError(professionalPhotoSession: camera.ProfessionalPhotoSession): void {
  professionalPhotoSession.on('error', callback);
}

off('error')¹²⁺

off(type: 'error', callback?: ErrorCallback): void

Unsubscribes from ProfessionalPhotoSession error events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created.
callback	ErrorCallback	No	Callback, which is optional. If a callback function is passed in, it is an anonymous function.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterSessionError(professionalPhotoSession: camera.ProfessionalPhotoSession): void {
  professionalPhotoSession.off('error');
}

on('focusStateChange')¹²⁺

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

Subscribes to focus state change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created. This event is triggered only when the camera focus state changes in auto focus mode.
callback	AsyncCallback<FocusState>	Yes	Callback used to return the focus state change.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, focusState: camera.FocusState): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`Focus state: ${focusState}`);
}

function registerFocusStateChange(professionalPhotoSession: camera.ProfessionalPhotoSession): void {
  professionalPhotoSession.on('focusStateChange', callback);
}

off('focusStateChange')¹²⁺

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

Unsubscribes from focus state change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created.
callback	AsyncCallback<FocusState>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('focusStateChange') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterFocusStateChange(professionalPhotoSession: camera.ProfessionalPhotoSession): void {
  professionalPhotoSession.off('focusStateChange');
}

on('smoothZoomInfoAvailable')¹²⁺

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

Subscribes to smooth zoom state change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'smoothZoomInfoAvailable'. The event can be listened for when a session is created.
callback	AsyncCallback<SmoothZoomInfo>	Yes	Callback used to return the smooth zoom state change.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, smoothZoomInfo: camera.SmoothZoomInfo): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`The duration of smooth zoom: ${smoothZoomInfo.duration}`);
}

function registerSmoothZoomInfo(professionalPhotoSession: camera.ProfessionalPhotoSession): void {
  professionalPhotoSession.on('smoothZoomInfoAvailable', callback);
}

off('smoothZoomInfoAvailable')¹²⁺

off(type: 'smoothZoomInfoAvailable', callback?: AsyncCallback<SmoothZoomInfo>): void

Unsubscribes from smooth zoom state change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'smoothZoomInfoAvailable'. The event can be listened for when a session is created.
callback	AsyncCallback<SmoothZoomInfo>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('smoothZoomInfoAvailable') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterSmoothZoomInfo(professionalPhotoSession: camera.ProfessionalPhotoSession): void {
  professionalPhotoSession.off('smoothZoomInfoAvailable');
}

on('isoInfoChange')¹²⁺

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

Subscribes to automatic ISO change events to obtain real-time ISO information. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'isoInfoChange'.
callback	AsyncCallback<IsoInfo>	Yes	Callback used to return the ISO information.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function isoInfoCallback(err: BusinessError, info: camera.IsoInfo): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`ISO value: ${info.iso}`);
}

function registerIsoInfoEvent(professionalPhotoSession: camera.ProfessionalPhotoSession): void {
  professionalPhotoSession.on('isoInfoChange', isoInfoCallback);
}

off('isoInfoChange')¹²⁺

off(type: 'isoInfoChange', callback?: AsyncCallback<IsoInfo>): void

Unsubscribes from automatic ISO change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'isoInfoChange'.
callback	AsyncCallback<IsoInfo>	No	Callback, which is optional and is used to match callback in on('isoInfoChange').

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterIsoInfoEvent(professionalPhotoSession: camera.ProfessionalPhotoSession): void {
  professionalPhotoSession.off('isoInfoChange');
}

on('exposureInfoChange')¹²⁺

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

Subscribes to exposure information change events to obtain the exposure information. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'exposureInfoChange'.
callback	AsyncCallback<ExposureInfo>	Yes	Callback used to return the exposure information.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function exposureInfoCallback(err: BusinessError, info: camera.ExposureInfo): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`exposureTimeValue: ${info.exposureTime}`);
}

function registerExposureInfoEvent(professionalPhotoSession: camera.ProfessionalPhotoSession): void {
  professionalPhotoSession.on('exposureInfoChange', exposureInfoCallback);
}

off('exposureInfoChange')¹²⁺

off(type: 'exposureInfoChange', callback?: AsyncCallback<ExposureInfo>): void

Unsubscribes from exposure information change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'exposureInfoChange'.
callback	AsyncCallback<ExposureInfo>	No	Callback, which is optional and is used to match callback in on('exposureInfoChange').

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterExposureInfoEvent(professionalPhotoSession: camera.ProfessionalPhotoSession): void {
  professionalPhotoSession.off('exposureInfoChange');
}

on('apertureInfoChange')¹²⁺

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

Subscribes to aperture change events to obtain the real-time aperture information. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'apertureInfoChange'.
callback	AsyncCallback<ApertureInfo>	Yes	Callback used to return the aperture information.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function apertureInfoCallback(err: BusinessError, info: camera.ApertureInfo): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`Aperture value: ${info.aperture}`);
}

function registerApertureInfoEvent(professionalPhotoSession: camera.ProfessionalPhotoSession): void {
  professionalPhotoSession.on('apertureInfoChange', apertureInfoCallback);
}

off('apertureInfoChange')¹²⁺

off(type: 'apertureInfoChange', callback?: AsyncCallback<ApertureInfo>): void

Unsubscribes from aperture change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'apertureInfoChange'.
callback	AsyncCallback<ApertureInfo>	No	Callback, which is optional and is used to match callback in on('apertureInfoChange').

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterApertureInfoEvent(professionalPhotoSession: camera.ProfessionalPhotoSession): void {
  professionalPhotoSession.off('apertureInfoChange');
}

on('luminationInfoChange')¹²⁺

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

Subscribes to illumination change events to obtain real-time illumination information. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'luminationInfoChange'.
callback	AsyncCallback<LuminationInfo>	Yes	Callback used to return the illumination information.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function luminationInfoCallback(err: BusinessError, info: camera.LuminationInfo): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`Lumination: ${info.lumination}`);
}

function registerLuminationInfoEvent(professionalPhotoSession: camera.ProfessionalPhotoSession): void {
  professionalPhotoSession.on('luminationInfoChange', luminationInfoCallback);
}

off('luminationInfoChange')¹²⁺

off(type: 'luminationInfoChange', callback?: AsyncCallback<LuminationInfo>): void

Unsubscribes from illumination change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'luminationInfoChange'.
callback	AsyncCallback<LuminationInfo>	No	Callback, which is optional and is used to match callback in on('luminationInfoChange').

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterLuminationInfoEvent(professionalPhotoSession: camera.ProfessionalPhotoSession): void {
  professionalPhotoSession.off('luminationInfoChange');
}

ProfessionalVideoSession¹²⁺

ProfessionalVideoSession extends Session, AutoExposure, ManualExposure, Focus, ManualFocus, WhiteBalance, ManualIso, Flash, Zoom, ColorEffect, Aperture

Implements a professional video session, which sets the parameters of the professional video mode and saves all CameraInput and CameraOutput instances required to run the camera. It inherits from Session.

on('error')¹²⁺

on(type: 'error', callback: ErrorCallback): void

Subscribes to ProfessionalVideo error events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created. This event is triggered and the error message is returned when an error occurs during the calling of a session-related API such as beginConfig, commitConfig, and addInput.
callback	ErrorCallback	Yes	Callback used to return an error code defined in CameraErrorCode.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError): void {
  console.error(`Professional video session error code: ${err.code}`);
}

function registerSessionError(professionalVideoSession: camera.ProfessionalVideoSession): void {
  professionalVideoSession.on('error', callback);
}

off('error')¹²⁺

off(type: 'error', callback?: ErrorCallback): void

Unsubscribes from ProfessionalVideo error events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created.
callback	ErrorCallback	No	Callback, which is optional. If a callback function is passed in, it is an anonymous function.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterSessionError(professionalVideoSession: camera.ProfessionalVideoSession): void {
  professionalVideoSession.off('error');
}

on('focusStateChange')¹²⁺

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

Subscribes to focus state change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created. This event is triggered only when the camera focus state changes in auto focus mode.
callback	AsyncCallback<FocusState>	Yes	Callback used to return the focus state change.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, focusState: camera.FocusState): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`Focus state: ${focusState}`);
}

function registerFocusStateChange(professionalVideoSession: camera.ProfessionalVideoSession): void {
  professionalVideoSession.on('focusStateChange', callback);
}

off('focusStateChange')¹²⁺

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

Unsubscribes from focus state change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created.
callback	AsyncCallback<FocusState>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('focusStateChange') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterFocusStateChange(professionalVideoSession: camera.ProfessionalVideoSession): void {
  professionalVideoSession.off('focusStateChange');
}

on('smoothZoomInfoAvailable')¹²⁺

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

Subscribes to smooth zoom state change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'smoothZoomInfoAvailable'. The event can be listened for when a session is created.
callback	AsyncCallback<SmoothZoomInfo>	Yes	Callback used to return the smooth zoom state change.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, smoothZoomInfo: camera.SmoothZoomInfo): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`The duration of smooth zoom: ${smoothZoomInfo.duration}`);
}

function registerSmoothZoomInfo(professionalVideoSession: camera.ProfessionalVideoSession): void {
  professionalVideoSession.on('smoothZoomInfoAvailable', callback);
}

off('smoothZoomInfoAvailable')¹²⁺

off(type: 'smoothZoomInfoAvailable', callback?: AsyncCallback<SmoothZoomInfo>): void

Unsubscribes from smooth zoom state change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'smoothZoomInfoAvailable'. The event can be listened for when a session is created.
callback	AsyncCallback<SmoothZoomInfo>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('smoothZoomInfoAvailable') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterSmoothZoomInfo(professionalVideoSession: camera.ProfessionalVideoSession): void {
  professionalVideoSession.off('smoothZoomInfoAvailable');
}

on('isoInfoChange')¹²⁺

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

Subscribes to automatic ISO change events to obtain real-time ISO information. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'isoInfoChange'.
callback	AsyncCallback<IsoInfo>	Yes	Callback used to return the ISO information.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function isoInfoCallback(err: BusinessError, info: camera.IsoInfo): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`ISO value: ${info.iso}`);
}

function registerIsoInfoEvent(professionalVideoSession: camera.ProfessionalVideoSession): void {
  professionalVideoSession.on('isoInfoChange', isoInfoCallback);
}

off('isoInfoChange')¹²⁺

off(type: 'isoInfoChange', callback?: AsyncCallback<IsoInfo>): void

Unsubscribes from automatic ISO change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'isoInfoChange'.
callback	AsyncCallback<IsoInfo>	No	Callback, which is optional and is used to match callback in on('isoInfoChange').

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterIsoInfoEvent(professionalVideoSession: camera.ProfessionalVideoSession): void {
  professionalVideoSession.off('isoInfoChange');
}

on('exposureInfoChange')¹²⁺

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

Subscribes to exposure information change events to obtain the exposure information. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'exposureInfoChange'.
callback	AsyncCallback<ExposureInfo>	Yes	Callback used to return the exposure information.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function exposureInfoCallback(err: BusinessError, info: camera.ExposureInfo): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`exposureTimeValue: ${info.exposureTime}`);
}

function registerExposureInfoEvent(professionalVideoSession: camera.ProfessionalVideoSession): void {
  professionalVideoSession.on('exposureInfoChange', exposureInfoCallback);
}

off('exposureInfoChange')¹²⁺

off(type: 'exposureInfoChange', callback?: AsyncCallback<ExposureInfo>): void

Unsubscribes from exposure information change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'exposureInfoChange'.
callback	AsyncCallback<ExposureInfo>	No	Callback, which is optional and is used to match callback in on('exposureInfoChange').

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterExposureInfoEvent(professionalVideoSession: camera.ProfessionalVideoSession): void {
  professionalVideoSession.off('exposureInfoChange');
}

on('apertureInfoChange')¹²⁺

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

Subscribes to aperture change events to obtain the aperture information. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'apertureInfoChange'.
callback	AsyncCallback<ApertureInfo>	Yes	Callback used to return the aperture information.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function apertureInfoCallback(err: BusinessError, info: camera.ApertureInfo): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`Aperture value: ${info.aperture}`);
}

function registerApertureInfoEvent(professionalVideoSession: camera.ProfessionalVideoSession): void {
  professionalVideoSession.on('apertureInfoChange', apertureInfoCallback);
}

off('apertureInfoChange')¹²⁺

off(type: 'apertureInfoChange', callback?: AsyncCallback<ApertureInfo>): void

Unsubscribes from aperture change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'apertureInfoChange'.
callback	AsyncCallback<ApertureInfo>	No	Callback, which is optional and is used to match callback in on('apertureInfoChange').

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterApertureInfoEvent(professionalVideoSession: camera.ProfessionalVideoSession): void {
  professionalVideoSession.off('apertureInfoChange');
}

on('luminationInfoChange')¹²⁺

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

Subscribes to illumination change events to obtain illumination information. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'luminationInfoChange'.
callback	AsyncCallback<LuminationInfo>	Yes	Callback used to return the illumination information.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function luminationInfoCallback(err: BusinessError, info: camera.LuminationInfo): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`Lumination: ${info.lumination}`);
}

function registerLuminationInfoEvent(professionalVideoSession: camera.ProfessionalVideoSession): void {
  professionalVideoSession.on('luminationInfoChange', luminationInfoCallback);
}

off('luminationInfoChange')¹²⁺

off(type: 'luminationInfoChange', callback?: AsyncCallback<LuminationInfo>): void

Unsubscribes from illumination change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'luminationInfoChange'.
callback	AsyncCallback<LuminationInfo>	No	Callback, which is optional and is used to match callback in on('luminationInfoChange').

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterLuminationInfoEvent(professionalVideoSession: camera.ProfessionalVideoSession): void {
  professionalVideoSession.off('luminationInfoChange');
}

MacroPhotoSession¹²⁺

MacroPhotoSession extends Session, Flash, AutoExposure, Focus, Zoom, ColorEffect, ManualFocus

Implements a macro photo session, which sets the parameters of the macro photo mode and saves all CameraInput and CameraOutput instances required to run the camera. It inherits from Session.

on('error')¹²⁺

on(type: 'error', callback: ErrorCallback): void

Subscribes to MacroPhotoSession error events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created. This event is triggered and the error message is returned when an error occurs during the calling of a session-related API such as beginConfig, commitConfig, and addInput.
callback	ErrorCallback	Yes	Callback used to return an error code defined in CameraErrorCode.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError): void {
  console.error(`MacroPhotoSession error code: ${err.code}`);
}

function registerSessionError(macroPhotoSession: camera.MacroPhotoSession): void {
  macroPhotoSession.on('error', callback);
}

off('error')¹²⁺

off(type: 'error', callback?: ErrorCallback): void

Unsubscribes from MacroPhotoSession error events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created.
callback	ErrorCallback	No	Callback used to return the result. If this parameter is specified, the subscription to the specified event with the specified callback is canceled. (The callback object cannot be an anonymous function.) Otherwise, the subscriptions to the specified event with all the callbacks are canceled.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterSessionError(macroPhotoSession: camera.MacroPhotoSession): void {
  macroPhotoSession.off('error');
}

on('focusStateChange')¹²⁺

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

Subscribes to focus state change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created. This event is triggered only when the camera focus state changes in auto focus mode.
callback	AsyncCallback<FocusState>	Yes	Callback used to return the focus state change.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, focusState: camera.FocusState): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`Focus state: ${focusState}`);
}

function registerFocusStateChange(macroPhotoSession: camera.MacroPhotoSession): void {
  macroPhotoSession.on('focusStateChange', callback);
}

off('focusStateChange')¹²⁺

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

Unsubscribes from focus state change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created.
callback	AsyncCallback<FocusState>	No	Callback used to return the result. If this parameter is specified, the subscription to the specified event with the specified callback is canceled. (The callback object cannot be an anonymous function.) Otherwise, the subscriptions to the specified event with all the callbacks are canceled.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterFocusStateChange(macroPhotoSession: camera.MacroPhotoSession): void {
  macroPhotoSession.off('focusStateChange');
}

on('smoothZoomInfoAvailable')¹²⁺

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

Subscribes to smooth zoom state change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'smoothZoomInfoAvailable'. The event can be listened for when a session is created.
callback	AsyncCallback<SmoothZoomInfo>	Yes	Callback used to return the smooth zoom state change.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, smoothZoomInfo: camera.SmoothZoomInfo): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`The duration of smooth zoom: ${smoothZoomInfo.duration}`);
}

function registerSmoothZoomInfo(macroPhotoSession: camera.MacroPhotoSession): void {
  macroPhotoSession.on('smoothZoomInfoAvailable', callback);
}

off('smoothZoomInfoAvailable')¹²⁺

off(type: 'smoothZoomInfoAvailable', callback?: AsyncCallback<SmoothZoomInfo>): void

Unsubscribes from smooth zoom state change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'smoothZoomInfoAvailable'. The event can be listened for when a session is created.
callback	AsyncCallback<SmoothZoomInfo>	No	Callback used to return the result. If this parameter is specified, the subscription to the specified event with the specified callback is canceled. (The callback object cannot be an anonymous function.) Otherwise, the subscriptions to the specified event with all the callbacks are canceled.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterSmoothZoomInfo(macroPhotoSession: camera.MacroPhotoSession): void {
  macroPhotoSession.off('smoothZoomInfoAvailable');
}

MacroVideoSession¹²⁺

MacroVideoSession extends Session, Flash, AutoExposure, Focus, Zoom, ColorEffect, ManualFocus

Implements a macro video session, which sets the parameters of the macro video mode and saves all CameraInput and CameraOutput instances required to run the camera. It inherits from Session.

on('error')¹²⁺

on(type: 'error', callback: ErrorCallback): void

Subscribes to MacroVideoSession error events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created. This event is triggered and the error message is returned when an error occurs during the calling of a session-related API such as beginConfig, commitConfig, and addInput.
callback	ErrorCallback	Yes	Callback used to return an error code defined in CameraErrorCode.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError): void {
  console.error(`MacroPhotoSession error code: ${err.code}`);
}

function registerSessionError(macroVideoSession: camera.MacroVideoSession): void {
  macroVideoSession.on('error', callback);
}

off('error')¹²⁺

off(type: 'error', callback?: ErrorCallback): void

Unsubscribes from MacroVideoSession error events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created.
callback	ErrorCallback	No	Callback used to return the result. If this parameter is specified, the subscription to the specified event with the specified callback is canceled. (The callback object cannot be an anonymous function.) Otherwise, the subscriptions to the specified event with all the callbacks are canceled.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterSessionError(macroVideoSession: camera.MacroVideoSession): void {
  macroVideoSession.off('error');
}

on('focusStateChange')¹²⁺

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

Subscribes to focus state change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created. This event is triggered only when the camera focus state changes in auto focus mode.
callback	AsyncCallback<FocusState>	Yes	Callback used to return the focus state change.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, focusState: camera.FocusState): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`Focus state: ${focusState}`);
}

function registerFocusStateChange(macroVideoSession: camera.MacroVideoSession): void {
  macroVideoSession.on('focusStateChange', callback);
}

off('focusStateChange')¹²⁺

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

Unsubscribes from focus state change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created.
callback	AsyncCallback<FocusState>	No	Callback used to return the result. If this parameter is specified, the subscription to the specified event with the specified callback is canceled. (The callback object cannot be an anonymous function.) Otherwise, the subscriptions to the specified event with all the callbacks are canceled.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterFocusStateChange(macroVideoSession: camera.MacroVideoSession): void {
  macroVideoSession.off('focusStateChange');
}

on('smoothZoomInfoAvailable')¹²⁺

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

Subscribes to smooth zoom state change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'smoothZoomInfoAvailable'. The event can be listened for when a session is created.
callback	AsyncCallback<SmoothZoomInfo>	Yes	Callback used to return the smooth zoom state change.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, smoothZoomInfo: camera.SmoothZoomInfo): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`The duration of smooth zoom: ${smoothZoomInfo.duration}`);
}

function registerSmoothZoomInfo(macroVideoSession: camera.MacroVideoSession): void {
  macroVideoSession.on('smoothZoomInfoAvailable', callback);
}

off('smoothZoomInfoAvailable')¹²⁺

off(type: 'smoothZoomInfoAvailable', callback?: AsyncCallback<SmoothZoomInfo>): void

Unsubscribes from smooth zoom state change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'smoothZoomInfoAvailable'. The event can be listened for when a session is created.
callback	AsyncCallback<SmoothZoomInfo>	No	Callback used to return the result. If this parameter is specified, the subscription to the specified event with the specified callback is canceled. (The callback object cannot be an anonymous function.) Otherwise, the subscriptions to the specified event with all the callbacks are canceled.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterSmoothZoomInfo(macroVideoSession: camera.MacroVideoSession): void {
  macroVideoSession.off('smoothZoomInfoAvailable');
}

FlashQuery¹²⁺

Provides APIs to obtain the flash information of a camera device, including whether the LCD flash is supported.

isLcdFlashSupported¹²⁺

isLcdFlashSupported(): boolean

Checks whether the LCD flash is supported.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
boolean	Check result for the support of the LCD flash. true if supported, false otherwise.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config, only throw in session usage.

Example

function isLcdFlashSupported(nightPhotoSession: camera.NightPhotoSession): boolean {
  return nightPhotoSession.isLcdFlashSupported();
}

Flash¹¹⁺

Flash extends FlashQuery

Provides APIs related to the flash.

enableLcdFlash¹³⁺

enableLcdFlash(enabled: boolean): void

Enables or disables the LCD flash.

Before the setting, call isLcdFlashSupported to check whether the device supports the LCD flash.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
enabled	boolean	Yes	Whether to enable or disable the LCD flash. true to enable, false otherwise. If null or undefined is passed, it is treated as 0 and the LCD flash is disabled.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function enableLcdFlash(session: camera.PhotoSessionForSys | camera.VideoSessionForSys | camera.NightPhotoSession): void {
  try {
    session.enableLcdFlash(true);
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The setFlashMode call failed. error code: ${err.code}`);
  }
}

TimeLapseRecordState¹²⁺

Enumerates the time-lapse recording states.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
IDLE	0	Recording not started.
RECORDING	1	Recording.

TimeLapsePreviewType¹²⁺

Enumerates the time-lapse preview types, which affect the shooting algorithm.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
DARK	1	Dark environment, a scenario with poor illumination, for example, at night or in a dark area.
LIGHT	2	Bright environment, a scenario with good illumination, for example, in the daytime or under light.

TryAEInfo¹²⁺

Describes the Try AE parameters. Try AE indicates that the hardware reports the status based on the ambient illumination change during time-lapse photographing.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Type	Read-only	Optional	Description
isTryAEDone	boolean	Yes	No	Whether Try AE is complete. true if complete, false otherwise.
isTryAEHintNeeded	boolean	Yes	Yes	Whether Try AE is required. true if required, false otherwise.
previewType	TimeLapsePreviewType	Yes	Yes	Preview type.
captureInterval	number	Yes	Yes	Shooting interval, in ms.

TimeLapsePhotoSession¹²⁺

TimeLapsePhotoSession extends Session, Focus, ManualFocus, AutoExposure, ManualExposure, ManualIso, WhiteBalance, Zoom, ColorEffect

Implements a time-lapse photo session, which sets the parameters of the time-lapse photo mode and saves all CameraInput and CameraOutput instances required to run the camera. It inherits from Session.

on('error')¹²⁺

on(type: 'error', callback: ErrorCallback): void

Subscribes to TimeLapsePhotoSession error events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created. This event is triggered and the error message is returned when an error occurs during the calling of a session-related API such as beginConfig, commitConfig, and addInput.
callback	ErrorCallback	Yes	Callback used to return an error code defined in CameraErrorCode.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError): void {
  console.error(`Time lapse photo session error code: ${err.code}`);
}

function registerSessionError(timeLapsePhotoSession: camera.TimeLapsePhotoSession): void {
  timeLapsePhotoSession.on('error', callback);
}

off('error')¹²⁺

off(type: 'error', callback?: ErrorCallback): void

Unsubscribes from TimeLapsePhotoSession error events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created.
callback	ErrorCallback	No	Callback, which is optional. If a callback function is passed in, it is an anonymous function.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterSessionError(timeLapsePhotoSession: camera.TimeLapsePhotoSession): void {
  timeLapsePhotoSession.off('error');
}

on('focusStateChange')¹²⁺

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

Subscribes to focus state change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created. This event is triggered only when the camera focus state changes in auto focus mode.
callback	AsyncCallback<FocusState>	Yes	Callback used to return the focus state change.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, focusState: camera.FocusState): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`Focus state: ${focusState}`);
}

function registerFocusStateChange(timeLapsePhotoSession: camera.TimeLapsePhotoSession): void {
  timeLapsePhotoSession.on('focusStateChange', callback);
}

off('focusStateChange')¹²⁺

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

Unsubscribes from focus state change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created.
callback	AsyncCallback<FocusState>	No	Callback used to return the result. This parameter is optional. If this parameter is specified, the subscription to the specified event on('focusStateChange') with the specified callback is canceled. (The callback object cannot be an anonymous function.)

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterFocusStateChange(timeLapsePhotoSession: camera.TimeLapsePhotoSession): void {
  timeLapsePhotoSession.off('focusStateChange');
}

on('isoInfoChange')¹²⁺

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

Subscribes to automatic ISO change events to obtain real-time ISO information. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'isoInfoChange'.
callback	AsyncCallback<IsoInfo>	Yes	Callback used to return the ISO information.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function isoInfoCallback(err: BusinessError, info: camera.IsoInfo): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`ISO value: ${info.iso}`);
}

function registerIsoInfoEvent(timeLapsePhotoSession: camera.TimeLapsePhotoSession): void {
  timeLapsePhotoSession.on('isoInfoChange', isoInfoCallback);
}

off('isoInfoChange')¹²⁺

off(type: 'isoInfoChange', callback?: AsyncCallback<IsoInfo>): void

Unsubscribes from automatic ISO change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'isoInfoChange'.
callback	AsyncCallback<IsoInfo>	No	Callback, which is optional and is used to match callback in on('isoInfoChange').

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterIsoInfoEvent(timeLapsePhotoSession: camera.TimeLapsePhotoSession): void {
  timeLapsePhotoSession.off('isoInfoChange');
}

on('exposureInfoChange')¹²⁺

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

Subscribes to exposure information change events to obtain the exposure information. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'exposureInfoChange'.
callback	AsyncCallback<ExposureInfo>	Yes	Callback used to return the exposure information.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function exposureInfoCallback(err: BusinessError, info: camera.ExposureInfo): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`exposureTimeValue: ${info.exposureTime}`);
}

function registerExposureInfoEvent(timeLapsePhotoSession: camera.TimeLapsePhotoSession): void {
  timeLapsePhotoSession.on('exposureInfoChange', exposureInfoCallback);
}

off('exposureInfoChange')¹²⁺

off(type: 'exposureInfoChange', callback?: AsyncCallback<ExposureInfo>): void

Unsubscribes from exposure information change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'exposureInfoChange'.
callback	AsyncCallback<ExposureInfo>	No	Callback, which is optional and is used to match callback in on('exposureInfoChange').

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterExposureInfoEvent(timeLapsePhotoSession: camera.TimeLapsePhotoSession): void {
  timeLapsePhotoSession.off('exposureInfoChange');
}

on('luminationInfoChange')¹²⁺

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

Subscribes to illumination change events to obtain real-time illumination information. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'luminationInfoChange'.
callback	AsyncCallback<LuminationInfo>	Yes	Callback used to return the illumination information.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function luminationInfoCallback(err: BusinessError, info: camera.LuminationInfo): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`Lumination: ${info.lumination}`);
}

function registerLuminationInfoEvent(timeLapsePhotoSession: camera.TimeLapsePhotoSession): void {
  timeLapsePhotoSession.on('luminationInfoChange', luminationInfoCallback);
}

off('luminationInfoChange')¹²⁺

off(type: 'luminationInfoChange', callback?: AsyncCallback<LuminationInfo>): void

Unsubscribes from illumination change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'luminationInfoChange'.
callback	AsyncCallback<LuminationInfo>	No	Callback, which is optional and is used to match callback in on('luminationInfoChange').

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterLuminationInfoEvent(timeLapsePhotoSession: camera.TimeLapsePhotoSession): void {
  timeLapsePhotoSession.off('luminationInfoChange');
}

on('tryAEInfoChange')¹²⁺

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

Subscribes to Try AE change events to obtain real-time Try AE parameters. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'tryAEInfoChange'.
callback	AsyncCallback<TryAEInfo>	Yes	Callback used to return the Try AE parameters.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function tryAEInfoCallback(err: BusinessError, info: camera.TryAEInfo): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`TryAEInfo: ${info.isTryAEDone}, ${info.isTryAEHintNeeded}, ${info.previewType}, ${info.captureInterval}`);
}

function registerTryAEInfoEvent(timeLapsePhotoSession: camera.TimeLapsePhotoSession): void {
  timeLapsePhotoSession.on('tryAEInfoChange', tryAEInfoCallback);
}

off('tryAEInfoChange')¹²⁺

off(type: 'tryAEInfoChange', callback?: AsyncCallback<TryAEInfo>): void

Unsubscribes from Try AE change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'tryAEInfoChange'.
callback	AsyncCallback<TryAEInfo>	No	Callback, which is optional and is used to match callback in on('tryAEInfoChange').

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterTryAEInfoEvent(timeLapsePhotoSession: camera.TimeLapsePhotoSession): void {
  timeLapsePhotoSession.off('tryAEInfoChange');
}

isTryAENeeded¹²⁺

isTryAENeeded(): boolean

Checks whether Try AE is required.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
boolean	Check result for whether Try AE is required. true if required, false otherwise. The error code type is defined in CameraErrorCode.

Error codes

For details about the error codes, see Camera Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config, only throw in session usage.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function isTryAENeeded(timeLapsePhotoSession: camera.TimeLapsePhotoSession): boolean {
  let needed = false;
  try {
    needed = timeLapsePhotoSession.isTryAENeeded();
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The isTryAENeeded call failed. error code: ${err.code}`);
  }
  return needed;
}

startTryAE¹²⁺

startTryAE(): void

Starts to execute Try AE.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config.
7400201	Camera service fatal error.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function startTryAE(timeLapsePhotoSession: camera.TimeLapsePhotoSession): void {
  try {
    timeLapsePhotoSession.startTryAE();
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The startTryAE call failed. error code: ${err.code}`);
  }
}

stopTryAE¹²⁺

stopTryAE(): void

Stops the execution of Try AE.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config.
7400201	Camera service fatal error.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function stopTryAE(timeLapsePhotoSession: camera.TimeLapsePhotoSession): void {
  try {
    timeLapsePhotoSession.stopTryAE();
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The stopTryAE call failed. error code: ${err.code}`);
  }
}

getSupportedTimeLapseIntervalRange¹²⁺

getSupportedTimeLapseIntervalRange(): Array<number>

Obtains the supported time-lapse shooting interval range.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
Array<number>	Interval range, in ms. The value depends on the underlying capability. If the operation fails, an error code defined in CameraErrorCode is returned.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config, only throw in session usage.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function getSupportedTimeLapseIntervalRange(timeLapsePhotoSession: camera.TimeLapsePhotoSession): Array<number> {
  let intervalRange: Array<number> = [];
  try {
    intervalRange = timeLapsePhotoSession.getSupportedTimeLapseIntervalRange();
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The getSupportedTimeLapseIntervalRange call failed. error code: ${err.code}`);
  }
  return intervalRange;
}

getTimeLapseInterval¹²⁺

getTimeLapseInterval(): number

Obtains the current time-lapse shooting interval.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
number	Shooting interval, in ms.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function getTimeLapseInterval(timeLapsePhotoSession: camera.TimeLapsePhotoSession): number {
  let interval: number = 0;
  try {
    interval = timeLapsePhotoSession.getTimeLapseInterval();
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The getTimeLapseInterval call failed. error code: ${err.code}`);
  }
  return interval;
}

setTimeLapseInterval¹²⁺

setTimeLapseInterval(interval: number): void

Sets a time-lapse shooting interval.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
interval	number	Yes	Shooting interval, in ms.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400101	Parameter missing or parameter type incorrect.
7400103	Session not config.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function setTimeLapseInterval(timeLapsePhotoSession: camera.TimeLapsePhotoSession): void {
  try {
    let interval: number = 10000;
    timeLapsePhotoSession.setTimeLapseInterval(interval);
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The setTimeLapseInterval call failed. error code: ${err.code}`);
  }
}

getTimeLapseRecordState¹²⁺

getTimeLapseRecordState(): TimeLapseRecordState

Obtains the time-lapse shooting state.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
TimeLapseRecordState	Shooting state. If the operation fails, an error code defined in CameraErrorCode is returned.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function getTimeLapseRecordState(timeLapsePhotoSession: camera.TimeLapsePhotoSession): camera.TimeLapseRecordState {
  let state = camera.TimeLapseRecordState.IDLE;
  try {
    state = timeLapsePhotoSession.getTimeLapseRecordState();
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The getTimeLapseRecordState call failed. error code: ${err.code}`);
  }
  return state;
}

setTimeLapseRecordState¹²⁺

setTimeLapseRecordState(state: TimeLapseRecordState): void

Sets the time-lapse shooting state.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
state	TimeLapseRecordState	Yes	Shooting state.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400101	Parameter missing or parameter type incorrect.
7400103	Session not config.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function setTimeLapseRecordState(timeLapsePhotoSession: camera.TimeLapsePhotoSession): void {
  try {
    timeLapsePhotoSession.setTimeLapseRecordState(camera.TimeLapseRecordState.RECORDING);
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The setTimeLapseRecordState call failed. error code: ${err.code}`);
  }
}

getTimeLapsePreviewType¹²⁺

getTimeLapsePreviewType(): TimeLapsePreviewType

Obtains the time-lapse preview type.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
TimeLapsePreviewType	Preview type. If the operation fails, an error code defined in CameraErrorCode is returned.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function getTimeLapsePreviewType(timeLapsePhotoSession: camera.TimeLapsePhotoSession): camera.TimeLapsePreviewType {
  let type = camera.TimeLapsePreviewType.DARK;
  try {
    type = timeLapsePhotoSession.getTimeLapsePreviewType();
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The getTimeLapsePreviewType call failed. error code: ${err.code}`);
  }
  return type;
}

setTimeLapsePreviewType¹²⁺

setTimeLapsePreviewType(type: TimeLapsePreviewType): void

Sets the time-lapse preview type.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
state	TimeLapsePreviewType	Yes	Preview type.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400101	Parameter missing or parameter type incorrect.
7400103	Session not config.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function setTimeLapsePreviewType(timeLapsePhotoSession: camera.TimeLapsePhotoSession): void {
  try {
    timeLapsePhotoSession.setTimeLapsePreviewType(camera.TimeLapsePreviewType.LIGHT);
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The setTimeLapsePreviewType call failed. error code: ${err.code}`);
  }
}

LightPaintingPhotoSession¹²⁺

LightPaintingPhotoSession extends Session, Flash, Focus, Zoom, ColorEffect

Implements a light painting photo session, which sets the parameters of the light painting photo mode and saves all CameraInput and CameraOutput instances required to run the camera. It inherits from Session.

on('error')¹²⁺

on(type: 'error', callback: ErrorCallback): void

Subscribes to LightPaintingPhotoSession error events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created. This event is triggered and the error message is returned when an error occurs during the calling of a session-related API such as beginConfig, commitConfig, and addInput.
callback	ErrorCallback	Yes	Callback used to return an error code defined in CameraErrorCode.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError): void {
  console.error(`LightPaintingPhotoSession error code: ${err.code}`);
}

function registerSessionError(lightPaintingPhotoSession: camera.LightPaintingPhotoSession): void {
  lightPaintingPhotoSession.on('error', callback);
}

off('error')¹²⁺

off(type: 'error', callback?: ErrorCallback): void

Unsubscribes from LightPaintingPhotoSession error events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'error'. The event can be listened for when a session is created.
callback	ErrorCallback	No	Callback used to return the result. If this parameter is specified, the subscription to the specified event with the specified callback is canceled. (The callback object cannot be an anonymous function.) Otherwise, the subscriptions to the specified event with all the callbacks are canceled.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterSessionError(lightPaintingPhotoSession: camera.LightPaintingPhotoSession): void {
  lightPaintingPhotoSession.off('error');
}

on('focusStateChange')¹²⁺

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

Subscribes to focus state change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created. This event is triggered only when the camera focus state changes in auto focus mode.
callback	AsyncCallback<FocusState>	Yes	Callback used to return the focus state change.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, focusState: camera.FocusState): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`Focus state: ${focusState}`);
}

function registerFocusStateChange(lightPaintingPhotoSession: camera.LightPaintingPhotoSession): void {
  lightPaintingPhotoSession.on('focusStateChange', callback);
}

off('focusStateChange')¹²⁺

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

Unsubscribes from focus state change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'focusStateChange'. The event can be listened for when a session is created.
callback	AsyncCallback<FocusState>	No	Callback used to return the result. If this parameter is specified, the subscription to the specified event with the specified callback is canceled. (The callback object cannot be an anonymous function.) Otherwise, the subscriptions to the specified event with all the callbacks are canceled.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterFocusStateChange(lightPaintingPhotoSession: camera.LightPaintingPhotoSession): void {
  lightPaintingPhotoSession.off('focusStateChange');
}

on('smoothZoomInfoAvailable')¹²⁺

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

Subscribes to smooth zoom state change events. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'smoothZoomInfoAvailable'. The event can be listened for when a session is created.
callback	AsyncCallback<SmoothZoomInfo>	Yes	Callback used to return the smooth zoom state change.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function callback(err: BusinessError, smoothZoomInfo: camera.SmoothZoomInfo): void {
  if (err !== undefined && err.code !== 0) {
    console.error(`Callback Error, errorCode: ${err.code}`);
    return;
  }
  console.info(`The duration of smooth zoom: ${smoothZoomInfo.duration}`);
}

function registerSmoothZoomInfo(lightPaintingPhotoSession: camera.LightPaintingPhotoSession): void {
  lightPaintingPhotoSession.on('smoothZoomInfoAvailable', callback);
}

off('smoothZoomInfoAvailable')¹²⁺

off(type: 'smoothZoomInfoAvailable', callback?: AsyncCallback<SmoothZoomInfo>): void

Unsubscribes from smooth zoom state change events.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is fixed at 'smoothZoomInfoAvailable'. The event can be listened for when a session is created.
callback	AsyncCallback<SmoothZoomInfo>	No	Callback used to return the result. If this parameter is specified, the subscription to the specified event with the specified callback is canceled. (The callback object cannot be an anonymous function.) Otherwise, the subscriptions to the specified event with all the callbacks are canceled.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Not System Application.

Example

function unregisterSmoothZoomInfo(lightPaintingPhotoSession: camera.LightPaintingPhotoSession): void {
  lightPaintingPhotoSession.off('smoothZoomInfoAvailable');
}

getLightPaintingType¹²⁺

getLightPaintingType(): LightPaintingType

Obtains the type of light painting shutter mode in use.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
LightPaintingType	Type of light painting shutter mode.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config.

Example

function getLightPaintingType(lightPaintingPhotoSession: camera.LightPaintingPhotoSession): camera.LightPaintingType {
  let type: camera.LightPaintingType = lightPaintingPhotoSession.getLightPaintingType();
  return type;
}

setLightPaintingType¹²⁺

setLightPaintingType(type: LightPaintingType): void

Sets the type of light painting shutter mode.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Name	Type	Mandatory	Description
type	LightPaintingType	Yes	Type of light painting mode.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400101	Parameter missing or parameter type incorrect.
7400103	Session not config.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function setLightPaintingType(lightPaintingPhotoSession: camera.LightPaintingPhotoSession): void {
  try {
    let type: camera.LightPaintingType = camera.LightPaintingType.TRAFFIC_TRAILS;
    lightPaintingPhotoSession.setLightPaintingType(type);
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The setLightPaintingType call failed. error code: ${err.code}`);
  }
}

getSupportedLightPaintingTypes¹²⁺

getSupportedLightPaintingTypes(): Array<LightPaintingType>

Obtains the supported types of light painting shutter mode.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
Array<LightPaintingType>	Supported types of light painting shutter mode.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config.

Example

function getSupportedLightPaintingTypes(lightPaintingPhotoSession: camera.LightPaintingPhotoSession): Array<camera.LightPaintingType> {
  let types: Array<camera.LightPaintingType> = lightPaintingPhotoSession.getSupportedLightPaintingTypes();
  return types
}

ColorReservationType¹⁵⁺

Enumerates the color reservation types.

System capability: SystemCapability.Multimedia.Camera.Core

Name	Value	Description
NONE	0	No color reservation.
PORTRAIT	1	Portrait color reservation.

ColorReservationQuery¹⁵⁺

Provides APIs for querying the color retention type supported by the device.

getSupportedColorReservationTypes¹⁵⁺

getSupportedColorReservationTypes(): Array<ColorReservationType>

Obtains the supported color reservation types.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
Array<ColorReservationType>	Array of color reservation types supported.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config, only throw in session usage.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function getSupportedColorReservationTypes(session: camera.VideoSessionForSys): Array<camera.ColorReservationType> {
  let colorReservationTypes: Array<camera.ColorReservationType> = [];
  try {
    colorReservationTypes = session.getSupportedColorReservationTypes();
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The getSupportedColorReservationTypes call failed. error code: ${err.code}`);
  }
  return colorReservationTypes;
}

ColorReservation¹⁵⁺

ColorReservation extends ColorReservationQuery

Provides API for obtaining and setting a color reservation type.

setColorReservation¹⁵⁺

setColorReservation(type: ColorReservationType): void

Sets a color reservation type. Before the setting, call getSupportedColorReservationTypes to obtain the supported color reservation types.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Parameters

Name	Type	Mandatory	Description
type	ColorReservationType	Yes	Color reservation type, which is obtained by calling getSupportedColorReservationTypes.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3.Parameter verification failed.
7400102	Operation not allowed.
7400103	Session not config.
7400201	Camera service fatal error.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function setColorReservation(session: camera.VideoSessionForSys, type: camera.ColorReservationType): void {
  try {
    session.setColorReservation(type);
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The setColorReservation call failed. error code: ${err.code}`);
  }
}

getColorReservation¹⁵⁺

getColorReservation(): ColorReservationType

Obtains the color reservation type in use.

System API: This is a system API.

System capability: SystemCapability.Multimedia.Camera.Core

Return value

Type	Description
ColorReservationType	Color reservation type.

Error codes

For details about the error codes, see Camera Error Codes and Universal Error Codes.

ID	Error Message
202	Not System Application.
7400103	Session not config, only throw in session usage.

Example

import { BusinessError } from '@kit.BasicServicesKit';

function getColorReservation(session: camera.VideoSessionForSys): camera.ColorReservationType | undefined {
  let colorReservation: camera.ColorReservationType | undefined = undefined;
  try {
    colorReservation = session.getColorReservation();
  } catch (error) {
    // If the operation fails, error.code is returned and processed.
    let err = error as BusinessError;
    console.error(`The setColorReservation call failed. error code: ${err.code}`);
  }
  return colorReservation;
}

@ohos.multimedia.camera (Camera Management) (System API)

Modules to Import

SceneMode11+

SlowMotionStatus12+

LcdFlashStatus12+

Photo11+

PolicyType12+

LightPaintingType12+

CameraManager

createDepthDataOutput13+

isCameraMuteSupported

muteCamera(deprecated)

muteCameraPersistent12+

on('cameraMute')

off('cameraMute')

isPrelaunchSupported

setPrelaunchConfig

prelaunch

preSwitchCamera11+

CameraOutputCapability

CameraFormat

CameraInput

DepthDataAccuracy13+

DepthProfile13+

DepthDataQualityLevel13+

DepthData13+

Properties

release13+

DepthDataOutput13+

start13+

stop13+

on('depthDataAvailable')13+

off('depthDataAvailable')13+

on('error')13+

off('error')13+

DepthFusionQuery14+

isDepthFusionSupported14+

getDepthFusionThreshold14+

DepthFusion14+

isDepthFusionEnabled14+

enableDepthFusion14+

PrelaunchConfig

RestoreParamType11+

SettingParam11+

PreviewOutput

isSketchSupported11+

getSketchRatio11+

enableSketch11+

attachSketchSurface11+

on('sketchStatusChanged')11+

off('sketchStatusChanged')11+

DeferredDeliveryImageType11+

DeferredPhotoProxy11+

getThumbnail11+

release11+

PhotoOutput

burstCapture12+

confirmCapture11+

isDeferredImageDeliverySupported11+

isDeferredImageDeliveryEnabled11+

deferImageDelivery11+

isAutoHighQualityPhotoSupported13+

enableAutoHighQualityPhoto13+

on('deferredPhotoProxyAvailable')11+

off('deferredPhotoProxyAvailable')11+

isQuickThumbnailSupported

enableQuickThumbnail

on('quickThumbnail')

off('quickThumbnail')

MetadataOutput

MetadataObjectType

Emotion13+

MetadataObject

MetadataFaceObject13+

MetadataHumanBodyObject13+

MetadataCatFaceObject13+

MetadataCatBodyObject13+

MetadataDogFaceObject13+

MetadataDogBodyObject13+

MetadataSalientDetectionObject13+

SceneMode¹¹⁺

SlowMotionStatus¹²⁺

LcdFlashStatus¹²⁺

Photo¹¹⁺

PolicyType¹²⁺

LightPaintingType¹²⁺

createDepthDataOutput¹³⁺

muteCamera^(deprecated)

muteCameraPersistent¹²⁺

preSwitchCamera¹¹⁺

DepthDataAccuracy¹³⁺

DepthProfile¹³⁺

DepthDataQualityLevel¹³⁺

DepthData¹³⁺

release¹³⁺

DepthDataOutput¹³⁺

start¹³⁺

stop¹³⁺

on('depthDataAvailable')¹³⁺

off('depthDataAvailable')¹³⁺

on('error')¹³⁺

off('error')¹³⁺

DepthFusionQuery¹⁴⁺

isDepthFusionSupported¹⁴⁺

getDepthFusionThreshold¹⁴⁺

DepthFusion¹⁴⁺

isDepthFusionEnabled¹⁴⁺

enableDepthFusion¹⁴⁺

RestoreParamType¹¹⁺

SettingParam¹¹⁺

isSketchSupported¹¹⁺

getSketchRatio¹¹⁺

enableSketch¹¹⁺

attachSketchSurface¹¹⁺

on('sketchStatusChanged')¹¹⁺

off('sketchStatusChanged')¹¹⁺

DeferredDeliveryImageType¹¹⁺

DeferredPhotoProxy¹¹⁺

getThumbnail¹¹⁺

release¹¹⁺

burstCapture¹²⁺

confirmCapture¹¹⁺

isDeferredImageDeliverySupported¹¹⁺

isDeferredImageDeliveryEnabled¹¹⁺

deferImageDelivery¹¹⁺

isAutoHighQualityPhotoSupported¹³⁺

enableAutoHighQualityPhoto¹³⁺

on('deferredPhotoProxyAvailable')¹¹⁺

off('deferredPhotoProxyAvailable')¹¹⁺

Emotion¹³⁺

MetadataFaceObject¹³⁺

MetadataHumanBodyObject¹³⁺

MetadataCatFaceObject¹³⁺

MetadataCatBodyObject¹³⁺

MetadataDogFaceObject¹³⁺

MetadataDogBodyObject¹³⁺

MetadataSalientDetectionObject¹³⁺

MetadataBarcodeObject¹⁴⁺

BeautyQuery¹²⁺

getSupportedBeautyTypes¹¹⁺

getSupportedBeautyRange¹¹⁺

ManualExposureQuery¹²⁺

getSupportedExposureRange¹¹⁺

ManualExposure¹¹⁺

getExposure¹¹⁺

setExposure¹¹⁺

TripodStatus¹³⁺

SceneFeatureType¹²⁺

SceneFeatureDetectionResult¹²⁺

TripodDetectionResult¹³⁺

SceneDetectionQuery¹²⁺

isSceneFeatureSupported¹²⁺

SceneDetection¹²⁺

enableSceneFeature¹²⁺

ZoomPointInfo¹²⁺

ZoomQuery¹²⁺

getZoomPointInfos¹²⁺

Zoom¹¹⁺

prepareZoom¹¹⁺

unprepareZoom¹¹⁺