Skip to content

D
Docs

OpenHarmony / Docs
1 年多 前同步成功

通知 159
Star 292
Fork 28
D
Docs
未验证 提交 0c1c7503 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!14596 翻译完成：13528 Camera development and interface document update 

Merge pull request !14596 from wusongqing/TR13528
上级 1118db9a 3e857ab2
隐藏空白更改
内联 并排
Showing with 803 addition and 1996 deletion
en/application-dev/media/camera.md
浏览文件 @ 0c1c7503
...@@ -2,13 +2,13 @@ ...@@ -2,13 +2,13 @@
## When to Use ## When to Use
With the APIs provided by the **Camera** module, you can access and operate camera devices and develop new functions. Common operations include preview, photographing, and video recording. You can also implement flash control, exposure time control, focus mode control, zooming control, and many others. With the APIs provided by the **Camera** module, you can access and operate camera devices and develop new functions. Common operations include preview, photographing, and video recording. You can also implement flash control, exposure time control, focus mode control, zoom control, and much more.
Before calling camera APIs, be familiar with the following concepts: Before calling camera APIs, be familiar with the following concepts:
- **Static camera capabilities**: A series of parameters used to describe inherent capabilities of a camera, such as orientation and supported resolution. - **Static camera capabilities**: A series of parameters used to describe inherent capabilities of a camera, such as orientation and supported resolution.
- **Physical camera**: An independent camera device. The physical camera ID is a string that uniquely identifies a physical camera. - **Physical camera**: An independent camera device. The physical camera ID is a string that uniquely identifies a physical camera.
- **Asynchronous operation**: To prevent the UI thread from being blocked, most **Camera** calls are asynchronous. Each API provides the callback and promise functions. - **Asynchronous operation**: A non-blocking operation that allows other operations to execute before it completes. To prevent the UI thread from being blocked, some **Camera** calls are asynchronous. Each asynchronous API provides the callback and promise functions.
## How to Develop ## How to Develop
...@@ -22,7 +22,7 @@ The full process includes applying for permissions, creating an instance, settin ...@@ -22,7 +22,7 @@ The full process includes applying for permissions, creating an instance, settin
#### Applying for Permissions #### Applying for Permissions
You must apply for the permission for your application to access the camera device and other functions. The following table lists camera-related permissions. You must apply for the permissions for your application to access the camera device and other functions. The following table lists camera-related permissions.
| Permission| Attribute Value | | Permission| Attribute Value |
| -------- | ------------------------------ | | -------- | ------------------------------ |
...@@ -51,82 +51,108 @@ function applyPermission() { ...@@ -51,82 +51,108 @@ function applyPermission() {
#### Creating an Instance #### Creating an Instance
You must create an independent **CameraManager** instance before performing camera operations. If this operation fails, the camera may be occupied or unusable. If the camera is occupied, wait until it is released. You can call **getSupportedCameras()** to obtain the list of cameras supported by the current device. The list stores all camera IDs of the current device. If the list is not empty, each ID in the list can be used to create an independent camera instance. If the list is empty, no camera is available for the current device and subsequent operations cannot be performed. The camera has preview, shooting, video recording, and metadata streams. You can use **getSupportedOutputCapability()** to obtain the output stream capabilities of the camera and configure them in the **profile** field in **CameraOutputCapability**. The procedure for creating a **CameraManager** instance is as follows: You must create an independent **CameraManager** instance before performing camera operations. If this operation fails, the camera may be occupied or unusable. If the camera is occupied, wait until it is released. You can call **getSupportedCameras()** to obtain the list of cameras supported by the current device. The list stores all camera IDs of the current device. Each of these IDs can be used to create an independent **CameraManager** instance. If the list is empty, no camera is available for the current device and subsequent operations cannot be performed. The camera has preview, shooting, video recording, and metadata output streams. You can use **getSupportedOutputCapability()** to obtain the output stream capabilities of the camera and configure them in the **profile** field in **CameraOutputCapability**. The procedure for creating a **CameraManager** instance is as follows:
```typescript ```typescript
import camera from '@ohos.multimedia.camera' import camera from '@ohos.multimedia.camera'
import image from '@ohos.multimedia.image' import image from '@ohos.multimedia.image'
import media from '@ohos.multimedia.media' import media from '@ohos.multimedia.media'
// Create a CameraManager object. // Create a CameraManager instance.
context: any = getContext(this) context: any = getContext(this)
let cameraManager = await camera.getCameraManager(this.context) let cameraManager = camera.getCameraManager(this.context)
if (!cameraManager) { if (!cameraManager) {
console.error('Failed to get the CameraManager instance'); console.error("camera.getCameraManager error")
} return;
}
// Listen for camera state changes.
cameraManager.on('cameraStatus', (cameraStatusInfo) => {
console.log(`camera : ${cameraStatusInfo.camera.cameraId}`);
console.log(`status: ${cameraStatusInfo.status}`);
})
// Obtain the camera list. // Obtain the camera list.
let cameraArray = await cameraManager.getSupportedCameras() let cameraArray = cameraManager.getSupportedCameras();
if (!cameraArray) { if (cameraArray.length <= 0) {
console.error('Failed to get the cameras'); console.error("cameraManager.getSupportedCameras error")
} return;
}
for (let index = 0; index < cameraArray.length; index++) { for (let index = 0; index < cameraArray.length; index++) {
console.log('cameraId : ' + cameraArray[index].cameraId) // Obtain the camera ID. console.log('cameraId : ' + cameraArray[index].cameraId); // Obtain the camera ID.
console.log('cameraPosition : ' + cameraArray[index].cameraPosition) // Obtain the camera position. console.log('cameraPosition : ' + cameraArray[index].cameraPosition); // Obtain the camera position.
console.log('cameraType : ' + cameraArray[index].cameraType) // Obtain the camera type. console.log('cameraType : ' + cameraArray[index].cameraType); // Obtain the camera type.
console.log('connectionType : ' + cameraArray[index].connectionType) // Obtain the camera connection type. console.log('connectionType : ' + cameraArray[index].connectionType); // Obtain the camera connection type.
} }
// Create a camera input stream. // Create a camera input stream.
let cameraInput = await cameraManager.createCameraInput(cameraArray[0]) let cameraInput
try {
cameraInput = cameraManager.createCameraInput(cameraArray[0]);
} catch () {
console.error('Failed to createCameraInput errorCode = ' + error.code);
}
// Listen for CameraInput errors.
let cameraDevice = cameraArray[0];
cameraInput.on('error', cameraDevice, (error) => {
console.log(`Camera input error code: ${error.code}`);
})
// Open camera // Open the camera.
await cameraInput.open(); await cameraInput.open();
// Obtain the output stream capabilities supported by the camera. // Obtain the output stream capabilities supported by the camera.
let cameraOutputCap = await cameraManager.getSupportedOutputCapability(cameraArray[0]); let cameraOutputCap = cameraManager.getSupportedOutputCapability(cameraArray[0]);
if (!cameraOutputCap) { if (!cameraOutputCap) {
console.error("outputCapability outputCapability == null || undefined") console.error("cameraManager.getSupportedOutputCapability error")
} else { return;
console.info("outputCapability: " + JSON.stringify(cameraOutputCap));
} }
console.info("outputCapability: " + JSON.stringify(cameraOutputCap));
let previewProfilesArray = cameraOutputCap.GetPreviewProfiles(); let previewProfilesArray = cameraOutputCap.previewProfiles;
if (!previewProfilesArray) { if (!previewProfilesArray) {
console.error("createOutput previewProfilesArray == null || undefined") console.error("createOutput previewProfilesArray == null || undefined")
} }
let photoProfilesArray = cameraOutputCap.GetPhotoProfiles(); let photoProfilesArray = cameraOutputCap.photoProfiles;
if (!photoProfilesArray) { if (!photoProfilesArray) {
console.error("createOutput photoProfilesArray == null || undefined") console.error("createOutput photoProfilesArray == null || undefined")
} }
let videoProfilesArray = cameraOutputCap.GetVideoProfiles(); let videoProfilesArray = cameraOutputCap.videoProfiles;
if (!videoProfilesArray) { if (!videoProfilesArray) {
console.error("createOutput videoProfilesArray == null || undefined") console.error("createOutput videoProfilesArray == null || undefined")
} }
let metadataObjectTypesArray = cameraOutputCap.GetSupportedMetadataObjectType(); let metadataObjectTypesArray = cameraOutputCap.supportedMetadataObjectTypes;
if (!metadataObjectTypesArray) { if (!metadataObjectTypesArray) {
console.error("createOutput metadataObjectTypesArray == null || undefined") console.error("createOutput metadataObjectTypesArray == null || undefined")
} }
// Create a preview stream. For details about the surfaceId parameter, see the XComponent section. The preview stream is the surface provided by the XComponent. // Create a preview stream. For details about the surfaceId parameter, see the XComponent section. The preview stream is the surface provided by the XComponent.
let previewOutput = await cameraManager.createPreviewOutput(previewProfilesArray[0], surfaceId) let previewOutput
if (!previewOutput) { try {
previewOutput = cameraManager.createPreviewOutput(previewProfilesArray[0], surfaceId)
} catch (error) {
console.error("Failed to create the PreviewOutput instance.") console.error("Failed to create the PreviewOutput instance.")
} }
// Create an ImageReceiver object and set photo parameters. The resolution is set based on the photographing resolutions supported by the current device, which are obtained by photoProfilesArray. // Listen for PreviewOutput errors.
previewOutput.on('error', (error) => {
console.log(`Preview output error code: ${error.code}`);
})
// Create an ImageReceiver instance and set photo parameters. Wherein, the resolution must be one of the photographing resolutions supported by the current device, which are obtained by photoProfilesArray.
let imageReceiver = await image.createImageReceiver(1920, 1080, 4, 8) let imageReceiver = await image.createImageReceiver(1920, 1080, 4, 8)
// Obtain the surface ID for displaying the photos. // Obtain the surface ID for displaying the photos.
let photoSurfaceId = await imageReceiver.getReceivingSurfaceId() let photoSurfaceId = await imageReceiver.getReceivingSurfaceId()
// Create a photographing output stream. // Create a photographing output stream.
let photoOutput = await cameraManager.createPhotoOutput(photoProfilesArray[0], photoSurfaceId) let photoOutput
if (!photoOutput) { try {
console.error('Failed to create the PhotoOutput instance.'); photoOutput = cameraManager.createPhotoOutput(photoProfilesArray[0], photoSurfaceId)
return; } catch (error) {
console.error('Failed to createPhotoOutput errorCode = ' + error.code);
} }
// Define video recording parameters. // Define video recording parameters.
...@@ -168,12 +194,18 @@ videoRecorder.getInputSurface().then((id) => { ...@@ -168,12 +194,18 @@ videoRecorder.getInputSurface().then((id) => {
videoSurfaceId = id videoSurfaceId = id
}) })
// Create a VideoOutput object. // Create a VideoOutput instance.
let videoOutput = await cameraManager.createVideoOutput(videoProfilesArray[0], videoSurfaceId) let videoOutput
if (!videoOutput) { try {
console.error('Failed to create the videoOutput instance.'); videoOutput = cameraManager.createVideoOutput(videoProfilesArray[0], videoSurfaceId)
return; } catch (error) {
console.error('Failed to create the videoOutput instance. errorCode = ' + error.code);
} }
// Listen for VideoOutput errors.
videoOutput.on('error', (error) => {
console.log(`Preview output error code: ${error.code}`);
})
``` ```
Surfaces must be created in advance for the preview, shooting, and video recording stream. The preview stream is the surface provided by the **XComponent**, the shooting stream is the surface provided by **ImageReceiver**, and the video recording stream is the surface provided by **VideoRecorder**. Surfaces must be created in advance for the preview, shooting, and video recording stream. The preview stream is the surface provided by the **XComponent**, the shooting stream is the surface provided by **ImageReceiver**, and the video recording stream is the surface provided by **VideoRecorder**.
...@@ -247,24 +279,45 @@ function getVideoRecorderSurface() { ...@@ -247,24 +279,45 @@ function getVideoRecorderSurface() {
```typescript ```typescript
// Create a session. // Create a session.
let captureSession = await camera.createCaptureSession() let captureSession
if (!captureSession) { try {
console.error('Failed to create the CaptureSession instance.'); captureSession = cameraManager.createCaptureSession()
return; } catch (error) {
console.error('Failed to create the CaptureSession instance. errorCode = ' + error.code);
} }
console.log('Callback returned with the CaptureSession instance.' + session);
// Listen for session errors.
captureSession.on('error', (error) => {
console.log(`Capture session error code: ${error.code}`);
})
// Start configuration for the session. // Start configuration for the session.
await captureSession.beginConfig() try {
captureSession.beginConfig()
} catch (error) {
console.error('Failed to beginConfig. errorCode = ' + error.code);
}
// Add the camera input stream to the session. // Add the camera input stream to the session.
await captureSession.addInput(cameraInput) try {
captureSession.addInput(cameraInput)
} catch (error) {
console.error('Failed to addInput. errorCode = ' + error.code);
}
// Add the preview input stream to the session. // Add the preview input stream to the session.
await captureSession.addOutput(previewOutput) try {
captureSession.addOutput(previewOutput)
} catch (error) {
console.error('Failed to addOutput(previewOutput). errorCode = ' + error.code);
}
// Add the photographing output stream to the session. // Add the photographing output stream to the session.
await captureSession.addOutput(photoOutput) try {
captureSession.addOutput(photoOutput)
} catch (error) {
console.error('Failed to addOutput(photoOutput). errorCode = ' + error.code);
}
// Commit the session configuration. // Commit the session configuration.
await captureSession.commitConfig() await captureSession.commitConfig()
...@@ -282,13 +335,25 @@ await captureSession.start().then(() => { ...@@ -282,13 +335,25 @@ await captureSession.start().then(() => {
await captureSession.stop() await captureSession.stop()
// Start configuration for the session. // Start configuration for the session.
await captureSession.beginConfig() try {
captureSession.beginConfig()
} catch (error) {
console.error('Failed to beginConfig. errorCode = ' + error.code);
}
// Remove the photographing output stream from the session. // Remove the photographing output stream from the session.
await captureSession.removeOutput(photoOutput) try {
captureSession.removeOutput(photoOutput)
} catch (error) {
console.error('Failed to removeOutput(photoOutput). errorCode = ' + error.code);
}
// Add a video recording output stream to the session. // Add a video recording output stream to the session.
await captureSession.addOutput(videoOutput) try {
captureSession.addOutput(videoOutput)
} catch (error) {
console.error('Failed to addOutput(videoOutput). errorCode = ' + error.code);
}
// Commit the session configuration. // Commit the session configuration.
await captureSession.commitConfig() await captureSession.commitConfig()
...@@ -303,71 +368,65 @@ await captureSession.start().then(() => { ...@@ -303,71 +368,65 @@ await captureSession.start().then(() => {
```typescript ```typescript
// Check whether the camera has flash. // Check whether the camera has flash.
let flashStatus = await captureSession.hasFlash() let flashStatus
if (!flashStatus) { try {
console.error('Failed to check whether the device has the flash mode.'); flashStatus = captureSession.hasFlash()
} catch (error) {
console.error('Failed to hasFlash. errorCode = ' + error.code);
} }
console.log('Promise returned with the flash light support status:' + flashStatus); console.log('Promise returned with the flash light support status:' + flashStatus);
if (flashStatus) { if (flashStatus) {
// Check whether the auto flash mode is supported. // Check whether the auto flash mode is supported.
let flashModeStatus let flashModeStatus
captureSession.isFlashModeSupported(camera.FlashMode.FLASH_MODE_AUTO, async (err, status) => { try {
if (err) { let status = captureSession.isFlashModeSupported(camera.FlashMode.FLASH_MODE_AUTO)
console.error('Failed to check whether the flash mode is supported. ${err.message}');
return;
}
console.log('Callback returned with the flash mode support status: ' + status);
flashModeStatus = status flashModeStatus = status
}) } catch (error) {
console.error('Failed to check whether the flash mode is supported. errorCode = ' + error.code);
}
if(flashModeStatus) { if(flashModeStatus) {
// Set the flash mode to auto. // Set the flash mode to auto.
captureSession.setFlashMode(camera.FlashMode.FLASH_MODE_AUTO, async (err) => { try {
if (err) { captureSession.setFlashMode(camera.FlashMode.FLASH_MODE_AUTO)
console.error('Failed to set the flash mode ${err.message}'); } catch (error) {
return; console.error('Failed to set the flash mode. errorCode = ' + error.code);
} }
console.log('Callback returned with the successful execution of setFlashMode.');
})
} }
} }
// Check whether the continuous auto focus is supported. // Check whether the continuous auto focus is supported.
let focusModeStatus let focusModeStatus
captureSession.isFocusModeSupported(camera.FocusMode.FOCUS_MODE_CONTINUOUS_AUTO, async (err, status) => { try {
if (err) { let status = captureSession.isFocusModeSupported(camera.FocusMode.FOCUS_MODE_CONTINUOUS_AUTO)
console.error('Failed to check whether the focus mode is supported. ${err.message}');
return;
}
console.log('Callback returned with the focus mode support status: ' + status);
focusModeStatus = status focusModeStatus = status
}) } catch (error) {
console.error('Failed to check whether the focus mode is supported. errorCode = ' + error.code);
}
if (focusModeStatus) { if (focusModeStatus) {
// Set the focus mode to continuous auto focus. // Set the focus mode to continuous auto focus.
captureSession.setFocusMode(camera.FocusMode.FOCUS_MODE_CONTINUOUS_AUTO, async (err) => { try {
if (err) { captureSession.setFocusMode(camera.FocusMode.FOCUS_MODE_CONTINUOUS_AUTO)
console.error('Failed to set the focus mode ${err.message}'); } catch (error) {
return; console.error('Failed to set the focus mode. errorCode = ' + error.code);
} }
console.log('Callback returned with the successful execution of setFocusMode.');
})
} }
// Obtain the zoom ratio range supported by the camera. // Obtain the zoom ratio range supported by the camera.
let zoomRatioRange = await captureSession.getZoomRatioRange() let zoomRatioRange
if (!zoomRatioRange) { try {
console.error('Failed to get the zoom ratio range.'); zoomRatioRange = captureSession.getZoomRatioRange()
return; } catch (error) {
console.error('Failed to get the zoom ratio range. errorCode = ' + error.code);
} }
// Set a zoom ratio. // Set a zoom ratio.
captureSession.setZoomRatio(zoomRatioRange[0], async (err) => { try {
if (err) { captureSession.setZoomRatio(zoomRatioRange[0])
console.error('Failed to set the zoom ratio value ${err.message}'); } catch (error) {
return; console.error('Failed to set the zoom ratio value. errorCode = ' + error.code);
} }
console.log('Callback returned with the successful execution of setZoomRatio.');
})
``` ```
#### Taking Photos #### Taking Photos
...@@ -428,7 +487,7 @@ For details about the APIs used for saving photos, see [Image Processing](image. ...@@ -428,7 +487,7 @@ For details about the APIs used for saving photos, see [Image Processing](image.
captureSession.stop() captureSession.stop()
// Release the camera input stream. // Release the camera input stream.
cameraInput.release() cameraInput.close()
// Release the preview output stream. // Release the preview output stream.
previewOutput.release() previewOutput.release()
...@@ -449,4 +508,4 @@ captureSession = null ...@@ -449,4 +508,4 @@ captureSession = null
## Process Flowchart ## Process Flowchart
The following figure shows the process of using the camera. The following figure shows the process of using the camera.
![camera_framework process](figures/camera_framework_process.jpg) ![camera_framework process](figures/camera_framework_process.png)
en/application-dev/reference/apis/js-apis-camera.md
浏览文件 @ 0c1c7503
...@@ -12,9 +12,9 @@ import camera from '@ohos.multimedia.camera'; ...@@ -12,9 +12,9 @@ import camera from '@ohos.multimedia.camera';
## camera.getCameraManager ## camera.getCameraManager
getCameraManager(context: Context, callback: AsyncCallback<CameraManager\>): void getCameraManager(context: Context): CameraManager
Obtains a **CameraManager** instance. This API uses an asynchronous callback to return the result. Obtains a **CameraManager** instance. This API returns the result synchronously.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
...@@ -23,46 +23,17 @@ Obtains a **CameraManager** instance. This API uses an asynchronous callback to ...@@ -23,46 +23,17 @@ Obtains a **CameraManager** instance. This API uses an asynchronous callback to
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | ----------------------------------------------- | ---- | ---------------------------- | | -------- | ----------------------------------------------- | ---- | ---------------------------- |
| context | [Context](js-apis-inner-app-context.md) | Yes | Application context. | | context | [Context](js-apis-inner-app-context.md) | Yes | Application context. |
| callback | AsyncCallback<[CameraManager](#cameramanager)\> | Yes | Callback used to return the **CameraManager** instance.|
**Example**
```js
camera.getCameraManager(context, (err, cameraManager) => {
if (err) {
console.error(`Failed to get the CameraManager instance ${err.message}`);
return;
}
console.log('Callback returned with the CameraManager instance');
});
```
## camera.getCameraManager
getCameraManager(context: Context): Promise<CameraManager\>
Obtains a **CameraManager** instance. This API uses a promise to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| ------- | ------- | ---- | ------------ |
| context | [Context](js-apis-inner-app-context.md) | Yes | Application context.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ----------------------------------------- | ----------------------------------- | | ----------------------------------------------- | ---------------------------- |
| Promise<[CameraManager](#cameramanager)\> | Promise used to return the **CameraManager** instance.| | [CameraManager](#cameramanager) | **CameraManager** instance obtained. |
**Example** **Example**
```js ```js
camera.getCameraManager(context).then((cameraManager) => { let cameraManager = camera.getCameraManager(context);
console.log('Promise returned with the CameraManager instance.');
})
``` ```
## CameraStatus ## CameraStatus
...@@ -71,12 +42,12 @@ Enumerates the camera statuses. ...@@ -71,12 +42,12 @@ Enumerates the camera statuses.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
| Name | Value | Description | | Name | Value | Description |
| ------------------------- | ---- | ------------ | | ------------------------- | ---- | ------------ |
| CAMERA_STATUS_APPEAR | 0 | A camera appears. | | CAMERA_STATUS_APPEAR | 0 | A camera appears. |
| CAMERA_STATUS_DISAPPEAR | 1 | The camera disappears.| | CAMERA_STATUS_DISAPPEAR | 1 | The camera disappears. |
| CAMERA_STATUS_AVAILABLE | 2 | The camera is available. | | CAMERA_STATUS_AVAILABLE | 2 | The camera is available. |
| CAMERA_STATUS_UNAVAILABLE | 3 | The camera is unavailable.| | CAMERA_STATUS_UNAVAILABLE | 3 | The camera is unavailable. |
## Profile ## Profile
...@@ -123,64 +94,54 @@ Defines the camera output capability. ...@@ -123,64 +94,54 @@ Defines the camera output capability.
| videoProfiles | Array<[VideoProfile](#videoprofile)\> | Yes | Supported video recording profiles. | | videoProfiles | Array<[VideoProfile](#videoprofile)\> | Yes | Supported video recording profiles. |
| supportedMetadataObjectTypes | Array<[MetadataObjectType](#metadataobjecttype)\> | Yes | Supported metadata object types.| | supportedMetadataObjectTypes | Array<[MetadataObjectType](#metadataobjecttype)\> | Yes | Supported metadata object types.|
## CameraManager ## CameraErrorCode
Implements camera management. Before calling any API in **CameraManager**, you must use **getCameraManager** to obtain a **CameraManager** instance.
### getSupportedCameras
getSupportedCameras(callback: AsyncCallback<Array<CameraDevice\>\>): void
Obtains supported cameras. This API uses an asynchronous callback to return the result. Enumerates the camera error codes, which are returned when an API call is incorrect or the **on()** API is used to listen for the error status.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters** | Name | Value | Description |
| ------------------------- | ---- | ------------ |
| Name | Type | Mandatory| Description | | INVALID_ARGUMENT | 7400101 | A parameter is missing or the parameter type is incorrect. |
| -------- | ----------------------------------------------------- | ---- | ------------------------------- | | OPERATION_NOT_ALLOWED | 7400102 | The operation is not allowed. |
| callback | AsyncCallback<Array<[CameraDevice](#cameradevice)\>\> | Yes | Callback used to return the array of supported cameras.| | SESSION_NOT_CONFIG | 7400103 | The session is not configured. |
| SESSION_NOT_RUNNING | 7400104 | The session is not running. |
| SESSION_CONFIG_LOCKED | 7400105 | The session configuration is locked. |
| DEVICE_SETTING_LOCKED | 7400106 | The device setting is locked. |
| CONFILICT_CAMERA | 7400107 | The device is already started. |
| DEVICE_DISABLED | 7400108 | The camera is disabled for security reasons. |
| SERVICE_FATAL_ERROR | 7400201 | An error occurs in the camera service. |
**Example** ## CameraManager
```js Implements camera management. Before calling any API in **CameraManager**, you must use **getCameraManager** to obtain a **CameraManager** instance.
cameraManager.getSupportedCameras((err, cameras) => {
if (err) {
console.error(`Failed to get the cameras. ${err.message}`);
return;
}
console.log(`Callback returned with an array of supported cameras: ${cameras.length}`);
})
```
### getSupportedCameras ### getSupportedCameras
getSupportedCameras(): Promise<Array<CameraDevice\>\> getSupportedCameras(): Array<CameraDevice\>
Obtains supported cameras. This API uses a promise to return the result. Obtains supported cameras. This API returns the result synchronously.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
**Return value** **Return value**
| Type | Description | | Type | Description |
| ----------------------------------------------- | ------------------------- | | ----------------------------------------------- | ---------------------------- |
| Promise<Array<[CameraDevice](#cameradevice)\>\> | Promise used to return the array of supported cameras.| | Array<[CameraDevice](#cameradevice)> | An array of supported cameras. |
**Example** **Example**
```js ```js
cameraManager.getSupportedCameras().then((cameras) => { let cameras = cameraManager.getSupportedCameras();
console.log(`Promise returned with an array of supported cameras: ${cameras.length}`);
})
``` ```
### getSupportedOutputCapability ### getSupportedOutputCapability
getSupportedOutputCapability(camera:CameraDevice, callback: AsyncCallback<CameraOutputCapability\>): void getSupportedOutputCapability(cameraDevice:CameraDevice): CameraOutputCapability
Obtains the output capability supported by a camera. This API uses an asynchronous callback to return the result. Obtains the output capability supported by a camera. This API returns the result synchronously.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
...@@ -189,52 +150,19 @@ Obtains the output capability supported by a camera. This API uses an asynchrono ...@@ -189,52 +150,19 @@ Obtains the output capability supported by a camera. This API uses an asynchrono
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| ------------ |--------------------------------------------------------------- | -- | -------------------------- | | ------------ |--------------------------------------------------------------- | -- | -------------------------- |
| cameraDevice | [CameraDevice](#cameradevice) | Yes| Target camera, which is obtained through **getSupportedCameras**. | | cameraDevice | [CameraDevice](#cameradevice) | Yes| Target camera, which is obtained through **getSupportedCameras**. |
| callback | AsyncCallback<[CameraOutputCapability](#cameraoutputcapability)\> | Yes| Callback used to return the output capability.|
**Example**
```js
cameraManager.getSupportedCameras().then((cameras) => {
let cameraDevice = cameras[0];
cameraManager.getSupportedOutputCapability(cameraDevice, (err, CameraOutputCapability) => {
if (err) {
console.error(`Failed to get the outputCapability. ${err.message}`);
return;
}
console.log('Callback returned with an array of supported outputCapability');
})
})
```
### getSupportedOutputCapability
getSupportedOutputCapability(camera:CameraDevice): Promise<CameraOutputCapability\>
Obtains the output capability supported by a camera. This API uses a promise to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory | Description |
| -------- | --------------------------------- | ---- | ---------- |
| cameradevice | [CameraDevice](#cameradevice) | Yes | Target camera, which is obtained through **getSupportedCameras**. |
**Return value** **Return value**
| Type | Description | | Type | Description |
| -------------------------------------------------------------- | ----------------------------- | | ----------------------------------------------- | ---------------------------- |
| Promise<[CameraOutputCapability](#cameraoutputcapability)\> | Promise used to return the output capability.| | [CameraOutputCapability](#cameraoutputcapability) | Camera output capability obtained. |
**Example** **Example**
```js ```js
cameraManager.getSupportedCameras().then((cameras) => { let cameraDevice = cameras[0];
let cameraDevice = cameras[0]; let cameraOutputCapability = cameraManager.getSupportedOutputCapability(cameraDevice);
cameraManager.getSupportedOutputCapability(cameraDevice).then((cameraoutputcapability) => {
console.log('Promise returned with an array of supported outputCapability');
})
})
``` ```
### isCameraMuted ### isCameraMuted
...@@ -306,9 +234,9 @@ cameraManager.muteCamera(mute); ...@@ -306,9 +234,9 @@ cameraManager.muteCamera(mute);
### createCameraInput ### createCameraInput
createCameraInput(camera: CameraDevice, callback: AsyncCallback<CameraInput\>): void createCameraInput(camera: CameraDevice): CameraInput
Creates a **CameraInput** instance with the specified **CameraDevice** object. This API uses an asynchronous callback to return the result. Creates a **CameraInput** instance with the specified **CameraDevice** object. This API returns the result synchronously.
**Required permissions**: ohos.permission.CAMERA **Required permissions**: ohos.permission.CAMERA
...@@ -318,58 +246,32 @@ Creates a **CameraInput** instance with the specified **CameraDevice** object. T ...@@ -318,58 +246,32 @@ Creates a **CameraInput** instance with the specified **CameraDevice** object. T
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | ------------------------------------------- | ---- | --------------------------------- | | -------- | ------------------------------------------- | ---- | --------------------------------- |
| cameraDevice | [CameraDevice](#cameradevice) | Yes | Target **CameraDevice** object, which is obtained through **getSupportedCameras**. | | cameraDevice | [CameraDevice](#cameradevice) | Yes | Target **CameraDevice** object, which is obtained through **getSupportedCameras**. |
| callback | AsyncCallback<[CameraInput](#camerainput)\> | Yes | Callback used to return the **CameraInput** instance. |
**Example**
```js
let cameraDevice = cameras[0];
cameraManager.createCameraInput(cameraDevice, (err, cameraInput) => {
if (err) {
console.error(`Failed to create the CameraInput instance. ${err.message}`);
return;
}
console.log('Callback returned with the CameraInput instance.');
})
```
### createCameraInput
createCameraInput(cameraDevice: CameraDevice): Promise<CameraInput\>
Creates a **CameraInput** instance with the specified **CameraDevice** object. This API uses a promise to return the result.
**Required permissions**: ohos.permission.CAMERA
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | ----------------------------- | ---- | ---------- |
| cameraDevice | [CameraDevice](#cameradevice) | Yes | Target **CameraDevice** object, which is obtained through **getSupportedCameras**.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------------------------- | ------------------------------------ | | ---------- | ----------------------------- |
| Promise<[CameraInput](#camerainput)\> | Promise used to return the **CameraInput** instance.| | [CameraInput](#camerainput) | **CameraInput** instance created. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
let cameraDevice = cameras[0]; let cameraDevice = cameras[0];
cameraManager.createCameraInput(cameraDevice).then((cameraInput) => { let cameraInput;
console.log('Promise returned with the CameraInput instance'); try {
}) cameraInput = cameraManager.createCameraInput(cameraDevice);
} catch (error) {
// If the operation fails, error.code is returned and processed.
console.log(error.code);
}
``` ```
### createCameraInput ### createCameraInput
createCameraInput(position: CameraPosition, type: CameraType, callback: AsyncCallback<CameraInput\>): void createCameraInput(position: CameraPosition, type: CameraType): CameraInput
Creates a **CameraInput** instance with the specified camera position and type. This API uses an asynchronous callback to return the result. Creates a **CameraInput** instance with the specified camera position and type. This API returns the result synchronously.
**Required permissions**: ohos.permission.CAMERA **Required permissions**: ohos.permission.CAMERA
...@@ -381,45 +283,12 @@ Creates a **CameraInput** instance with the specified camera position and type. ...@@ -381,45 +283,12 @@ Creates a **CameraInput** instance with the specified camera position and type.
| -------- | ------------------------------------------- | ---- | --------------------------------- | | -------- | ------------------------------------------- | ---- | --------------------------------- |
| position | [CameraPosition](#cameraposition) | Yes | Camera position, which is obtained through **getSupportedCameras**. This API obtains a **CameraDevice** object, which contains the camera position information. | | position | [CameraPosition](#cameraposition) | Yes | Camera position, which is obtained through **getSupportedCameras**. This API obtains a **CameraDevice** object, which contains the camera position information. |
| type | [CameraType](#cameratype) | Yes | Camera type, which is obtained through **getSupportedCameras**. This API obtains a **CameraDevice** object, which contains the camera type information. | | type | [CameraType](#cameratype) | Yes | Camera type, which is obtained through **getSupportedCameras**. This API obtains a **CameraDevice** object, which contains the camera type information. |
| callback | AsyncCallback<[CameraInput](#camerainput)\> | Yes | Callback used to return the **CameraInput** instance. |
**Example**
```js
let cameraDevice = cameras[0];
let position = cameraDevice.cameraPosition;
let type = cameraDevice.cameraType;
cameraManager.createCameraInput(position, type, (err, cameraInput) => {
if (err) {
console.error(`Failed to create the CameraInput instance. ${err.message}`);
return;
}
console.log('Callback returned with the CameraInput instance');
})
```
### createCameraInput
createCameraInput(position: CameraPosition, type:CameraType ): Promise<CameraInput\>
Creates a **CameraInput** instance with the specified camera position and type. This API uses a promise to return the result.
**Required permissions**: ohos.permission.CAMERA
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | --------------------------------- | ---- | ------------ |
| position | [CameraPosition](#cameraposition) | Yes | Camera position, which is obtained through **getSupportedCameras**. This API obtains a **CameraDevice** object, which contains the camera position information. |
| type | [CameraType](#cameratype) | Yes | Camera type, which is obtained through **getSupportedCameras**. This API obtains a **CameraDevice** object, which contains the camera type information. |
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------------------------- | ------------------------------------ | | ---------- | ----------------------------- |
| Promise<[CameraInput](#camerainput)\> | Promise used to return the **CameraInput** instance.| | [CameraInput](#camerainput) | **CameraInput** instance created. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
...@@ -427,16 +296,20 @@ Creates a **CameraInput** instance with the specified camera position and type. ...@@ -427,16 +296,20 @@ Creates a **CameraInput** instance with the specified camera position and type.
let cameraDevice = cameras[0]; let cameraDevice = cameras[0];
let position = cameraDevice.cameraPosition; let position = cameraDevice.cameraPosition;
let type = cameraDevice.cameraType; let type = cameraDevice.cameraType;
cameraManager.createCameraInput(position, type).then((cameraInput) => { let cameraInput;
console.log('Promise returned with the CameraInput instance'); try {
}) cameraInput = cameraManager.createCameraInput(position, type);
} catch (error) {
// If the operation fails, error.code is returned and processed.
console.log(error.code);
}
``` ```
### createPreviewOutput ### createPreviewOutput
createPreviewOutput(profile: Profile, surfaceId: string, callback: AsyncCallback<PreviewOutput\>): void createPreviewOutput(profile: Profile, surfaceId: string): PreviewOutput
Creates a **PreviewOutput** instance. This API uses an asynchronous callback to return the result. Creates a **PreviewOutput** instance. This API returns the result synchronously.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
...@@ -446,56 +319,31 @@ Creates a **PreviewOutput** instance. This API uses an asynchronous callback to ...@@ -446,56 +319,31 @@ Creates a **PreviewOutput** instance. This API uses an asynchronous callback to
| -------- | ----------------------------------------------- | ---- | ------------------------------- | | -------- | ----------------------------------------------- | ---- | ------------------------------- |
| profile | [Profile](#profile) | Yes | Supported preview profiles, which are obtained through **getSupportedOutputCapability**.| | profile | [Profile](#profile) | Yes | Supported preview profiles, which are obtained through **getSupportedOutputCapability**.|
| surfaceId| string | Yes | Surface ID, which is obtained from [XComponent](../arkui-ts/ts-basic-components-xcomponent.md) or [ImageReceiver](js-apis-image.md#imagereceiver9).| | surfaceId| string | Yes | Surface ID, which is obtained from [XComponent](../arkui-ts/ts-basic-components-xcomponent.md) or [ImageReceiver](js-apis-image.md#imagereceiver9).|
| callback | AsyncCallback<[PreviewOutput](#previewoutput)\> | Yes | Callback used to return the **PreviewOutput** instance.|
**Example**
```js
let profile = cameraoutputcapability.previewProfiles[0];
cameraManager.createPreviewOutput(profile, surfaceId, (err, previewOutput) => {
if (err) {
console.error(`Failed to gcreate previewOutput. ${err.message}`);
return;
}
console.log('Callback returned with previewOutput created.');
})
```
### createPreviewOutput
createPreviewOutput(profile: Profile, surfaceId: string): Promise<PreviewOutput\>
Creates a **PreviewOutput** instance. This API uses a promise to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | ---------------------------------| ---- | ----------------- |
| profile | [Profile](#profile) | Yes | Supported preview profiles, which are obtained through **getSupportedOutputCapability**.|
| surfaceId| string | Yes | Surface ID, which is obtained from [XComponent](../arkui-ts/ts-basic-components-xcomponent.md) or [ImageReceiver](js-apis-image.md#imagereceiver9).|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ---------------------------------------- | ---------------------------------------- | | ---------- | ----------------------------- |
| Promise<[PreviewOutput](#previewoutput)\> | Promise used to return the **PreviewOutput** instance. | | [PreviewOutput](#previewoutput) | **PreviewOutput** instance created. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
let profile = cameraoutputcapability.previewProfiles[0]; let profile = cameraOutputCapability.previewProfiles[0];
cameraManager.createPreviewOutput(profile, surfaceId).then((previewOutput) => { let previewOutput;
console.log('Promise returned with previewOutput created.'); try {
}) previewOutput = cameraManager.createPreviewOutput(profile, surfaceId);
} catch (error) {
// If the operation fails, error.code is returned and processed.
console.log(error.code);
}
``` ```
### createPhotoOutput ### createPhotoOutput
createPhotoOutput(profile: Profile, surfaceId: string, callback: AsyncCallback<PhotoOutput\>): void createPhotoOutput(profile: Profile, surfaceId: string): PhotoOutput
Creates a **PhotoOutput** instance. This API uses an asynchronous callback to return the result. Creates a **PhotoOutput** instance. This API returns the result synchronously.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
...@@ -505,56 +353,31 @@ Creates a **PhotoOutput** instance. This API uses an asynchronous callback to re ...@@ -505,56 +353,31 @@ Creates a **PhotoOutput** instance. This API uses an asynchronous callback to re
| -------- | ------------------------------------------- | ---- | ----------------------------------- | | -------- | ------------------------------------------- | ---- | ----------------------------------- |
| profile | [Profile](#profile) | Yes | Supported shooting profiles, which are obtained through **getSupportedOutputCapability**.| | profile | [Profile](#profile) | Yes | Supported shooting profiles, which are obtained through **getSupportedOutputCapability**.|
| surfaceId| string | Yes | Surface ID, which is obtained from [ImageReceiver](js-apis-image.md#imagereceiver9).| | surfaceId| string | Yes | Surface ID, which is obtained from [ImageReceiver](js-apis-image.md#imagereceiver9).|
| callback | AsyncCallback<[PhotoOutput](#photooutput)\> | Yes | Callback used to return the **PhotoOutput** instance. |
**Example**
```js
let profile = cameraoutputcapability.photoProfiles[0];
cameraManager.createPhotoOutput(profile, surfaceId, (err, photoOutput) => {
if (err) {
console.error(`Failed to create photoOutput. ${err.message}`);
return;
}
console.log('Callback returned with photoOutput created.');
})
```
### createPhotoOutput
createPhotoOutput(profile: Profile, surfaceId: string): Promise<PhotoOutput\>
Creates a **PhotoOutput** instance. This API uses a promise to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | ---------------------------------| ---- | ----------- |
| profile | [Profile](#profile) | Yes | Supported shooting profiles, which are obtained through **getSupportedOutputCapability**.|
| surfaceId| string | Yes | Surface ID, which is obtained from [ImageReceiver](js-apis-image.md#imagereceiver9).|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------------------------- | -------------------------------------- | | ---------- | ----------------------------- |
| Promise<[PhotoOutput](#photooutput)\> | Promise used to return the **PhotoOutput** instance. | | [PhotoOutput](#photooutput) | **PhotoOutput** instance created. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
let profile = cameraoutputcapability.photoProfiles[0]; let profile = cameraOutputCapability.photoProfiles[0];
cameraManager.createPhotoOutput(profile, surfaceId).then((photoOutput) => { let photoOutput;
console.log('Promise returned with photoOutput created.'); try {
}) photoOutput = cameraManager.createPhotoOutput(profile, surfaceId);
} catch (error) {
// If the operation fails, error.code is returned and processed.
console.log(error.code);
}
``` ```
### createVideoOutput ### createVideoOutput
createVideoOutput(profile: VideoProfile, surfaceId: string, callback: AsyncCallback<VideoOutput\>): void createVideoOutput(profile: VideoProfile, surfaceId: string): VideoOutput
Creates a **VideoOutput** instance. This API uses an asynchronous callback to return the result. Creates a **VideoOutput** instance. This API returns the result synchronously.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
...@@ -564,56 +387,31 @@ Creates a **VideoOutput** instance. This API uses an asynchronous callback to re ...@@ -564,56 +387,31 @@ Creates a **VideoOutput** instance. This API uses an asynchronous callback to re
| -------- | ------------------------------------------- | ---- | ------------------------------ | | -------- | ------------------------------------------- | ---- | ------------------------------ |
| profile | [VideoProfile](#videoprofile) | Yes | Supported video recording profiles, which are obtained through **getSupportedOutputCapability**.| | profile | [VideoProfile](#videoprofile) | Yes | Supported video recording profiles, which are obtained through **getSupportedOutputCapability**.|
| surfaceId| string | Yes | Surface ID, which is obtained from [VideoRecorder](js-apis-media.md#videorecorder9).| | surfaceId| string | Yes | Surface ID, which is obtained from [VideoRecorder](js-apis-media.md#videorecorder9).|
| callback | AsyncCallback<[VideoOutput](#videooutput)\> | Yes | Callback used to return the **VideoOutput** instance.|
**Example**
```js
let profile = cameraoutputcapability.videoProfiles[0];
cameraManager.createVideoOutput(profile, surfaceId, (err, videoOutput) => {
if (err) {
console.error(`Failed to create videoOutput. ${err.message}`);
return;
}
console.log('Callback returned with an array of supported outputCapability' );
})
```
### createVideoOutput
createVideoOutput(profile: VideoProfile, surfaceId: string): Promise<VideoOutput\>
Creates a **VideoOutput** instance. This API uses a promise to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | ---------------------------------| ---- | ---------- |
| profile | [VideoProfile](#videoprofile) | Yes | Supported video recording profiles, which are obtained through **getSupportedOutputCapability**.|
| surfaceId| string | Yes | Surface ID, which is obtained from [VideoRecorder](js-apis-media.md#videorecorder9).|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------------------------- | -------------------------------------- | | ---------- | ----------------------------- |
| Promise<[VideoOutput](#videooutput)\> | Promise used to return the **VideoOutput** instance. | | [VideoOutput](#videooutput) | **VideoOutput** instance created. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
let profile = cameraoutputcapability.videoProfiles[0]; let profile = cameraOutputCapability.videoProfiles[0];
cameraManager.createVideoOutput(profile, surfaceId).then((videoOutput) => { let videoOutput;
console.log('Promise returned with videoOutput created.'); try {
}) videoOutput = cameraManager.createVideoOutput(profile, surfaceId);
} catch (error) {
// If the operation fails, error.code is returned and processed.
console.log(error.code);
}
``` ```
### createMetadataOutput ### createMetadataOutput
createMetadataOutput(metadataObjectTypes:Array<MetadataObjectType\>, callback: AsyncCallback<MetadataOutput\>): void createMetadataOutput(metadataObjectTypes:Array<MetadataObjectType\>): MetadataOutput
Creates a **MetadataOutput** instance. This API uses an asynchronous callback to return the result. Creates a **MetadataOutput** instance. This API returns the result synchronously.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
...@@ -622,96 +420,50 @@ Creates a **MetadataOutput** instance. This API uses an asynchronous callback to ...@@ -622,96 +420,50 @@ Creates a **MetadataOutput** instance. This API uses an asynchronous callback to
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------------------- | -------------------------------------------------- | --- | ---------------------------- | | -------------------- | -------------------------------------------------- | --- | ---------------------------- |
| metadataObjectTypes | Array<[MetadataObjectType](#metadataobjecttype)\> | Yes | Metadata object types, which are obtained through **getSupportedOutputCapability**.| | metadataObjectTypes | Array<[MetadataObjectType](#metadataobjecttype)\> | Yes | Metadata object types, which are obtained through **getSupportedOutputCapability**.|
| callback | AsyncCallback<[MetadataOutput](#metadataoutput)\> | Yes | Callback used to return the **MetadataOutput** instance. |
**Example**
```js
let metadataObjectTypes = cameraoutputcapability.supportedMetadataObjectTypes;
cameraManager.createMetadataOutput(metadataObjectTypes, (err, metadataOutput) => {
if (err) {
console.error(`Failed to create metadataOutput. ${err.message}`);
return;
}
console.log('Callback returned with metadataOutput created.');
})
```
### createMetadataOutput
createMetadataOutput(metadataObjectTypes:Array<MetadataObjectType\>): Promise<MetadataOutput\>
Creates a **MetadataOutput** instance. This API uses a promise to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------------------- | -------------------------------------------------- | --- | -------------------- |
| metadataObjectTypes | Array<[MetadataObjectType](#metadataobjecttype)\> | Yes | Metadata object types, which are obtained through **getSupportedOutputCapability**. |
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------------------------------ | ----------------------------------------- | | ---------- | ----------------------------- |
| Promise<[MetadataOutput](#metadataoutput)\> | Promise used to return the **MetadataOutput** instance.| | [MetadataOutput](#metadataoutput) | **MetadataOutput** instance created. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example**
```js
let metadataObjectTypes = cameraoutputcapability.supportedMetadataObjectTypes;
cameraManager.createMetadataOutput(metadataObjectTypes).then((metadataOutput) => {
console.log('Promise returned with metadataOutput created.');
})
```
### createCaptureSession
createCaptureSession(callback: AsyncCallback<CaptureSession\>): void
Creates a **CaptureSession** instance. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory | Description |
| -------------------- | ----------------------------------------- | ----------- | ---------------------------- |
| callback | AsyncCallback<[CaptureSession](#capturesession)\> | Yes | Callback used to return the **CaptureSession** instance.|
**Example** **Example**
```js ```js
cameraManager.createCaptureSession((err, captureSession) => { let metadataObjectTypes = cameraOutputCapability.supportedMetadataObjectTypes;
if (err) { let metadataOutput;
console.error(`Failed to create captureSession. ${err.message}`); try {
return; metadataOutput = cameraManager.createMetadataOutput(metadataObjectTypes);
} } catch (error) {
console.log('Callback returned with captureSession created.'); // If the operation fails, error.code is returned and processed.
}) console.log(error.code);
}
``` ```
### createCaptureSession ### createCaptureSession
createCaptureSession(): Promise<CaptureSession\> createCaptureSession(): CaptureSession
Creates a **CaptureSession** instance. This API uses a promise to return the result. Creates a **CaptureSession** instance. This API returns the result synchronously.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------------------------------- | ---------------------------------------- | | ---------- | ----------------------------- |
| Promise<[CaptureSession](#capturesession)\> | Promise used to return the **CaptureSession** instance.| | [CaptureSession](#capturesession) | **CaptureSession** instance created. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
cameraManager.createCaptureSession().then((captureSession) => { let captureSession;
console.log('Promise returned with captureSession created.'); try {
}) captureSession = cameraManager.createCaptureSession();
} catch (error) {
// If the operation fails, error.code is returned and processed.
console.log(error.code);
}
``` ```
### on('cameraStatus') ### on('cameraStatus')
...@@ -726,17 +478,13 @@ Listens for camera status changes. This API uses an asynchronous callback to ret ...@@ -726,17 +478,13 @@ Listens for camera status changes. This API uses an asynchronous callback to ret
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | ----------------------------------------------------- | ---- | --------- | | -------- | ----------------------------------------------------- | ---- | --------- |
| type | string | Yes | Event type. The value is fixed at **'cameraStatus'**, indicating the camera status change event.| | type | string | Yes | Event type. The value is fixed at **'cameraStatus'**. The callback function returns the camera information, including the device and device status (available or unavailable). The event can be listened for only when a **CameraManager** instance is obtained.|
| callback | AsyncCallback<[CameraStatusInfo](#camerastatusinfo)\> | Yes | Callback used to return the camera status change. | | callback | AsyncCallback<[CameraStatusInfo](#camerastatusinfo)\> | Yes | Callback used to return the camera status change. |
**Example** **Example**
```js ```js
cameraManager.on('cameraStatus', (err, cameraStatusInfo) => { cameraManager.on('cameraStatus', (cameraStatusInfo) => {
if (err) {
console.error(`Failed to get cameraStatus callback. ${err.message}`);
return;
}
console.log(`camera : ${cameraStatusInfo.camera.cameraId}`); console.log(`camera : ${cameraStatusInfo.camera.cameraId}`);
console.log(`status: ${cameraStatusInfo.status}`); console.log(`status: ${cameraStatusInfo.status}`);
}) })
...@@ -756,17 +504,14 @@ This is a system API. ...@@ -756,17 +504,14 @@ This is a system API.
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | --------------- | ---- | --------- | | -------- | --------------- | ---- | --------- |
| type | string | Yes | Event type. The value is fixed at **'cameraMute'**, indicating the camera mute status change event.| | type | string | Yes | Event type. The value is fixed at **'cameraMute'**. The callback function returns the mute status changes. The event can be listened for only when a **CameraManager** instance is obtained.|
| callback | AsyncCallback\<boolean> | Yes | Callback used to return the camera mute status. | | callback | AsyncCallback\<boolean> | Yes | Callback used to return the camera mute status. |
**Example** **Example**
```js ```js
cameraManager.on('cameraMute', (err, curMuetd) => { cameraManager.on('cameraMute', (curMuetd) => {
if (err) { let isMuted = curMuetd;
console.error(`Failed to get cameraMute callback. ${err.message}`);
return;
}
}) })
``` ```
...@@ -801,7 +546,7 @@ Enumerates the camera types. ...@@ -801,7 +546,7 @@ Enumerates the camera types.
| Name | Value | Description | | Name | Value | Description |
| ----------------------- | ---- | -------------- | | ----------------------- | ---- | -------------- |
| CAMERA_TYPE_UNSPECIFIED | 0 | Unspecified camera type. | | CAMERA_TYPE_DEFAULT | 0 | Unspecified camera type. |
| CAMERA_TYPE_WIDE_ANGLE | 1 | Wide camera. | | CAMERA_TYPE_WIDE_ANGLE | 1 | Wide camera. |
| CAMERA_TYPE_ULTRA_WIDE | 2 | Ultra wide camera. | | CAMERA_TYPE_ULTRA_WIDE | 2 | Ultra wide camera. |
| CAMERA_TYPE_TELEPHOTO | 3 | Telephoto camera. | | CAMERA_TYPE_TELEPHOTO | 3 | Telephoto camera. |
...@@ -882,14 +627,14 @@ Opens this camera. This API uses an asynchronous callback to return the result. ...@@ -882,14 +627,14 @@ Opens this camera. This API uses an asynchronous callback to return the result.
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | -------------------- | ---- | ------------------- | | -------- | -------------------- | ---- | ------------------- |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.| | callback | AsyncCallback<void\> | Yes | Callback used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
cameraInput.open((err) => { cameraInput.open((err) => {
if (err) { if (err) {
console.error(`Failed to open the camera. ${err.message}`); console.error(`Failed to open the camera. ${err.code}`);
return; return;
} }
console.log('Callback returned with camera opened.'); console.log('Callback returned with camera opened.');
...@@ -908,14 +653,16 @@ Opens this camera. This API uses a promise to return the result. ...@@ -908,14 +653,16 @@ Opens this camera. This API uses a promise to return the result.
| Type | Description | | Type | Description |
| -------------- | ----------------------- | | -------------- | ----------------------- |
| Promise<void\>| Promise used to return the result.| | Promise<void\>| Promise used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
cameraInput.open().then(() => { cameraInput.open().then(() => {
console.log('Promise returned with camera opened.'); console.log('Promise returned with camera opened.');
}) }).catch((err) => {
console.error(`Failed to open the camera. ${err.code}`);
});
``` ```
### close ### close
...@@ -930,14 +677,14 @@ Closes this camera. This API uses an asynchronous callback to return the result. ...@@ -930,14 +677,14 @@ Closes this camera. This API uses an asynchronous callback to return the result.
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | -------------------- | ---- | -------------------- | | -------- | -------------------- | ---- | -------------------- |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.| | callback | AsyncCallback<void\> | Yes | Callback used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
cameraInput.close((err) => { cameraInput.close((err) => {
if (err) { if (err) {
console.error(`Failed to close the cameras. ${err.message}`); console.error(`Failed to close the cameras. ${err.code}`);
return; return;
} }
console.log('Callback returned with camera closed.'); console.log('Callback returned with camera closed.');
...@@ -963,111 +710,39 @@ Closes this camera. This API uses a promise to return the result. ...@@ -963,111 +710,39 @@ Closes this camera. This API uses a promise to return the result.
```js ```js
cameraInput.close().then(() => { cameraInput.close().then(() => {
console.log('Promise returned with camera closed.'); console.log('Promise returned with camera closed.');
}) }).catch((err) => {
console.error(`Failed to close the cameras. ${err.code}`);
});
``` ```
### release ### on('error')
release\(callback: AsyncCallback<void\>\): void on(type: 'error', cameraDevice:CameraDevice, callback: ErrorCallback<BusinessError\>): void
Releases this camera. This API uses an asynchronous callback to return the result. Listens for **CameraInput** errors. This API uses a callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters** **Parameters**
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | -------------------- | ---- | ------------------- | | -------- | -------------------------------- | --- | ------------------------------------------- |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.| | type | string | Yes | Event type. The value is fixed at **'error'**. The callback function returns an error code, for example, an error code indicating that the device is unavailable or a conflict occurs. The event can be listened for only when a **CameraInput** instance is obtained.|
| cameraDevice | [CameraDevice](#cameradevice) | Yes | **CameraDevice** object.|
| callback | ErrorCallback<BusinessError\> | Yes | Callback used to return an error code defined in [CameraErrorCode](#cameraerrorcode). |
**Example** **Example**
```js ```js
cameraInput.release((err) => { let cameraDevice = cameras[0];
if (err) { cameraInput.on('error', cameraDevice, (error) => {
console.error(`Failed to release the CameraInput instance ${err.message}`); console.log(`Camera input error code: ${error.code}`);
return; })
}
console.log('Callback invoked to indicate that the CameraInput instance is released successfully.');
});
``` ```
### release ## FlashMode
release(): Promise<void\>
Releases this camera. This API uses a promise to return the result. Enumerates the flash modes.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Return value**
| Type | Description |
| -------------- | ----------------------- |
| Promise<void\>| Promise used to return the result.|
**Example**
```js
cameraInput.release().then(() => {
console.log('Promise returned to indicate that the CameraInput instance is released successfully.');
})
```
### on('error')
on(type: 'error', cameraDevice:CameraDevice, callback: ErrorCallback<CameraInputError\>): void
Listens for **CameraInput** errors. This API uses a callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | -------------------------------- | --- | ------------------------------------------- |
| type | string | Yes | Event type. The value is fixed at **'error'**, indicating the camera input error event.|
| cameraDevice | [CameraDevice](#cameradevice) | Yes | **CameraDevice** object.|
| callback | ErrorCallback<[CameraInputError](#camerainputerror)\> | Yes | Callback used to return the result. |
**Example**
```js
let cameraDevice = cameras[0];
cameraInput.on('error', cameraDevice, (cameraInputError) => {
console.log(`Camera input error code: ${cameraInputError.code}`);
})
```
## CameraInputErrorCode
Enumerates the error codes used for camera input.
**System capability**: SystemCapability.Multimedia.Camera.Core
| Name | Value | Description |
| ------------------------- | ---- | ---------- |
| ERROR_UNKNOWN | -1 | Unknown error.|
| ERROR_NO_PERMISSION | 0 | You do not have the required permission.|
| ERROR_DEVICE_PREEMPTED | 1 | The camera is preempted.|
| ERROR_DEVICE_DISCONNECTED | 2 | The camera is disconnected.|
| ERROR_DEVICE_IN_USE | 3 | The camera is in use.|
| ERROR_DRIVER_ERROR | 4 | Driver error. |
## CameraInputError
Defines an error object used for **[CameraInput](#camerainput)**.
**System capability**: SystemCapability.Multimedia.Camera.Core
| Name| Type | Mandatory | Description |
| ---- | --------------------------------------------- | ------------ |--------------------- |
| code | [CameraInputErrorCode](#camerainputerrorcode) | Yes |**CameraInput** error code.|
## FlashMode
Enumerates the flash modes.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
...@@ -1135,56 +810,32 @@ Implements a shooting session, which saves all **[CameraInput](#camerainput)** a ...@@ -1135,56 +810,32 @@ Implements a shooting session, which saves all **[CameraInput](#camerainput)** a
### beginConfig ### beginConfig
beginConfig\(callback: AsyncCallback<void\>\): void beginConfig(): void
Starts configuration for this **CaptureSession** instance. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | -------------------- | ---- | ------------------- |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.|
**Example**
```js
captureSession.beginConfig((err) => {
if (err) {
console.error(`Failed to start the configuration. ${err.message}`);
return;
}
console.log('Callback invoked to indicate the begin config success.');
});
```
### beginConfig
beginConfig\(\): Promise<void\>
Starts configuration for this **CaptureSession** instance. This API uses a promise to return the result. Starts configuration for the session.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
**Return value** **Return value**
| Type | Description | | Type | Description |
| -------------- | ------------------------ | | ---------- | ----------------------------- |
| Promise<void\>| Promise used to return the result.| | [CameraErrorCode](#cameraerrorcode) | If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
captureSession.beginConfig().then(() => { try {
console.log('Promise returned to indicate the begin config success.'); captureSession.beginConfig();
}) } catch (error) {
// If the operation fails, error.code is returned and processed.
console.log(error.code);
}
``` ```
### commitConfig ### commitConfig
commitConfig\(callback: AsyncCallback<void\>\): void commitConfig(callback: AsyncCallback<void\>): void
Commits the configuration for this **CaptureSession** instance. This API uses an asynchronous callback to return the result. Commits the configuration for this **CaptureSession** instance. This API uses an asynchronous callback to return the result.
...@@ -1194,14 +845,14 @@ Commits the configuration for this **CaptureSession** instance. This API uses an ...@@ -1194,14 +845,14 @@ Commits the configuration for this **CaptureSession** instance. This API uses an
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | -------------------- | ---- | -------------------- | | -------- | -------------------- | ---- | -------------------- |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.| | callback | AsyncCallback<void\> | Yes | Callback used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
captureSession.commitConfig((err) => { captureSession.commitConfig((err) => {
if (err) { if (err) {
console.error(`Failed to commit the configuration. ${err.message}`); console.log('Failed to commitConfig '+ err.code);
return; return;
} }
console.log('Callback invoked to indicate the commit config success.'); console.log('Callback invoked to indicate the commit config success.');
...@@ -1210,7 +861,7 @@ captureSession.commitConfig((err) => { ...@@ -1210,7 +861,7 @@ captureSession.commitConfig((err) => {
### commitConfig ### commitConfig
commitConfig\(\): Promise<void\> commitConfig(): Promise<void\>
Commits the configuration for this **CaptureSession** instance. This API uses a promise to return the result. Commits the configuration for this **CaptureSession** instance. This API uses a promise to return the result.
...@@ -1220,48 +871,24 @@ Commits the configuration for this **CaptureSession** instance. This API uses a ...@@ -1220,48 +871,24 @@ Commits the configuration for this **CaptureSession** instance. This API uses a
| Type | Description | | Type | Description |
| -------------- | ------------------------ | | -------------- | ------------------------ |
| Promise<void\>| Promise used to return the result.| | Promise<void\>| Promise used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
captureSession.commitConfig().then(() => { captureSession.commitConfig().then(() => {
console.log('Promise returned to indicate the commit config success.'); console.log('Promise returned to indicate the commit config success.');
}) }).catch((err) => {
``` // If the operation fails, error.code is returned and processed.
console.log('Failed to commitConfig '+ err.code);
### addInput
addInput\(cameraInput: CameraInput, callback: AsyncCallback<void\>\): void
Adds a **[CameraInput](#camerainput)** instance to this **CaptureSession**. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| ----------- | --------------------------- | ---- | ------------------------ |
| cameraInput | [CameraInput](#camerainput) | Yes | **CameraInput** instance to add.|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result. |
**Example**
```js
captureSession.addInput(cameraInput, (err) => {
if (err) {
console.error(`Failed to add the CameraInput instance. ${err.message}`);
return;
}
console.log('Callback invoked to indicate that the CameraInput instance is added.');
}); });
``` ```
### addInput ### addInput
addInput\(cameraInput: CameraInput\): Promise<void\> addInput(cameraInput: CameraInput): void
Adds a **[CameraInput](#camerainput)** instance to this **CaptureSession**. This API uses a promise to return the result. Adds a [CameraInput](#camerainput) instance to the session.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
...@@ -1273,50 +900,26 @@ Adds a **[CameraInput](#camerainput)** instance to this **CaptureSession**. This ...@@ -1273,50 +900,26 @@ Adds a **[CameraInput](#camerainput)** instance to this **CaptureSession**. This
**Return value** **Return value**
| Type | Description | | Type | Description |
| -------------- | ------------------------ | | ---------- | ----------------------------- |
| Promise<void\>| Promise used to return the result.| | [CameraErrorCode](#cameraerrorcode) | If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example**
```js
captureSession.addInput(cameraInput).then(() => {
console.log('Promise used to indicate that the CameraInput instance is added.');
})
```
### removeInput
removeInput\(cameraInput: CameraInput, callback: AsyncCallback<void\>\): void
Removes a **[CameraInput](#camerainput)** instance from this **CaptureSession**. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| ----------- | --------------------------- | ---- | ------------------------ |
| cameraInput | [CameraInput](#camerainput) | Yes | **CameraInput** instance to remove.|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result. |
**Example** **Example**
```js ```js
captureSession.removeInput(cameraInput, (err) => { try {
if (err) { captureSession.addInput(cameraInput);
console.error(`Failed to remove the CameraInput instance. ${err.message}`); } catch (error) {
return; // If the operation fails, error.code is returned and processed.
} console.log(error.code);
console.log('Callback invoked to indicate that the cameraInput instance is removed.'); }
});
``` ```
### removeInput ### removeInput
removeInput\(cameraInput: CameraInput\): Promise<void\> removeInput(cameraInput: CameraInput): void
Removes a **[CameraInput](#camerainput)** instance from this **CaptureSession**. This API uses a promise to return the result. Removes a [CameraInput](#camerainput) instance from the session.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
...@@ -1328,23 +931,26 @@ Removes a **[CameraInput](#camerainput)** instance from this **CaptureSession**. ...@@ -1328,23 +931,26 @@ Removes a **[CameraInput](#camerainput)** instance from this **CaptureSession**.
**Return value** **Return value**
| Type | Description | | Type | Description |
| -------------- | ------------------------- | | ---------- | ----------------------------- |
| Promise\<void\> | Promise used to return the result.| | [CameraErrorCode](#cameraerrorcode) | If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
captureSession.removeInput(cameraInput).then(() => { try {
console.log('Promise returned to indicate that the cameraInput instance is removed.'); captureSession.removeInput(cameraInput);
}) } catch (error) {
// If the operation fails, error.code is returned and processed.
console.log(error.code);
}
``` ```
### addOutput ### addOutput
addOutput\(previewOutput: CameraOutput, callback: AsyncCallback<void\>\): void addOutput(previewOutput: CameraOutput): void
Adds a [CameraOutput](#cameraoutput) instance to this **CaptureSession**. This API uses an asynchronous callback to return the result. Adds a [CameraOutput](#cameraoutput) instance to the session.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
...@@ -1353,53 +959,29 @@ Adds a [CameraOutput](#cameraoutput) instance to this **CaptureSession**. This A ...@@ -1353,53 +959,29 @@ Adds a [CameraOutput](#cameraoutput) instance to this **CaptureSession**. This A
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| ------------- | ------------------------------- | ---- | ------------------------ | | ------------- | ------------------------------- | ---- | ------------------------ |
| previewOutput | [PreviewOutput](#previewoutput) | Yes | **PreviewOutput** instance to add.| | previewOutput | [PreviewOutput](#previewoutput) | Yes | **PreviewOutput** instance to add.|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result. |
**Example**
```js
captureSession.addOutput(previewOutput, (err) => {
if (err) {
console.error(`Failed to add output. ${err.message}`);
return;
}
console.log('Callback returned with output added.');
})
```
### addOutput
addOutput\(previewOutput: CameraOutput\): Promise<void\>
Adds a [CameraOutput](#cameraoutput) instance to this **CaptureSession**. This API uses a promise to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| ------------- | ------------------------------- | ---- | ------------------------- |
| previewOutput | [PreviewOutput](#previewoutput) | Yes | **PreviewOutput** instance to add.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| -------------- | ----------------------- | | ---------- | ----------------------------- |
| Promise<void\>| Promise used to return the result.| | [CameraErrorCode](#cameraerrorcode) | If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
captureSession.addOutput(previewOutput).then(() => { try {
console.log('Promise returned with cameraOutput added.'); captureSession.addOutput(previewOutput);
}) } catch (error) {
// If the operation fails, error.code is returned and processed.
console.log(error.code);
}
``` ```
### removeOutput ### removeOutput
removeOutput\(previewOutput: CameraOutput, callback: AsyncCallback<void\>\): void removeOutput(previewOutput: CameraOutput): void
Removes a [CameraOutput](#cameraoutput) instance from this **CaptureSession**. This API uses an asynchronous callback to return the result. Removes a [CameraOutput](#cameraoutput) instance from the session.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
...@@ -1408,48 +990,22 @@ Removes a [CameraOutput](#cameraoutput) instance from this **CaptureSession**. T ...@@ -1408,48 +990,22 @@ Removes a [CameraOutput](#cameraoutput) instance from this **CaptureSession**. T
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| ------------- | ------------------------------- | ---- | ------------------------ | | ------------- | ------------------------------- | ---- | ------------------------ |
| previewOutput | [PreviewOutput](#previewoutput) | Yes | **PreviewOutput** instance to remove.| | previewOutput | [PreviewOutput](#previewoutput) | Yes | **PreviewOutput** instance to remove.|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result. |
**Example**
```js
captureSession.removeOutput(previewOutput, (err) => {
if (err) {
console.error(`Failed to remove the CameraOutput instance. ${err.message}`);
return;
}
console.log('Callback invoked to indicate that the CameraOutput instance is removed.');
});
```
### removeOutput
removeOutput(previewOutput: CameraOutput): Promise<void\>
Removes a [CameraOutput](#cameraoutput) instance from this **CaptureSession**. This API uses a promise to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| ------------- | ------------------------------- | ---- | ------------------------- |
| previewOutput | [PreviewOutput](#previewoutput) | Yes | **PreviewOutput** instance to remove.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| -------------- | ------------------------ | | ---------- | ----------------------------- |
| Promise<void\>| Promise used to return the result.| | [CameraErrorCode](#cameraerrorcode) | If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
captureSession.removeOutput(previewOutput).then(() => { try {
console.log('Promise returned to indicate that the CameraOutput instance is removed.'); captureSession.removeOutput(previewOutput);
}) } catch (error) {
// If the operation fails, error.code is returned and processed.
console.log(error.code);
}
``` ```
### start ### start
...@@ -1464,14 +1020,14 @@ Starts this **CaptureSession**. This API uses an asynchronous callback to return ...@@ -1464,14 +1020,14 @@ Starts this **CaptureSession**. This API uses an asynchronous callback to return
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | -------------------- | ---- | -------------------- | | -------- | -------------------- | ---- | -------------------- |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.| | callback | AsyncCallback<void\> | Yes | Callback used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
captureSession.start((err) => { captureSession.start((err) => {
if (err) { if (err) {
console.error(`Failed to start the session ${err.message}`); console.error(`Failed to start the session ${err.code}`);
return; return;
} }
console.log('Callback invoked to indicate the session start success.'); console.log('Callback invoked to indicate the session start success.');
...@@ -1497,7 +1053,9 @@ Starts this **CaptureSession**. This API uses a promise to return the result. ...@@ -1497,7 +1053,9 @@ Starts this **CaptureSession**. This API uses a promise to return the result.
```js ```js
captureSession.start().then(() => { captureSession.start().then(() => {
console.log('Promise returned to indicate the session start success.'); console.log('Promise returned to indicate the session start success.');
}) }).catch((err) => {
console.error(`Failed to start the session ${err.code}`);
});
``` ```
### stop ### stop
...@@ -1512,14 +1070,14 @@ Stops this **CaptureSession**. This API uses an asynchronous callback to return ...@@ -1512,14 +1070,14 @@ Stops this **CaptureSession**. This API uses an asynchronous callback to return
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | -------------------- | ---- | ------------------- | | -------- | -------------------- | ---- | ------------------- |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.| | callback | AsyncCallback<void\> | Yes | Callback used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
captureSession.stop((err) => { captureSession.stop((err) => {
if (err) { if (err) {
console.error(`Failed to stop the session ${err.message}`); console.error(`Failed to stop the session ${err.code}`);
return; return;
} }
console.log('Callback invoked to indicate the session stop success.'); console.log('Callback invoked to indicate the session stop success.');
...@@ -1538,14 +1096,16 @@ Stops this **CaptureSession**. This API uses a promise to return the result. ...@@ -1538,14 +1096,16 @@ Stops this **CaptureSession**. This API uses a promise to return the result.
| Type | Description | | Type | Description |
| -------------- | ----------------------- | | -------------- | ----------------------- |
| Promise<void\>| Promise used to return the result.| | Promise<void\>| Promise used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
captureSession.stop().then(() => { captureSession.stop().then(() => {
console.log('Promise returned to indicate the session stop success.'); console.log('Promise returned to indicate the session stop success.');
}) }).catch((err) => {
console.error(`Failed to stop the session ${err.code}`);
});
``` ```
### release ### release
...@@ -1560,14 +1120,14 @@ Releases this **CaptureSession**. This API uses an asynchronous callback to retu ...@@ -1560,14 +1120,14 @@ Releases this **CaptureSession**. This API uses an asynchronous callback to retu
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | -------------------- | ---- | -------------------- | | -------- | -------------------- | ---- | -------------------- |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.| | callback | AsyncCallback<void\> | Yes | Callback used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
captureSession.release((err) => { captureSession.release((err) => {
if (err) { if (err) {
console.error(`Failed to release the CaptureSession instance ${err.message}`); console.error(`Failed to release the CaptureSession instance ${err.code}`);
return; return;
} }
console.log('Callback invoked to indicate that the CaptureSession instance is released successfully.'); console.log('Callback invoked to indicate that the CaptureSession instance is released successfully.');
...@@ -1586,69 +1146,48 @@ Releases this **CaptureSession**. This API uses a promise to return the result. ...@@ -1586,69 +1146,48 @@ Releases this **CaptureSession**. This API uses a promise to return the result.
| Type | Description | | Type | Description |
| -------------- | ------------------------ | | -------------- | ------------------------ |
| Promise<void\>| Promise used to return the result.| | Promise<void\>| Promise used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
captureSession.release().then(() => { captureSession.release().then(() => {
console.log('Promise returned to indicate that the CaptureSession instance is released successfully.'); console.log('Promise returned to indicate that the CaptureSession instance is released successfully.');
}) }).catch((err) => {
console.error(`Failed to release the CaptureSession instance ${err.code}`);
});
``` ```
### hasFlash ### hasFlash
hasFlash(callback: AsyncCallback<boolean\>): void hasFlash(): boolean
Checks whether the device has flash. This API uses an asynchronous callback to return the result. Checks whether the device has flash. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | ----------------------- | ---- | -------------------------------- |
| callback | AsyncCallback<boolean\> | Yes | Callback used to return the flash support status. The value **true** means that the device has flash.|
**Example**
```js
captureSession.hasFlash((err, status) => {
if (err) {
console.error(`Failed to check whether the device has flash light. ${err.message}`);
return;
}
console.log(`Callback returned with flash light support status: ${status}`);
})
```
### hasFlash
hasFlash(): Promise<boolean\>
Checks whether the device has flash. This API uses a promise to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Return value** **Return value**
| Type | Description | | Type | Description |
| ----------------- | ----------------------------------------------- | | ---------- | ----------------------------- |
| Promise<boolean\> | Promise used to return the flash support status. The value **true** means that the device has flash.| | boolean | Returns **true** if the device has flash; returns **false** otherwise. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
captureSession.hasFlash().then((status) => { try {
console.log(`Promise returned with the flash light support status: ${status}`); let status = captureSession.hasFlash();
}) } catch (error) {
// If the operation fails, error.code is returned and processed.
console.log(error.code);
}
``` ```
### isFlashModeSupported ### isFlashModeSupported
isFlashModeSupported(flashMode: FlashMode, callback: AsyncCallback<boolean\>): void isFlashModeSupported(flashMode: FlashMode): boolean
Checks whether a specified flash mode is supported. This API uses an asynchronous callback to return the result. Checks whether a flash mode is supported.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
...@@ -1657,53 +1196,29 @@ Checks whether a specified flash mode is supported. This API uses an asynchronou ...@@ -1657,53 +1196,29 @@ Checks whether a specified flash mode is supported. This API uses an asynchronou
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| --------- | ----------------------- | ---- | --------------------------------- | | --------- | ----------------------- | ---- | --------------------------------- |
| flashMode | [FlashMode](#flashmode) | Yes | Flash mode. | | flashMode | [FlashMode](#flashmode) | Yes | Flash mode. |
| callback | AsyncCallback<boolean\> | Yes | Callback used to return the flash mode support status. The value **true** means that the flash mode is supported, and **false** means the opposite.|
**Example**
```js
captureSession.isFlashModeSupported(camera.FlashMode.FLASH_MODE_AUTO, (err, status) => {
if (err) {
console.error(`Failed to check whether the flash mode is supported. ${err.message}`);
return;
}
console.log(`Callback returned with the flash mode support status: ${status}`);
})
```
### isFlashModeSupported
isFlashModeSupported(flashMode: FlashMode): Promise<boolean\>
Checks whether a specified flash mode is supported. This API uses a promise to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| --------- | ----------------------- | ---- | ------------- |
| flashMode | [FlashMode](#flashmode) | Yes | Flash mode.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ----------------- | ---------------------------------------------------- | | ---------- | ----------------------------- |
| Promise<boolean\> | Promise used to return the flash mode support status. The value **true** means that the flash mode is supported, and **false** means the opposite.| | boolean | Returns **true** if the flash mode is supported; returns **false** otherwise. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
captureSession.isFlashModeSupported(camera.FlashMode.FLASH_MODE_AUTO).then((status) => { try {
console.log(`Promise returned with flash mode support status.${status}`); let status = captureSession.isFlashModeSupported(camera.FlashMode.FLASH_MODE_AUTO);
}) } catch (error) {
// If the operation fails, error.code is returned and processed.
console.log(error.code);
}
``` ```
### setFlashMode ### setFlashMode
setFlashMode(flashMode: FlashMode, callback: AsyncCallback<void\>): void setFlashMode(flashMode: FlashMode): void
Sets the flash mode. This API uses an asynchronous callback to return the result. Sets a flash mode for the device.
Before the setting, do the following checks: Before the setting, do the following checks:
...@@ -1716,134 +1231,55 @@ Before the setting, do the following checks: ...@@ -1716,134 +1231,55 @@ Before the setting, do the following checks:
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| --------- | ----------------------- | ---- | --------------------- | | --------- | ----------------------- | ---- | --------------------- |
| flashMode | [FlashMode](#flashmode) | Yes | Flash mode. | | flashMode | [FlashMode](#flashmode) | Yes | Flash mode. |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.|
**Return value**
| Type | Description |
| ---------- | ----------------------------- |
| [CameraErrorCode](#cameraerrorcode) | If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
captureSession.setFlashMode(camera.FlashMode.FLASH_MODE_AUTO, (err) => { try {
if (err) { captureSession.setFlashMode(camera.FlashMode.FLASH_MODE_AUTO);
console.error(`Failed to set the flash mode ${err.message}`); } catch (error) {
return; // If the operation fails, error.code is returned and processed.
} console.log(error.code);
console.log('Callback returned with the successful execution of setFlashMode.'); }
})
``` ```
### setFlashMode ### getFlashMode
setFlashMode(flashMode: FlashMode): Promise<void\> getFlashMode(): FlashMode
Sets a flash mode. This API uses a promise to return the result. Obtains the flash mode in use.
Before the setting, do the following checks:
1. Use **[hasFlash](#hasflash)** to check whether the device has flash.
2. Use **[isFlashModeSupported](#isflashmodesupported)** to check whether the device supports the flash mode.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| --------- | ----------------------- | ---- | ------------- |
| flashMode | [FlashMode](#flashmode) | Yes | Flash mode.|
**Return value**
| Type | Description |
| -------------- | ------------------------ |
| Promise<void\>| Promise used to return the result.|
**Example**
```js
captureSession.setFlashMode(camera.FlashMode.FLASH_MODE_AUTO).then(() => {
console.log('Promise returned with the successful execution of setFlashMode.');
})
```
### getFlashMode
getFlashMode(callback: AsyncCallback<FlashMode\>): void
Obtains the flash mode in use. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | --------------------------------------- | ---- | --------------------------------- |
| callback | AsyncCallback<[FlashMode](#flashmode)\> | Yes | Callback used to return the flash mode.|
**Example**
```js
captureSession.getFlashMode((err, flashMode) => {
if (err) {
console.error(`Failed to get the flash mode ${err.message}`);
return;
}
console.log(`Callback returned with current flash mode: ${flashMode}`);
})
```
### getFlashMode
getFlashMode(): Promise<FlashMode\>
Obtains the flash mode in use. This API uses a promise to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
**Return value** **Return value**
| Type | Description | | Type | Description |
| --------------------------------- | --------------------------------- | | ---------- | ----------------------------- |
| Promise<[FlashMode](#flashmode)\> | Promise used to return the flash mode.| | [FlashMode](#flashmode) | Flash mode obtained. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example**
```js
captureSession.getFlashMode().then((flashMode) => {
console.log(`Promise returned with current flash mode : ${flashMode}`);
})
```
### isExposureModeSupported
isExposureModeSupported(aeMode: ExposureMode, callback: AsyncCallback<boolean\>): void;
Checks whether a specified exposure mode is supported. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory | Description |
| -------- | -------------------------------| ---- | ----------------------------- |
| aeMode | [ExposureMode](#exposuremode) | Yes | Exposure mode. |
| callback | AsyncCallback<boolean\> | Yes | Callback used to return the exposure mode support status. The value **true** means that the exposure mode is supported, and **false** means the opposite.|
**Example** **Example**
```js ```js
captureSession.isExposureModeSupported(camera.ExposureMode.EXPOSURE_MODE_LOCKED,(err) => { try {
if (err) { let flashMode = captureSession.getFlashMode();
console.log(`Failed to check exposure mode supported ${err.message}`); } catch (error) {
return ; // If the operation fails, error.code is returned and processed.
} console.log(error.code);
console.log('Callback returned with the successful execution of isExposureModeSupported'); }
})
``` ```
### isExposureModeSupported ### isExposureModeSupported
isExposureModeSupported(aeMode: ExposureMode): Promise<boolean\> isExposureModeSupported(aeMode: ExposureMode): boolean;
Checks whether a specified exposure mode is supported. This API uses a promise to return the result. Checks whether an exposure mode is supported.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
...@@ -1855,71 +1291,51 @@ Checks whether a specified exposure mode is supported. This API uses a promise t ...@@ -1855,71 +1291,51 @@ Checks whether a specified exposure mode is supported. This API uses a promise t
**Return value** **Return value**
| Name | Description | | Type | Description |
| ----------------- |--------------------------------- | | ---------- | ----------------------------- |
| Promise<boolean\> | Promise used to return the exposure mode support status. The value **true** means that the exposure mode is supported, and **false** means the opposite.| | boolean | Returns **true** if the exposure mode is supported; returns **false** otherwise. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example**
```js
captureSession.isExposureModeSupported(camera.ExposureMode.EXPOSURE_MODE_LOCKED).then((isSupported) => {
console.log(`Promise returned with exposure mode supported : ${isSupported}`);
})
```
### getExposureMode
getExposureMode(callback: AsyncCallback<ExposureMode\>): void
Obtains the exposure mode in use. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | -------------------------------| ---- | ---------------------------------------- |
| callback | AsyncCallback<[ExposureMode](#exposuremode)\> | Yes | Callback used to return the exposure mode.|
**Example** **Example**
```js ```js
captureSession.getExposureMode((err, exposureMode) => { try {
if (err) { let isSupported = captureSession.isExposureModeSupported(camera.ExposureMode.EXPOSURE_MODE_LOCKED);
console.log(`Failed to get the exposure mode ${err.message}`); } catch (error) {
return ; // If the operation fails, error.code is returned and processed.
} console.log(error.code);
console.log(`Callback returned with current exposure mode: ${exposureMode}`); }
})
``` ```
### getExposureMode ### getExposureMode
getExposureMode(): Promise<ExposureMode\> getExposureMode(): ExposureMode
Obtains the exposure mode in use. This API uses a promise to return the result. Obtains the exposure mode in use.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
**Return value** **Return value**
| Name | Description | | Type | Description |
| --------------------------------------- |------------------------------- | | ---------- | ----------------------------- |
| Promise<[ExposureMode](#exposuremode)\> | Promise used to return the exposure mode.| | [ExposureMode](#exposuremode) | Exposure mode obtained. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
captureSession.getExposureMode().then((exposureMode) => { try {
console.log(`Promise returned with current exposure mode : ${exposureMode}`); let exposureMode = captureSession.getExposureMode();
}) } catch (error) {
// If the operation fails, error.code is returned and processed.
console.log(error.code);
}
``` ```
### setExposureMode ### setExposureMode
setExposureMode(aeMode: ExposureMode, callback: AsyncCallback<void\>): void setExposureMode(aeMode: ExposureMode): void
Sets an exposure mode. This API uses an asynchronous callback to return the result. Sets an exposure mode for the device.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
...@@ -1928,124 +1344,54 @@ Sets an exposure mode. This API uses an asynchronous callback to return the resu ...@@ -1928,124 +1344,54 @@ Sets an exposure mode. This API uses an asynchronous callback to return the resu
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | -------------------------------| ---- | ----------------------- | | -------- | -------------------------------| ---- | ----------------------- |
| aeMode | [ExposureMode](#exposuremode) | Yes | Exposure mode. | | aeMode | [ExposureMode](#exposuremode) | Yes | Exposure mode. |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.|
**Example**
```js
captureSession.setExposureMode(camera.ExposureMode.EXPOSURE_MODE_LOCKED,(err) => {
if (err) {
console.log(`Failed to set the exposure mode ${err.message}`);
return ;
}
console.log('Callback returned with the successful execution of setExposureMode');
})
```
### setExposureMode
setExposureMode(aeMode: ExposureMode): Promise<void\>
Sets an exposure mode. This API uses a promise to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Return value** **Return value**
| Name | Description | | Type | Description |
| ----------------- |---------------------------- | | ---------- | ----------------------------- |
| Promise<void\> | Promise used to return the result.| | [CameraErrorCode](#cameraerrorcode) | If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example**
```js
captureSession.setExposureMode(camera.ExposureMode.EXPOSURE_MODE_LOCKED).then(() => {
console.log('Promise returned with the successful execution of setExposureMode.');
})
```
### getMeteringPoint
getMeteringPoint(callback: AsyncCallback<Point\>): void
Obtains the center of the metering area. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | -------------------------------| ---- | ------------------------ |
| callback | AsyncCallback<[Point](#point)\>| Yes | Callback used to return the center of the metering area.|
**Example** **Example**
```js ```js
captureSession.getMeteringPoint((err, exposurePoint) => { try {
if (err) { captureSession.setExposureMode(camera.ExposureMode.EXPOSURE_MODE_LOCKED);
console.log(`Failed to get the current exposure point ${err.message}`); } catch (error) {
return ; // If the operation fails, error.code is returned and processed.
} console.log(error.code);
console.log(`Callback returned with current exposure point: ${exposurePoint}`); }
})
``` ```
### getMeteringPoint ### getMeteringPoint
getMeteringPoint(): Promise<Point\> getMeteringPoint(): Point
Obtains the center of the metering area. This API uses a promise to return the result. Obtains the metering point of the device.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
**Return value** **Return value**
| Name | Description | | Type | Description |
| ------------------------- |----------------------------- | | ---------- | ----------------------------- |
| Promise<[Point](#point)\> | Promise used to return the center of the metering area.| | [Point](#point) | Metering point obtained. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example**
```js
captureSession.getMeteringPoint().then((exposurePoint) => {
console.log(`Promise returned with current exposure point : ${exposurePoint}`);
})
```
### setMeteringPoint
setMeteringPoint(point: Point, callback: AsyncCallback<void\>): void
Sets the center of the metering area. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| ------------- | -------------------------------| ---- | ------------------- |
| exposurePoint | [Point](#point) | Yes | Exposure point. |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.|
**Example** **Example**
```js ```js
const Point1 = {x: 1, y: 1}; try {
let exposurePoint = captureSession.getMeteringPoint();
captureSession.setMeteringPoint(Point1,(err) => { } catch (error) {
if (err) { // If the operation fails, error.code is returned and processed.
console.log(`Failed to set the exposure point ${err.message}`); console.log(error.code);
return ; }
}
console.log('Callback returned with the successful execution of setMeteringPoint');
})
``` ```
### setMeteringPoint ### setMeteringPoint
setMeteringPoint(point: Point): Promise<void\> setMeteringPoint(point: Point): void
Sets the center of the metering area. This API uses a promise to return the result. Sets the metering point for the device.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
...@@ -2057,73 +1403,52 @@ Sets the center of the metering area. This API uses a promise to return the resu ...@@ -2057,73 +1403,52 @@ Sets the center of the metering area. This API uses a promise to return the resu
**Return value** **Return value**
| Name | Description | | Type | Description |
| ----------------- |------------------------ | | ---------- | ----------------------------- |
| Promise<void\> | Promise used to return the center of the metering area.| | [CameraErrorCode](#cameraerrorcode) | If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example**
```js
const Point2 = {x: 2, y: 2};
captureSession.setMeteringPoint(Point2).then(() => {
console.log('Promise returned with the successful execution of setMeteringPoint');
})
```
### getExposureBiasRange
getExposureBiasRange(callback: AsyncCallback<Array<number\>\>): void
Obtains the exposure compensation values. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | -------------------------------| ---- | ----------------------------- |
| callback | AsyncCallback<Array<number\>\> | Yes | Callback used to return the array of compensation values.|
**Example** **Example**
```js ```js
captureSession.getExposureBiasRange((err, biasRangeArray) => { const exposurePoint = {x: 1, y: 1};
if (err) { try {
console.log(`Failed to get the array of compenstation range ${err.message}`); captureSession.setMeteringPoint(exposurePoint);
return ; } catch (error) {
} // If the operation fails, error.code is returned and processed.
console.log('Callback returned with the array of compenstation range: ' + JSON.stringify(biasRangeArray)); console.log(error.code);
}) }
``` ```
### getExposureBiasRange ### getExposureBiasRange
getExposureBiasRange(): Promise<Array<number\>\> getExposureBiasRange(): Array<number\>
Obtains the exposure compensation values. This API uses a promise to return the result. Obtains the exposure compensation values of the device.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
**Return value** **Return value**
| Name | Description | | Type | Description |
| ----------------- |-------------------------------------- | | ---------- | ----------------------------- |
| Promise<Array<number\>\> | Promise used to return the array of compensation values.| | Array<number\> | An array of compensation values. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
captureSession.getExposureBiasRange().then((biasRangeArray) => { try {
console.log('Promise returned with the array of compenstation range: ' + JSON.stringify(biasRangeArray)); let biasRangeArray = captureSession.getExposureBiasRange();
}) } catch (error) {
// If the operation fails, error.code is returned and processed.
console.log(error.code);
}
``` ```
### setExposureBias ### setExposureBias
setExposureBias(exposureBias: number, callback: AsyncCallback<void\>): void setExposureBias(exposureBias: number): void
Sets an exposure compensation value. This API uses an asynchronous callback to return the result. Sets an exposure compensation value for the device.
Before the setting, you are advised to use **[getExposureBiasRange](#getexposurebiasrange)** to obtain the supported values. Before the setting, you are advised to use **[getExposureBiasRange](#getexposurebiasrange)** to obtain the supported values.
...@@ -2133,106 +1458,50 @@ Before the setting, you are advised to use **[getExposureBiasRange](#getexposure ...@@ -2133,106 +1458,50 @@ Before the setting, you are advised to use **[getExposureBiasRange](#getexposure
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | -------------------------------| ---- | ------------------- | | -------- | -------------------------------| ---- | ------------------- |
| exposureBias | number | Yes | Compensation value. You can use **getExposureBiasRange** to obtain the supported values.| | exposureBias | number | Yes | Exposure bias to set, which must be within the range obtained by running **getExposureBiasRange** interface. If the API call fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.|
**Example**
```js
let exposureBias = biasRangeArray[0];
captureSession.setExposureBias(exposureBias,(err) => {
if (err) {
console.log(`Failed to set the exposure bias ${err.message}`);
return ;
}
console.log('Callback returned with the successful execution of setExposureBias');
})
```
### setExposureBias
setExposureBias(exposureBias: number): Promise<void\>
Sets an exposure compensation value. This API uses a promise to return the result.
Before the setting, you are advised to use **[getExposureBiasRange](#getexposurebiasrange)** to obtain the supported values.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------------- | --------- | ---- | --------- |
| exposureBias | number | Yes | Compensation value. You can use **getExposureBiasRange** to obtain the supported values. |
**Return value**
| Name | Description |
| ----------------- |------------------------- |
| Promise<void\> | Promise used to return the result.|
**Example** **Example**
```js ```js
let exposureBias = biasRangeArray[0]; let exposureBias = biasRangeArray[0];
captureSession.setExposureBias(exposureBias).then(() => { try {
console.log('Promise returned with the successful execution of setExposureBias.'); captureSession.setExposureBias(exposureBias);
}) } catch (error) {
``` // If the operation fails, error.code is returned and processed.
console.log(error.code);
### getExposureValue }
getExposureValue(callback: AsyncCallback<number\>): void
Obtains the exposure value in use. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | ------------------------| ---- | --------------------- |
| callback | AsyncCallback<number\> | Yes | Callback used to the exposure value.|
**Example**
```js
captureSession.getExposureValue((err, exposureValue) => {
if (err) {
console.log(`Failed to get the exposure value ${err.message}`);
return ;
}
console.log(`Callback returned with the exposure value: ${exposureValue}`);
})
``` ```
### getExposureValue ### getExposureValue
getExposureValue(): Promise<number\> getExposureValue(): number
Obtains the exposure value in use. This API uses a promise to return the result. Obtains the exposure value in use.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
**Return value** **Return value**
| Name | Description | | Type | Description |
| ----------------- |-------------------------- | | ---------- | ----------------------------- |
| Promise<number\> | Promise used to the exposure value.| | number | Exposure value obtained. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
captureSession.getExposureValue().then((exposureValue) => { try {
console.log(`Promise returned with exposure value: ${exposureValude}`); let exposureValue = captureSession.getExposureValue();
}) } catch (error) {
// If the operation fails, error.code is returned and processed.
console.log(error.code);
}
``` ```
### isFocusModeSupported ### isFocusModeSupported
isFocusModeSupported(afMode: FocusMode, callback: AsyncCallback<boolean\>): void isFocusModeSupported(afMode: FocusMode): boolean
Checks whether a specified focus mode is supported. This API uses an asynchronous callback to return the result. Checks whether a focus mode is supported.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
...@@ -2241,53 +1510,29 @@ Checks whether a specified focus mode is supported. This API uses an asynchronou ...@@ -2241,53 +1510,29 @@ Checks whether a specified focus mode is supported. This API uses an asynchronou
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | ----------------------- | ---- | -------------------------------- | | -------- | ----------------------- | ---- | -------------------------------- |
| afMode | [FocusMode](#focusmode) | Yes | Focus mode. | | afMode | [FocusMode](#focusmode) | Yes | Focus mode. |
| callback | AsyncCallback<boolean\> | Yes | Callback used to return the focus mode support status. The value **true** means that the focus mode is supported, and **false** means the opposite.|
**Example**
```js
captureSession.isFocusModeSupported(camera.FocusMode.FOCUS_MODE_AUTO, (err, status) => {
if (err) {
console.error(`Failed to check whether the focus mode is supported. ${err.message}`);
return;
}
console.log(`Callback returned with the focus mode support status: ${status}`);
})
```
### isFocusModeSupported
isFocusModeSupported(afMode: FocusMode): Promise<boolean\>
Checks whether a specified focus mode is supported. This API uses a promise to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| ------ | ----------------------- | ---- | ------------- |
| afMode | [FocusMode](#focusmode) | Yes | Focus mode.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| ----------------- | --------------------------------------------------- | | ---------- | ----------------------------- |
| Promise<boolean\> | Promise used to return the focus mode support status. The value **true** means that the focus mode is supported, and **false** means the opposite.| | boolean | Returns **true** if the focus mode is supported; returns **false** otherwise. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
captureSession.isFocusModeSupported(camera.FocusMode.FOCUS_MODE_AUTO).then((status) => { try {
console.log(`Promise returned with focus mode support status ${status}.`); let status = captureSession.isFocusModeSupported(camera.FocusMode.FOCUS_MODE_AUTO);
}) } catch (error) {
// If the operation fails, error.code is returned and processed.
console.log(error.code);
}
``` ```
### setFocusMode ### setFocusMode
setFocusMode(afMode: FocusMode, callback: AsyncCallback<void\>): void setFocusMode(afMode: FocusMode): void
Sets a focus mode. This API uses an asynchronous callback to return the result. Sets a focus mode for the device.
Before the setting, use **[isFocusModeSupported](#isfocusmodesupported)** to check whether the focus mode is supported. Before the setting, use **[isFocusModeSupported](#isfocusmodesupported)** to check whether the focus mode is supported.
...@@ -2298,132 +1543,54 @@ Before the setting, use **[isFocusModeSupported](#isfocusmodesupported)** to che ...@@ -2298,132 +1543,54 @@ Before the setting, use **[isFocusModeSupported](#isfocusmodesupported)** to che
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | ----------------------- | ---- | ------------------- | | -------- | ----------------------- | ---- | ------------------- |
| afMode | [FocusMode](#focusmode) | Yes | Focus mode. | | afMode | [FocusMode](#focusmode) | Yes | Focus mode. |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.|
**Example**
```js
captureSession.setFocusMode(camera.FocusMode.FOCUS_MODE_AUTO, (err) => {
if (err) {
console.error(`Failed to set the focus mode ${err.message}`);
return;
}
console.log('Callback returned with the successful execution of setFocusMode.');
})
```
### setFocusMode
setFocusMode(afMode: FocusMode): Promise<void\>
Sets a focus mode. This API uses a promise to return the result.
Before the setting, use **[isFocusModeSupported](#isfocusmodesupported)** to check whether the focus mode is supported.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| ------ | ----------------------- | ---- | ------------- |
| afMode | [FocusMode](#focusmode) | Yes | Focus mode.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| -------------- | ------------------------ | | ---------- | ----------------------------- |
| Promise<void\>| Promise used to return the result.| | [CameraErrorCode](#cameraerrorcode) | If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example**
```js
captureSession.setFocusMode(camera.FocusMode.FOCUS_MODE_AUTO).then(() => {
console.log('Promise returned with the successful execution of setFocusMode.');
})
```
### getFocusMode
getFocusMode(callback: AsyncCallback<FocusMode\>): void
Obtains the focus mode in use. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | --------------------------------------- | ---- | ------------------------------- |
| callback | AsyncCallback<[FocusMode](#focusmode)\> | Yes | Callback used to return the focus mode.|
**Example** **Example**
```js ```js
captureSession.getFocusMode((err, afMode) => { try {
if (err) { captureSession.setFocusMode(camera.FocusMode.FOCUS_MODE_AUTO);
console.error(`Failed to get the focus mode ${err.message}`); } catch (error) {
return; // If the operation fails, error.code is returned and processed.
} console.log(error.code);
console.log(`Callback returned with current focus mode: ${afMode}`); }
})
``` ```
### getFocusMode ### getFocusMode
getFocusMode(): Promise<FocusMode\> getFocusMode(): FocusMode
Obtains the focus mode in use. This API uses a promise to return the result. Obtains the focus mode in use.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------- | -------------------------------- | | ---------- | ----------------------------- |
| Promise<FocusMode\> | Promise used to return the focus mode.| | [FocusMode](#focusmode) | Focus mode obtained. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example**
```js
captureSession.getFocusMode().then((afMode) => {
console.log(`Promise returned with current focus mode : ${afMode}`);
})
```
### setFocusPoint
setFocusPoint(point: Point, callback: AsyncCallback<void\>): void
Sets a focus point. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | ----------------------- | ---- | ------------------- |
| point | [Point](#point) | Yes | Focal point. |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.|
**Example** **Example**
```js ```js
const Point1 = {x: 1, y: 1}; try {
let afMode = captureSession.getFocusMode();
captureSession.setFocusPoint(Point1, (err) => { } catch (error) {
if (err) { // If the operation fails, error.code is returned and processed.
console.error(`Failed to set the focus point ${err.message}`); console.log(error.code);
return; }
}
console.log('Callback returned with the successful execution of setFocusPoint.');
})
``` ```
### setFocusPoint ### setFocusPoint
setFocusPoint(point: Point): Promise<void\> setFocusPoint(point: Point): void
Sets a focal point. This API uses a promise to return the result. Sets a focal point for the device.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
...@@ -2431,173 +1598,106 @@ Sets a focal point. This API uses a promise to return the result. ...@@ -2431,173 +1598,106 @@ Sets a focal point. This API uses a promise to return the result.
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | ----------------------- | ---- | ------------------- | | -------- | ----------------------- | ---- | ------------------- |
| point | [Point](#point) | Yes | Focal point. | | Point1 | [Point](#point) | Yes | Focal point. |
**Return value** **Return value**
| Type | Description | | Type | Description |
| -------------- | ----------------------- | | ---------- | ----------------------------- |
| Promise<void\>| Promise used to return the result.| | [CameraErrorCode](#cameraerrorcode) | If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example**
```js
const Point2 = {x: 2, y: 2};
captureSession.setFocusPoint(Point2).then(() => {
console.log('Promise returned with the successful execution of setFocusPoint.');
})
```
### getFocusPoint
getFocusPoint(callback: AsyncCallback<Point\>): void
Obtains the focal point. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | ---------------------------------- | ---- | ----------------------- |
| callback | AsyncCallback<[Point](#point)\> | Yes | Callback used to return the focal point.|
**Example** **Example**
```js ```js
captureSession.getFocusPoint((err, point) => { const Point1 = {x: 1, y: 1};
if (err) { try {
console.error(`Failed to get the current focus point ${err.message}`); captureSession.setFocusPoint(Point1);
return; } catch (error) {
} // If the operation fails, error.code is returned and processed.
console.log('Callback returned with the current focus point: ' + JSON.stringify(point)); console.log(error.code);
}) }
``` ```
### getFocusPoint ### getFocusPoint
getFocusPoint(): Promise<Point\> getFocusPoint(): Point
Obtains the focal point. This API uses a promise to return the result. Obtains the focal point of the device.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
**Return value** **Return value**
| Type | Description | | Type | Description |
| --------------- | --------------------------- | | ---------- | ----------------------------- |
| Promise<Point\> | Promise used to return the focal point.| | [Point](#point) | Focal point obtained. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example**
```js
captureSession.getFocusPoint().then((point) => {
console.log('Promise returned with the current focus point: ' + JSON.stringify(point));
})
```
### getFocalLength
getFocalLength(callback: AsyncCallback<number\>): void
Obtains the focal length. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | ------------------------- | ---- | ----------------------- |
| callback | AsyncCallback<number\> | Yes | Callback used to return the focal length.|
**Example** **Example**
```js ```js
captureSession.getFocalLength((err, focalLength) => { try {
if (err) { let point = captureSession.getFocusPoint();
console.error(`Failed to get the current focal length ${err.message}`); } catch (error) {
return; // If the operation fails, error.code is returned and processed.
} console.log(error.code);
console.log(`Callback returned with the current focal length: ${focalLength}`); }
})
``` ```
### getFocalLength ### getFocalLength
getFocalLength(): Promise<number\> getFocalLength(): number
Obtains the focal length. This API uses a promise to return the result. Obtains the focal length of the device.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
**Return value** **Return value**
| Type | Description | | Type | Description |
| ---------------- | ----------------------- | | ---------- | ----------------------------- |
| Promise<number\> | Promise used to return the focal length.| | number | Focal length obtained. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example**
```js
captureSession.getFocalLength().then((focalLength) => {
console.log(`Promise returned with the current focal length: ${focalLength}`);
})
```
### getZoomRatioRange
getZoomRatioRange\(callback: AsyncCallback<Array<number\>\>\): void
Obtains the zoom ratio range. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | ------------------------------ | ---- | ------------------- |
| callback | AsyncCallback<Array<number\>\> | Yes | Callback used to return an array containing the minimum and maximum zoom ratios.|
**Example** **Example**
```js ```js
captureSession.getZoomRatioRange((err, zoomRatioRange) => { try {
if (err) { let focalLength = captureSession.getFocalLength();
console.error(`Failed to get the zoom ratio range. ${err.message}`); } catch (error) {
return; // If the operation fails, error.code is returned and processed.
} console.log(error.code);
console.log(`Callback returned with zoom ratio range: ${zoomRatioRange.length}`); }
})
``` ```
### getZoomRatioRange ### getZoomRatioRange
getZoomRatioRange\(\): Promise<Array<number\>\> getZoomRatioRange(): Array<number\>
Obtains the zoom ratio range. This API uses a promise to return the result. Obtains the supported zoom ratio range.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
**Return value** **Return value**
| Type | Description | | Type | Description |
| ------------------------ | --------------------------- | | ---------- | ----------------------------- |
| Promise<Array<number\>\> | Promise used to return an array containing the minimum and maximum zoom ratios.| | Array<number\> | Callback used to return an array containing the minimum and maximum zoom ratios. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
captureSession.getZoomRatioRange().then((zoomRatioRange) => { try {
console.log(`Promise returned with zoom ratio range: ${zoomRatioRange.length}`); let zoomRatioRange = captureSession.getZoomRatioRange();
}) } catch (error) {
// If the operation fails, error.code is returned and processed.
console.log(error.code);
}
``` ```
### setZoomRatio ### setZoomRatio
setZoomRatio(zoomRatio: number, callback: AsyncCallback<void\>): void setZoomRatio(zoomRatio: number): void
Sets a zoom ratio. This API uses an asynchronous callback to return the result. Sets a zoom ratio for the device.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
...@@ -2606,227 +1706,111 @@ Sets a zoom ratio. This API uses an asynchronous callback to return the result. ...@@ -2606,227 +1706,111 @@ Sets a zoom ratio. This API uses an asynchronous callback to return the result.
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| --------- | -------------------- | ---- | ------------------- | | --------- | -------------------- | ---- | ------------------- |
| zoomRatio | number | Yes | Zoom ratio. You can use **getZoomRatioRange** to obtain the supported values.| | zoomRatio | number | Yes | Zoom ratio. You can use **getZoomRatioRange** to obtain the supported values.|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.|
**Example**
```js
let zoomRatio = zoomRatioRange[0];
captureSession.setZoomRatio(zoomRatio, (err) => {
if (err) {
console.error(`Failed to set the zoom ratio value ${err.message}`);
return;
}
console.log('Callback returned with the successful execution of setZoomRatio.');
})
```
### setZoomRatio
setZoomRatio(zoomRatio: number): Promise<void\>
Sets a zoom ratio. This API uses a promise to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| --------- | ------ | ---- | --------- |
| zoomRatio | number | Yes | Zoom ratio. You can use **getZoomRatioRange** to obtain the supported values.|
**Return value** **Return value**
| Type | Description | | Type | Description |
| -------------- | ----------------------- | | ---------- | ----------------------------- |
| Promise<void\>| Promise used to return the result.| | [CameraErrorCode](#cameraerrorcode) | If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
let zoomRatio = zoomRatioRange[0]; let zoomRatio = zoomRatioRange[0];
captureSession.setZoomRatio(zoomRatio).then(() => { try {
console.log('Promise returned with the successful execution of setZoomRatio.'); captureSession.setZoomRatio(zoomRatio);
}) } catch (error) {
``` // If the operation fails, error.code is returned and processed.
console.log(error.code);
### getZoomRatio }
getZoomRatio(callback: AsyncCallback<number\>): void
Obtains the zoom ratio in use. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | ---------------------- | ---- | ------------------- |
| callback | AsyncCallback<number\> | Yes | Callback used to return the result.|
**Example**
```js
captureSession.getZoomRatio((err, zoomRatio) => {
if (err) {
console.error(`Failed to get the zoom ratio ${err.message}`);
return;
}
console.log(`Callback returned with current zoom ratio: ${zoomRatio}`);
})
``` ```
### getZoomRatio ### getZoomRatio
getZoomRatio(): Promise<number\> getZoomRatio(): number
Obtains the zoom ratio in use. This API uses a promise to return the result. Obtains the zoom ratio in use.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
**Return value** **Return value**
| Type | Description | | Type | Description |
| ---------------- | ----------------------- | | ---------- | ----------------------------- |
| Promise<number\> | Promise used to return the zoom ratio.| | number | Zoom ratio obtained. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example**
```js
captureSession.getZoomRatio().then((zoomRatio) => {
console.log(`Promise returned with current zoom ratio : ${zoomRatio}`);
})
```
### isVideoStabilizationModeSupported
isVideoStabilizationModeSupported(vsMode: VideoStabilizationMode, callback: AsyncCallback<boolean\>): void
Checks whether the specified video stabilization mode is supported. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | ------------------------------------------------- | ---- | ------------------------------ |
| vsMode | [VideoStabilizationMode](#videostabilizationmode) | Yes | Video stabilization mode. |
| callback | AsyncCallback<boolean\> | Yes | Callback used to return whether the video stabilization mode is supported. The value **true** means that the video stabilization mode is supported, and **false** means the opposite. |
**Example**
```js
captureSession.isVideoStabilizationModeSupported(camera.VideoStabilizationMode.OFF, (err, isSupported) => {
if (err) {
console.error(`Failed to check whether video stabilization mode supported. ${err.message}`);
return;
}
console.log(`Callback returned with the successful execution of isVideoStabilizationModeSupported`);
})
```
### isVideoStabilizationModeSupported
isVideoStabilizationModeSupported(vsMode: VideoStabilizationMode): Promise<boolean\>
Checks whether the specified video stabilization mode is supported. This API uses a promise to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Return value**
| Type | Description |
| ----------------- | --------------------------------------------- |
| Promise<boolean\> | Promise used to return whether the video stabilization mode is supported. The value **true** means that the video stabilization mode is supported, and **false** means the opposite.|
**Example**
```js
captureSession.isVideoStabilizationModeSupported(camera.VideoStabilizationMode.OFF).then((isSupported) => {
console.log(`Promise returned with video stabilization mode supported: ${isSupported}`);
})
```
### getActiveVideoStabilizationMode
getActiveVideoStabilizationMode(callback: AsyncCallback<VideoStabilizationMode\>): void
Obtains the video stabilization mode in use. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | ----------------------------------------- | ---- | ------------------------------ |
| callback | AsyncCallback<VideoStabilizationMode\> | Yes | Callback used to return the video stabilization mode. |
**Example** **Example**
```js ```js
captureSession.getActiveVideoStabilizationMode((err, vsMode) => { try {
if (err) { let zoomRatio = captureSession.getZoomRatio();
console.error(`Failed to get active video stabilization mode ${err.message}`); } catch (error) {
return; // If the operation fails, error.code is returned and processed.
} console.log(error.code);
console.log('Callback returned with the successful execution of getActiveVideoStabilizationMode.'); }
})
``` ```
### getActiveVideoStabilizationMode ### isVideoStabilizationModeSupported
getActiveVideoStabilizationMode(): Promise<VideoStabilizationMode\> isVideoStabilizationModeSupported(vsMode: VideoStabilizationMode): boolean
Obtains the video stabilization mode in use. This API uses a promise to return the result. Checks whether the specified video stabilization mode is supported.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | ------------------------------------------------- | ---- | ------------------------------ |
| vsMode | [VideoStabilizationMode](#videostabilizationmode) | Yes | Video stabilization mode. |
**Return value** **Return value**
| Type | Description | | Type | Description |
| -------------------------------- | ------------------------------------------------- | | ---------- | ----------------------------- |
| Promise<VideoStabilizationMode\> | Promise used to return the video stabilization mode. | | boolean | Returns **true** if the video stabilization mode is supported; returns **false** otherwise. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
captureSession.getActiveVideoStabilizationMode().then((vsMode) => { try {
console.log(`Promise returned with the current video stabilization mode: ${vsMode}`); let isSupported = captureSession.isVideoStabilizationModeSupported(camera.VideoStabilizationMode.OFF);
}) } catch (error) {
// If the operation fails, error.code is returned and processed.
console.log(error.code);
}
``` ```
### setVideoStabilizationMode ### getActiveVideoStabilizationMode
setVideoStabilizationMode(mode: VideoStabilizationMode, callback: AsyncCallback<void\>): void getActiveVideoStabilizationMode(): VideoStabilizationMode
Sets a video stabilization mode. This API uses an asynchronous callback to return the result. Obtains the video stabilization mode in use.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters** **Return value**
| Name | Type | Mandatory| Description | | Type | Description |
| -------- | ------------------------------------------------- | ---- | --------------------- | | ---------- | ----------------------------- |
| mode | [VideoStabilizationMode](#videostabilizationmode) | Yes | Video stabilization mode. | | VideoStabilizationMode | Video stabilization mode obtained. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result. |
**Example** **Example**
```js ```js
captureSession.setVideoStabilizationMode(camera.VideoStabilizationMode.OFF, (err) => { try {
if (err) { let vsMode = captureSession.getActiveVideoStabilizationMode();
console.error(`Failed to set the video stabilization mode ${err.message}`); } catch (error) {
return; // If the operation fails, error.code is returned and processed.
} console.log(error.code);
console.log('Callback returned with the successful execution of setVideoStabilizationMode.'); }
})
``` ```
### setVideoStabilizationMode ### setVideoStabilizationMode
setVideoStabilizationMode(mode: VideoStabilizationMode): Promise<void\> setVideoStabilizationMode(mode: VideoStabilizationMode): void
Sets a video stabilization mode. This API uses a promise to return the result. Sets a video stabilization mode for the device.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
...@@ -2838,16 +1822,19 @@ Sets a video stabilization mode. This API uses a promise to return the result. ...@@ -2838,16 +1822,19 @@ Sets a video stabilization mode. This API uses a promise to return the result.
**Return value** **Return value**
| Type | Description | | Type | Description |
| -------------- | ------------------------------------------------- | | ---------- | ----------------------------- |
| Promise<void\>| Promise used to return the result. | | [CameraErrorCode](#cameraerrorcode) | If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
captureSession.setVideoStabilizationMode(camera.VideoStabilizationMode.OFF).then(() => { try {
console.log('Promise returned with the successful execution of setVideoStabilizationMode.'); captureSession.setVideoStabilizationMode(camera.VideoStabilizationMode.OFF);
}) } catch (error) {
// If the operation fails, error.code is returned and processed.
console.log(error.code);
}
``` ```
### on('focusStateChange') ### on('focusStateChange')
...@@ -2862,7 +1849,7 @@ Listens for focus state changes. This API uses an asynchronous callback to retur ...@@ -2862,7 +1849,7 @@ Listens for focus state changes. This API uses an asynchronous callback to retur
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | ----------------------------------------- | ---- | ------------------------ | | -------- | ----------------------------------------- | ---- | ------------------------ |
| type | string | Yes | Event type. The value is fixed at **'focusStateChange'**, indicating the focus state change event.| | type | string | Yes | Event type. The value is fixed at **'focusStateChange'**. The callback function returns the focus state change. The event can be listened for only when the session is created.|
| callback | AsyncCallback<[FocusState](#focusstate)\> | Yes | Callback used to return the focus state change. | | callback | AsyncCallback<[FocusState](#focusstate)\> | Yes | Callback used to return the focus state change. |
**Example** **Example**
...@@ -2875,7 +1862,7 @@ captureSession.on('focusStateChange', (focusState) => { ...@@ -2875,7 +1862,7 @@ captureSession.on('focusStateChange', (focusState) => {
### on('error') ### on('error')
on(type: 'error', callback: ErrorCallback<CaptureSessionError\>): void on(type: 'error', callback: ErrorCallback<BusinessError\>): void
Listens for **CaptureSession** errors. This API uses a callback to return the errors. Listens for **CaptureSession** errors. This API uses a callback to return the errors.
...@@ -2885,39 +1872,17 @@ Listens for **CaptureSession** errors. This API uses a callback to return the er ...@@ -2885,39 +1872,17 @@ Listens for **CaptureSession** errors. This API uses a callback to return the er
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | ----------------------------------------------------------- | ---- | ------------------------------ | | -------- | ----------------------------------------------------------- | ---- | ------------------------------ |
| type | string | Yes | Event type. The value is fixed at **'error'**, indicating the capture session error event.| | type | string | Yes | Event type. The value is fixed at **'error'**. The callback function returns the error code corresponding to an error that occurs during the call of a **CaptureSession** API, for example, **beginConfig()**, **commitConfig()**, or **addInput()**.|
| callback | ErrorCallback<[CaptureSessionError](#capturesessionerror)\> | Yes | Callback used to return the error information. | | callback | ErrorCallback<BusinessError\> | Yes | Callback used to return an error code defined in [CameraErrorCode](#cameraerrorcode). |
**Example** **Example**
```js ```js
captureSession.on('error', (captureSessionError) => { captureSession.on('error', (error) => {
console.log(`Capture session error code: ${captureSessionError.code}`); console.log(`Capture session error code: ${error.code}`);
}) })
``` ```
## CaptureSessionErrorCode
Enumerates the error codes used in a **CaptureSession**.
**System capability**: SystemCapability.Multimedia.Camera.Core
| Name | Value | Description |
| ----------------------------- | ---- | -------- |
| ERROR_UNKNOWN | -1 | Unknown error.|
| ERROR_INSUFFICIENT_RESOURCES | 0 | Insufficient resources.|
| ERROR_TIMEOUT | 1 | Timeout.|
## CaptureSessionError
Defines a **CaptureSession** error.
**System capability**: SystemCapability.Multimedia.Camera.Core
| Name| Type | Mandatory | Description |
| ---- | ------------------------------------------- | -------------------------- |-------------------------- |
| code | [CaptureSessionError](#capturesessionerror) | Yes |**CaptureSession** error code.|
## CameraOutput ## CameraOutput
Implements output information used in a **[CaptureSession](#capturesession)**. It is the base class of **output**. Implements output information used in a **[CaptureSession](#capturesession)**. It is the base class of **output**.
...@@ -2938,14 +1903,14 @@ Starts to output preview streams. This API uses an asynchronous callback to retu ...@@ -2938,14 +1903,14 @@ Starts to output preview streams. This API uses an asynchronous callback to retu
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | -------------------- | ---- | -------------------- | | -------- | -------------------- | ---- | -------------------- |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.| | callback | AsyncCallback<void\> | Yes | Callback used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
previewOutput.start((err) => { previewOutput.start((err) => {
if (err) { if (err) {
console.error(`Failed to start the previewOutput. ${err.message}`); console.error(`Failed to start the previewOutput. ${err.code}`);
return; return;
} }
console.log('Callback returned with previewOutput started.'); console.log('Callback returned with previewOutput started.');
...@@ -2964,14 +1929,16 @@ Starts to output preview streams. This API uses a promise to return the result. ...@@ -2964,14 +1929,16 @@ Starts to output preview streams. This API uses a promise to return the result.
| Type | Description | | Type | Description |
| -------------- | ----------------------- | | -------------- | ----------------------- |
| Promise<void\>| Promise used to return the result.| | Promise<void\>| Promise used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
previewOutput.start().then(() => { previewOutput.start().then(() => {
console.log('Promise returned with previewOutput started.'); console.log('Promise returned with previewOutput started.');
}) }).catch((err) => {
console.log('Failed to previewOutput start '+ err.code);
});
``` ```
### stop ### stop
...@@ -2993,7 +1960,7 @@ Stops outputting preview streams. This API uses an asynchronous callback to retu ...@@ -2993,7 +1960,7 @@ Stops outputting preview streams. This API uses an asynchronous callback to retu
```js ```js
previewOutput.stop((err) => { previewOutput.stop((err) => {
if (err) { if (err) {
console.error(`Failed to stop the previewOutput. ${err.message}`); console.error(`Failed to stop the previewOutput. ${err.code}`);
return; return;
} }
console.log('Callback returned with previewOutput stopped.'); console.log('Callback returned with previewOutput stopped.');
...@@ -3019,7 +1986,9 @@ Stops outputting preview streams. This API uses a promise to return the result. ...@@ -3019,7 +1986,9 @@ Stops outputting preview streams. This API uses a promise to return the result.
```js ```js
previewOutput.stop().then(() => { previewOutput.stop().then(() => {
console.log('Callback returned with previewOutput stopped.'); console.log('Callback returned with previewOutput stopped.');
}) }).catch((err) => {
console.log('Failed to previewOutput stop '+ err.code);
});
``` ```
### release ### release
...@@ -3034,14 +2003,14 @@ Releases output resources. This API uses an asynchronous callback to return the ...@@ -3034,14 +2003,14 @@ Releases output resources. This API uses an asynchronous callback to return the
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | -------------------- | ---- | ------------------- | | -------- | -------------------- | ---- | ------------------- |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.| | callback | AsyncCallback<void\> | Yes | Callback used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
previewOutput.release((err) => { previewOutput.release((err) => {
if (err) { if (err) {
console.error(`Failed to release the PreviewOutput instance ${err.message}`); console.error(`Failed to release the PreviewOutput instance ${err.code}`);
return; return;
} }
console.log('Callback invoked to indicate that the PreviewOutput instance is released successfully.'); console.log('Callback invoked to indicate that the PreviewOutput instance is released successfully.');
...@@ -3060,14 +2029,16 @@ Releases output resources. This API uses a promise to return the result. ...@@ -3060,14 +2029,16 @@ Releases output resources. This API uses a promise to return the result.
| Type | Description | | Type | Description |
| -------------- | ----------------------- | | -------------- | ----------------------- |
| Promise<void\>| Promise used to return the result.| | Promise<void\>| Promise used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
previewOutput.release().then(() => { previewOutput.release().then(() => {
console.log('Promise returned to indicate that the PreviewOutput instance is released successfully.'); console.log('Promise returned to indicate that the PreviewOutput instance is released successfully.');
}) }).catch((err) => {
console.log('Failed to previewOutput release '+ err.code);
});
``` ```
### on('frameStart') ### on('frameStart')
...@@ -3082,7 +2053,7 @@ Listens for preview frame start events. This API uses an asynchronous callback t ...@@ -3082,7 +2053,7 @@ Listens for preview frame start events. This API uses an asynchronous callback t
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | -------------------- | ---- | --------------------------------------- | | -------- | -------------------- | ---- | --------------------------------------- |
| type | string | Yes | Event type. The value is fixed at **'frameStart'**, indicating the preview frame start event.| | type | string | Yes | Event type. The value is fixed at **'frameStart'**. The callback is invoked when the preview on the first frame starts. This event can be listened for only when a **previewOutput** instance is created.|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result. | | callback | AsyncCallback<void\> | Yes | Callback used to return the result. |
**Example** **Example**
...@@ -3105,7 +2076,7 @@ Listens for preview frame end events. This API uses an asynchronous callback to ...@@ -3105,7 +2076,7 @@ Listens for preview frame end events. This API uses an asynchronous callback to
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | -------------------- | ---- | ------------------------------------- | | -------- | -------------------- | ---- | ------------------------------------- |
| type | string | Yes | Event type. The value is fixed at **'frameEnd'**, indicating the preview frame end event.| | type | string | Yes | Event type. The value is fixed at **'frameEnd'**. The callback is invoked when the preview on the last frame ends. This event can be listened for only when a **previewOutput** instance is created.|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result. | | callback | AsyncCallback<void\> | Yes | Callback used to return the result. |
**Example** **Example**
...@@ -3118,7 +2089,7 @@ previewOutput.on('frameEnd', () => { ...@@ -3118,7 +2089,7 @@ previewOutput.on('frameEnd', () => {
### on('error') ### on('error')
on(type: 'error', callback: ErrorCallback<PreviewOutputError\>): void on(type: 'error', callback: ErrorCallback<BusinessError\>): void
Listens for **PreviewOutput** errors. This API uses a callback to return the errors. Listens for **PreviewOutput** errors. This API uses a callback to return the errors.
...@@ -3128,8 +2099,8 @@ Listens for **PreviewOutput** errors. This API uses a callback to return the err ...@@ -3128,8 +2099,8 @@ Listens for **PreviewOutput** errors. This API uses a callback to return the err
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | ----------------------------------------------------------------- | ---- | ------------------------ | | -------- | ----------------------------------------------------------------- | ---- | ------------------------ |
| type | string | Yes | Event type. The value is fixed at **'error'**, indicating the preview output error event.| | type | string | Yes | Event type. The value is fixed at **'error'**. The callback function returns the error code corresponding to an error that occurs during the call of a **PreviewOutput** API, for example, **start()** or **release()**.|
| callback | ErrorCallback<[PreviewOutputErrorCode](#previewoutputerrorcode)\> | Yes | Callback used to return the error information. | | callback | ErrorCallback<BusinessError\> | Yes | Callback used to return an error code defined in [CameraErrorCode](#cameraerrorcode). |
**Example** **Example**
...@@ -3139,26 +2110,6 @@ previewOutput.on('error', (previewOutputError) => { ...@@ -3139,26 +2110,6 @@ previewOutput.on('error', (previewOutputError) => {
}) })
``` ```
## PreviewOutputErrorCode
Enumerates the error codes used for preview output.
**System capability**: SystemCapability.Multimedia.Camera.Core
| Name | Value | Description |
| ------------- | ---- | -------- |
| ERROR_UNKNOWN | -1 | Unknown error.|
## PreviewOutputError
Defines the preview output error.
**System capability**: SystemCapability.Multimedia.Camera.Core
| Name| Type | Mandatory | Description |
| ---- | ------------------------------------------------- | ---------------- |---------------------- |
| code | [PreviewOutputErrorCode](#previewoutputerrorcode) | Yes |**PreviewOutput** error code.|
## ImageRotation ## ImageRotation
Enumerates the image rotation angles. Enumerates the image rotation angles.
...@@ -3226,14 +2177,14 @@ Captures a photo with the default shooting parameters. This API uses an asynchro ...@@ -3226,14 +2177,14 @@ Captures a photo with the default shooting parameters. This API uses an asynchro
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | -------------------- | ---- | ------------------- | | -------- | -------------------- | ---- | ------------------- |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.| | callback | AsyncCallback<void\> | Yes | Callback used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
photoOutput.capture((err) => { photoOutput.capture((err) => {
if (err) { if (err) {
console.error(`Failed to capture the photo ${err.message}`); console.error(`Failed to capture the photo ${err.code}`);
return; return;
} }
console.log('Callback invoked to indicate the photo capture request success.'); console.log('Callback invoked to indicate the photo capture request success.');
...@@ -3242,6 +2193,30 @@ photoOutput.capture((err) => { ...@@ -3242,6 +2193,30 @@ photoOutput.capture((err) => {
### capture ### capture
capture(): Promise<void\>
Captures a photo with the default shooting parameters. This API uses a promise to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Return value**
| Type | Description |
| -------------- | ------------------------ |
| Promise<void\>| Promise used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example**
```js
photoOutput.capture().then(() => {
console.log('Promise returned to indicate that photo capture request success.');
}).catch((err) => {
console.log('Failed to photoOutput capture '+ err.code);
});
```
### capture
capture(setting: PhotoCaptureSetting, callback: AsyncCallback<void\>): void capture(setting: PhotoCaptureSetting, callback: AsyncCallback<void\>): void
Captures a photo with the specified shooting parameters. This API uses an asynchronous callback to return the result. Captures a photo with the specified shooting parameters. This API uses an asynchronous callback to return the result.
...@@ -3253,7 +2228,7 @@ Captures a photo with the specified shooting parameters. This API uses an asynch ...@@ -3253,7 +2228,7 @@ Captures a photo with the specified shooting parameters. This API uses an asynch
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | ------------------------------------------- | ---- | -------------------- | | -------- | ------------------------------------------- | ---- | -------------------- |
| setting | [PhotoCaptureSetting](#photocapturesetting) | Yes | Shooting settings. | | setting | [PhotoCaptureSetting](#photocapturesetting) | Yes | Shooting settings. |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result. | | callback | AsyncCallback<void\> | Yes | Callback used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned. |
**Example** **Example**
...@@ -3271,7 +2246,7 @@ let settings = { ...@@ -3271,7 +2246,7 @@ let settings = {
} }
photoOutput.capture(settings, (err) => { photoOutput.capture(settings, (err) => {
if (err) { if (err) {
console.error(`Failed to capture the photo ${err.message}`); console.error(`Failed to capture the photo ${err.code}`);
return; return;
} }
console.log('Callback invoked to indicate the photo capture request success.'); console.log('Callback invoked to indicate the photo capture request success.');
...@@ -3296,41 +2271,37 @@ Captures a photo with the specified shooting parameters. This API uses a promise ...@@ -3296,41 +2271,37 @@ Captures a photo with the specified shooting parameters. This API uses a promise
| Type | Description | | Type | Description |
| -------------- | ------------------------ | | -------------- | ------------------------ |
| Promise<void\>| Promise used to return the result.| | Promise<void\>| Promise used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
photoOutput.capture().then(() => { photoOutput.capture(settings).then(() => {
console.log('Promise returned to indicate that photo capture request success.'); console.log('Promise returned to indicate that photo capture request success.');
}) }).catch((err) => {
console.log('Failed to photoOutput capture '+ err.code);
});
``` ```
### isMirrorSupported ### isMirrorSupported
isMirrorSupported(callback: AsyncCallback<boolean\>): void isMirrorSupported(): boolean
Checks whether mirroring is supported. This API uses an asynchronous callback to return the result. Checks whether mirroring is supported.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters** **Return value**
| Name | Type | Mandatory| Description | | Type | Description |
| -------- | ------------------------------------------------- | ---- | -------------------------- | | -------------- | ----------------------- |
| callback | AsyncCallback<boolean\> | Yes | Callback used to return the mirroring support status. The value **true** means that mirroring is supported, and **false** means the opposite. | | boolean | Returns **true** if mirroring is supported; returns **false** otherwise.|
**Example** **Example**
```js ```js
photoOutput.isMirrorSupported((err, isSupported) => { let isSupported = photoOutput.isMirrorSupported();
if (err) {
console.error(`Failed to check mirror is supported ${err.message}`);
return;
}
console.log('Callback returned with the successful execution of isMirrorSupported.');
})
``` ```
### release ### release
...@@ -3345,14 +2316,14 @@ Releases output resources. This API uses an asynchronous callback to return the ...@@ -3345,14 +2316,14 @@ Releases output resources. This API uses an asynchronous callback to return the
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | -------------------- | ---- | ------------------- | | -------- | -------------------- | ---- | ------------------- |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.| | callback | AsyncCallback<void\> | Yes | Callback used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
photoOutput.release((err) => { photoOutput.release((err) => {
if (err) { if (err) {
console.error(`Failed to release the PreviewOutput instance ${err.message}`); console.error(`Failed to release the PreviewOutput instance ${err.code}`);
return; return;
} }
console.log('Callback invoked to indicate that the PreviewOutput instance is released successfully.'); console.log('Callback invoked to indicate that the PreviewOutput instance is released successfully.');
...@@ -3371,36 +2342,16 @@ Releases output resources. This API uses a promise to return the result. ...@@ -3371,36 +2342,16 @@ Releases output resources. This API uses a promise to return the result.
| Type | Description | | Type | Description |
| -------------- | ----------------------- | | -------------- | ----------------------- |
| Promise<void\>| Promise used to return the result.| | Promise<void\>| Promise used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
photoOutput.release().then(() => { photoOutput.release().then(() => {
console.log('Promise returned to indicate that the PreviewOutput instance is released successfully.'); console.log('Promise returned to indicate that the PreviewOutput instance is released successfully.');
}) }).catch((err) => {
``` console.log('Failed to photoOutput release '+ err.code);
});
### isMirrorSupported
isMirrorSupported(): Promise<boolean\>
Checks whether mirroring is supported. This API uses a promise to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Return value**
| Type | Description |
| ----------------- | ------------------------------------------- |
| Promise<boolean\> | Promise used to return the mirroring support status. The value **true** means that mirroring is supported, and **false** means the opposite. |
**Example**
```js
photoOutput.isMirrorSupported().then((isSupported) => {
console.log(`Promise returned with mirror supported: ${isSupported}`);
})
``` ```
### on('captureStart') ### on('captureStart')
...@@ -3415,13 +2366,13 @@ Listens for shooting start events. This API uses an asynchronous callback to ret ...@@ -3415,13 +2366,13 @@ Listens for shooting start events. This API uses an asynchronous callback to ret
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | ---------------------- | ---- | ------------------------------------------ | | -------- | ---------------------- | ---- | ------------------------------------------ |
| type | string | Yes | Event type. The value is fixed at **'captureStart'**, indicating the shooting start event.| | type | string | Yes | Event type. The value is fixed at **'captureStart'**. The callback function returns the shooting start event.|
| callback | AsyncCallback<number\> | Yes | Callback used to return the capture ID. | | callback | AsyncCallback<number\> | Yes | Callback used to return the capture ID. |
**Example** **Example**
```js ```js
photoOutput.on('captureStart', (err, captureId) => { photoOutput.on('captureStart', (captureId) => {
console.log(`photo capture stated, captureId : ${captureId}`); console.log(`photo capture stated, captureId : ${captureId}`);
}) })
``` ```
...@@ -3438,13 +2389,13 @@ Listens for frame shutter events. This API uses an asynchronous callback to retu ...@@ -3438,13 +2389,13 @@ Listens for frame shutter events. This API uses an asynchronous callback to retu
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | ----------------------------------------------------- | --- | ------------------------------------ | | -------- | ----------------------------------------------------- | --- | ------------------------------------ |
| type | string | Yes | Event type. The value is fixed at **'frameShutter'**, indicating the frame shutter event.| | type | string | Yes | Event type. The value is fixed at **'frameShutter'**. The callback function returns the captured frame information (captureId and time).|
| callback | AsyncCallback<[FrameShutterInfo](#frameshutterinfo)\> | Yes | Callback used to return the result. | | callback | AsyncCallback<[FrameShutterInfo](#frameshutterinfo)\> | Yes | Callback used to return the result. |
**Example** **Example**
```js ```js
photoOutput.on('frameShutter', (err, frameShutterInfo) => { photoOutput.on('frameShutter', (frameShutterInfo) => {
console.log(`photo capture end, captureId : ${frameShutterInfo.captureId}`); console.log(`photo capture end, captureId : ${frameShutterInfo.captureId}`);
console.log(`Timestamp for frame : ${frameShutterInfo.timestamp}`); console.log(`Timestamp for frame : ${frameShutterInfo.timestamp}`);
}) })
...@@ -3462,13 +2413,13 @@ Listens for shooting end events. This API uses an asynchronous callback to retur ...@@ -3462,13 +2413,13 @@ Listens for shooting end events. This API uses an asynchronous callback to retur
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | ------------------------------------------------- | ---- | ---------------------------------------- | | -------- | ------------------------------------------------- | ---- | ---------------------------------------- |
| type | string | Yes | Event type. The value is fixed at **'captureEnd'**, indicating the shooting end event.| | type | string | Yes | Event type. The value is fixed at **'captureEnd'**. The callback function returns the shooting end event.|
| callback | AsyncCallback<[CaptureEndInfo](#captureendinfo)\> | Yes | Callback used to return the result. | | callback | AsyncCallback<[CaptureEndInfo](#captureendinfo)\> | Yes | Callback used to return the result. |
**Example** **Example**
```js ```js
photoOutput.on('captureEnd', (err, captureEndInfo) => { photoOutput.on('captureEnd', (captureEndInfo) => {
console.log(`photo capture end, captureId : ${captureEndInfo.captureId}`); console.log(`photo capture end, captureId : ${captureEndInfo.captureId}`);
console.log(`frameCount : ${captureEndInfo.frameCount}`); console.log(`frameCount : ${captureEndInfo.frameCount}`);
}) })
...@@ -3476,7 +2427,7 @@ photoOutput.on('captureEnd', (err, captureEndInfo) => { ...@@ -3476,7 +2427,7 @@ photoOutput.on('captureEnd', (err, captureEndInfo) => {
### on('error') ### on('error')
on(type: 'error', callback: ErrorCallback<PhotoOutputError\>): void on(type: 'error', callback: ErrorCallback<BusinessError\>): void
Listens for **PhotoOutput** errors. This API uses a callback to return the errors. Listens for **PhotoOutput** errors. This API uses a callback to return the errors.
...@@ -3486,14 +2437,14 @@ Listens for **PhotoOutput** errors. This API uses a callback to return the error ...@@ -3486,14 +2437,14 @@ Listens for **PhotoOutput** errors. This API uses a callback to return the error
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | ----------------------------------------------------- | ---- | ----------------------------------- | | -------- | ----------------------------------------------------- | ---- | ----------------------------------- |
| type | string | Yes | Event type. The value is fixed at **'error'**, indicating the photo output error event.| | type | string | Yes | Event type. The value is fixed at **'error'**. The callback function returns an error code when an API call fails.|
| callback | ErrorCallback<[PhotoOutputError](#photooutputerror)\> | Yes | Callback used to return the error information. | | callback | ErrorCallback<BusinessError\> | Yes | Callback used to return an error code defined in [CameraErrorCode](#cameraerrorcode). |
**Example** **Example**
```js ```js
photoOutput.on('error', (err, photoOutputError) => { photoOutput.on('error', (error) => {
console.log(`Photo output error code: ${photoOutputError.code}`); console.log(`Photo output error code: ${error.code}`);
}) })
``` ```
...@@ -3519,29 +2470,6 @@ Defines the capture end information. ...@@ -3519,29 +2470,6 @@ Defines the capture end information.
| captureId | number | Yes | ID of this capture action.| | captureId | number | Yes | ID of this capture action.|
| frameCount | number | Yes | Number of frames captured. | | frameCount | number | Yes | Number of frames captured. |
## PhotoOutputErrorCode
Enumerates the error codes used for photo output.
**System capability**: SystemCapability.Multimedia.Camera.Core
| Name | Value | Description |
| ----------------------------- | ---- | --------------- |
| ERROR_UNKNOWN | -1 | Unknown error. |
| ERROR_DRIVER_ERROR | 0 | The driver or hardware is faulty.|
| ERROR_INSUFFICIENT_RESOURCES | 1 | Insufficient resources. |
| ERROR_TIMEOUT | 2 | Timeout. |
## PhotoOutputError
Defines a photo output error.
**System capability**: SystemCapability.Multimedia.Camera.Core
| Name| Type | Mandatory |Description |
| ---- | ------------------------------------- | --------- | ----------------------- |
| code | [PhotoOutputErrorCode](#photooutputerrorcode) | Yes | **PhotoOutput** error code.|
## VideoOutput ## VideoOutput
Implements output information used in a video recording session. This class inherits from [CameraOutput](#cameraoutput). Implements output information used in a video recording session. This class inherits from [CameraOutput](#cameraoutput).
...@@ -3558,14 +2486,14 @@ Starts video recording. This API uses an asynchronous callback to return the res ...@@ -3558,14 +2486,14 @@ Starts video recording. This API uses an asynchronous callback to return the res
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | -------------------- | ---- | -------------------- | | -------- | -------------------- | ---- | -------------------- |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.| | callback | AsyncCallback<void\> | Yes | Callback used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
videoOutput.start((err) => { videoOutput.start((err) => {
if (err) { if (err) {
console.error(`Failed to start the video output ${err.message}`); console.error(`Failed to start the video output ${err.code}`);
return; return;
} }
console.log('Callback invoked to indicate the video output start success.'); console.log('Callback invoked to indicate the video output start success.');
...@@ -3584,7 +2512,7 @@ Starts video recording. This API uses a promise to return the result. ...@@ -3584,7 +2512,7 @@ Starts video recording. This API uses a promise to return the result.
| Type | Description | | Type | Description |
| -------------- | ----------------------- | | -------------- | ----------------------- |
| Promise<void\>| Promise used to return the result.| | Promise<void\>| Promise used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
...@@ -3592,7 +2520,9 @@ Starts video recording. This API uses a promise to return the result. ...@@ -3592,7 +2520,9 @@ Starts video recording. This API uses a promise to return the result.
```js ```js
videoOutput.start().then(() => { videoOutput.start().then(() => {
console.log('Promise returned to indicate that start method execution success.'); console.log('Promise returned to indicate that start method execution success.');
}) }).catch((err) => {
console.log('Failed to videoOutput start '+ err.code);
});
``` ```
### stop ### stop
...@@ -3614,7 +2544,7 @@ Stops video recording. This API uses an asynchronous callback to return the resu ...@@ -3614,7 +2544,7 @@ Stops video recording. This API uses an asynchronous callback to return the resu
```js ```js
videoOutput.stop((err) => { videoOutput.stop((err) => {
if (err) { if (err) {
console.error(`Failed to stop the video output ${err.message}`); console.error(`Failed to stop the video output ${err.code}`);
return; return;
} }
console.log('Callback invoked to indicate the video output stop success.'); console.log('Callback invoked to indicate the video output stop success.');
...@@ -3640,8 +2570,10 @@ Stops video recording. This API uses a promise to return the result. ...@@ -3640,8 +2570,10 @@ Stops video recording. This API uses a promise to return the result.
```js ```js
videoOutput.stop().then(() => { videoOutput.stop().then(() => {
console.log('Promise returned to indicate that stop method execution success.'); console.log('Promise returned to indicate that stop method execution success.');
}) }).catch((err) => {
``` console.log('Failed to videoOutput stop '+ err.code);
});
```
### release ### release
...@@ -3655,14 +2587,14 @@ Releases output resources. This API uses an asynchronous callback to return the ...@@ -3655,14 +2587,14 @@ Releases output resources. This API uses an asynchronous callback to return the
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | -------------------- | ---- | ------------------- | | -------- | -------------------- | ---- | ------------------- |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.| | callback | AsyncCallback<void\> | Yes | Callback used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
videoOutput.release((err) => { videoOutput.release((err) => {
if (err) { if (err) {
console.error(`Failed to release the PreviewOutput instance ${err.message}`); console.error(`Failed to release the PreviewOutput instance ${err.code}`);
return; return;
} }
console.log('Callback invoked to indicate that the PreviewOutput instance is released successfully.'); console.log('Callback invoked to indicate that the PreviewOutput instance is released successfully.');
...@@ -3681,14 +2613,16 @@ Releases output resources. This API uses a promise to return the result. ...@@ -3681,14 +2613,16 @@ Releases output resources. This API uses a promise to return the result.
| Type | Description | | Type | Description |
| -------------- | ----------------------- | | -------------- | ----------------------- |
| Promise<void\>| Promise used to return the result.| | Promise<void\>| Promise used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
videoOutput.release().then(() => { videoOutput.release().then(() => {
console.log('Promise returned to indicate that the PreviewOutput instance is released successfully.'); console.log('Promise returned to indicate that the PreviewOutput instance is released successfully.');
}) }).catch((err) => {
console.log('Failed to videoOutput release '+ err.code);
});
``` ```
### on('frameStart') ### on('frameStart')
...@@ -3703,7 +2637,7 @@ Listens for video recording start events. This API uses an asynchronous callback ...@@ -3703,7 +2637,7 @@ Listens for video recording start events. This API uses an asynchronous callback
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | -------------------- | ---- | ----------------------------------------- | | -------- | -------------------- | ---- | ----------------------------------------- |
| type | string | Yes | Event type. The value is fixed at **`frameStart`**, indicating the video recording start event.| | type | string | Yes | Event type. The value is fixed at **'frameStart'**. The callback is invoked when the recording on the first frame of an image starts.|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result. | | callback | AsyncCallback<void\> | Yes | Callback used to return the result. |
**Example** **Example**
...@@ -3726,7 +2660,7 @@ Listens for video recording stop events. This API uses an asynchronous callback ...@@ -3726,7 +2660,7 @@ Listens for video recording stop events. This API uses an asynchronous callback
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | -------------------- | ---- | ------------------------------------------ | | -------- | -------------------- | ---- | ------------------------------------------ |
| type | string | Yes | Event type. The value is fixed at **'frameEnd'**, indicating the video recording stop event.| | type | string | Yes | Event type. The value is fixed at **'frameEnd'**. The callback is invoked when the recording on the last frame of an image stops.|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result. | | callback | AsyncCallback<void\> | Yes | Callback used to return the result. |
**Example** **Example**
...@@ -3739,7 +2673,7 @@ videoOutput.on('frameEnd', () => { ...@@ -3739,7 +2673,7 @@ videoOutput.on('frameEnd', () => {
### on('error') ### on('error')
on(type: 'error', callback: ErrorCallback<VideoOutputError\>): void on(type: 'error', callback: ErrorCallback<BusinessError\>): void
Listens for errors that occur during video recording. This API uses a callback to return the result. Listens for errors that occur during video recording. This API uses a callback to return the result.
...@@ -3749,38 +2683,17 @@ Listens for errors that occur during video recording. This API uses a callback t ...@@ -3749,38 +2683,17 @@ Listens for errors that occur during video recording. This API uses a callback t
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | ------------------------------------------------ | ---- | -------------------------------------- | | -------- | ------------------------------------------------ | ---- | -------------------------------------- |
| type | string | Yes | Event type. The value is fixed at **'error'**, indicating the video output error event.| | type | string | Yes | Event type. The value is fixed at **'error'**. The callback function returns the error code corresponding to an error that occurs during the call of a **VideoOutput** API, for example, **start()** or **release()**.|
| callback | Callback<[VideoOutputError](#videooutputerror)\> | Yes | Callback used to return the error information. | | callback | Callback<BusinessError\> | Yes | Callback used to return an error code defined in [CameraErrorCode](#cameraerrorcode). |
**Example** **Example**
```js ```js
videoOutput.on('error', (VideoOutputError) => { videoOutput.on('error', (error) => {
console.log(`Video output error code: ${VideoOutputError.code}`); console.log(`Video output error code: ${error.code}`);
}) })
``` ```
## VideoOutputErrorCode
Enumerates the error codes used for video recording.
**System capability**: SystemCapability.Multimedia.Camera.Core
| Name | Value | Description |
| --------------------- | ---- | ------------ |
| ERROR_UNKNOWN | -1 | Unknown error. |
| ERROR_DRIVER_ERROR | 0 | The driver or hardware is faulty.|
## VideoOutputError
Defines a video output error.
**System capability**: SystemCapability.Multimedia.Camera.Core
| Name| Type | Mandatory | Description |
| ---- | ------------------------------------- | ----------------- | ----------------------- |
| code | [PhotoOutputErrorCode](#photooutputerrorcode) | Yes | **VideoOutput** error code.|
## MetadataOutput ## MetadataOutput
Implements metadata streams. It inherits **[CameraOutput](#cameraoutput)**. Implements metadata streams. It inherits **[CameraOutput](#cameraoutput)**.
...@@ -3796,15 +2709,15 @@ Starts to output metadata. This API uses an asynchronous callback to return the ...@@ -3796,15 +2709,15 @@ Starts to output metadata. This API uses an asynchronous callback to return the
**Parameters** **Parameters**
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | ----------------------------------------------------------- | ---- | ------------------- | | -------- | -------------------------- | ---- | ------------------- |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result.| | callback | AsyncCallback<void\> | Yes | Callback used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
metadataOutput.start((err) => { metadataOutput.start((err) => {
if (err) { if (err) {
console.error(`Failed to start metadataOutput. ${err.message}`); console.error(`Failed to start metadataOutput. ${err.code}`);
return; return;
} }
console.log('Callback returned with metadataOutput started.'); console.log('Callback returned with metadataOutput started.');
...@@ -3823,14 +2736,16 @@ Starts to output metadata. This API uses a promise to return the result. ...@@ -3823,14 +2736,16 @@ Starts to output metadata. This API uses a promise to return the result.
| Type | Description | | Type | Description |
| ---------------------- | ------------------------ | | ---------------------- | ------------------------ |
| Promise<void\> | Promise used to return the result.| | Promise<void\> | Promise used to return the result. If the operation fails, an error code defined in [CameraErrorCode](#cameraerrorcode) is returned.|
**Example** **Example**
```js ```js
metadataOutput.start().then(() => { metadataOutput.start().then(() => {
console.log('Callback returned with metadataOutput started.'); console.log('Callback returned with metadataOutput started.');
}) }).catch((err) => {
console.log('Failed to metadataOutput start '+ err.code);
});
``` ```
### stop ### stop
...@@ -3852,7 +2767,7 @@ Stops outputting metadata. This API uses an asynchronous callback to return the ...@@ -3852,7 +2767,7 @@ Stops outputting metadata. This API uses an asynchronous callback to return the
```js ```js
metadataOutput.stop((err) => { metadataOutput.stop((err) => {
if (err) { if (err) {
console.error(`Failed to stop the metadataOutput. ${err.message}`); console.error(`Failed to stop the metadataOutput. ${err.code}`);
return; return;
} }
console.log('Callback returned with metadataOutput stopped.'); console.log('Callback returned with metadataOutput stopped.');
...@@ -3878,7 +2793,9 @@ Stops outputting metadata. This API uses a promise to return the result. ...@@ -3878,7 +2793,9 @@ Stops outputting metadata. This API uses a promise to return the result.
```js ```js
metadataOutput.stop().then(() => { metadataOutput.stop().then(() => {
console.log('Callback returned with metadataOutput stopped.'); console.log('Callback returned with metadataOutput stopped.');
}) }).catch((err) => {
console.log('Failed to metadataOutput stop '+ err.code);
});
``` ```
### on('metadataObjectsAvailable') ### on('metadataObjectsAvailable')
...@@ -3893,8 +2810,8 @@ Listens for metadata objects. This API uses an asynchronous callback to return t ...@@ -3893,8 +2810,8 @@ Listens for metadata objects. This API uses an asynchronous callback to return t
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | ------------------------------------------------ | ---- | ------------------------------------ | | -------- | ------------------------------------------------ | ---- | ------------------------------------ |
| type | string | Yes | Event type. The value is fixed at **'metadataObjectsAvailable'**, that is, the metadata object.| | type | string | Yes | Event type. The value is fixed at **'metadataObjectsAvailable'**. The callback function returns the valid metadata. This event can be listened for only when a **MetadataOutput** instance is created.|
| callback | Callback<Array<[MetadataObject](#metadataobject)\>\> | Yes | Callback used to return the error information. | | callback | Callback<Array<[MetadataObject](#metadataobject)\>\> | Yes | Callback used to return the metadata.|
**Example** **Example**
...@@ -3906,7 +2823,7 @@ metadataOutput.on('metadataObjectsAvailable', (metadataObjectArr) => { ...@@ -3906,7 +2823,7 @@ metadataOutput.on('metadataObjectsAvailable', (metadataObjectArr) => {
### on('error') ### on('error')
on(type: 'error', callback: ErrorCallback<MetadataOutputError\>): void on(type: 'error', callback: ErrorCallback<BusinessError\>): void
Listens for metadata errors. This API uses an asynchronous callback to return the result. Listens for metadata errors. This API uses an asynchronous callback to return the result.
...@@ -3916,8 +2833,8 @@ Listens for metadata errors. This API uses an asynchronous callback to return th ...@@ -3916,8 +2833,8 @@ Listens for metadata errors. This API uses an asynchronous callback to return th
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | ------------------------------------------------ | ---- | --------------------------------------- | | -------- | ------------------------------------------------ | ---- | --------------------------------------- |
| type | string | Yes | Event type. The value is fixed at **'error'**, that is, the metadata error.| | type | string | Yes | Event type. The value is fixed at **'error'**. The callback function returns the error code corresponding to an error that occurs during the call of a **MetadataOutput** instance API, for example, **start()** or **release()**.|
| callback | Callback<[MetadataOutputError](#metadataoutputerror)\> | Yes | Callback used to return the error information. | | callback | Callback<BusinessError\> | Yes | Callback used to return an error code defined in [CameraErrorCode](#cameraerrorcode). |
**Example** **Example**
...@@ -3927,36 +2844,15 @@ metadataOutput.on('error', (metadataOutputError) => { ...@@ -3927,36 +2844,15 @@ metadataOutput.on('error', (metadataOutputError) => {
}) })
``` ```
## MetadataOutputErrorCode
Enumerates the codes used for metadata output errors.
**System capability**: SystemCapability.Multimedia.Camera.Core
| Name | Value | Description |
| ------------------------------- | ---- | -------- |
| ERROR_UNKNOWN | -1 | Unknown error.|
| ERROR_INSUFFICIENT_RESOURCES | 0 | Insufficient resources.|
## MetadataOutputError
Defines a metadata output error.
**System capability**: SystemCapability.Multimedia.Camera.Core
| Name| Type | Mandatory | Description |
| ---- | ------------------------------------- | ----------------- | ----------------------- |
| code | [MetadataOutputErrorCode](#metadataoutputerrorcode) | Yes | **MetadataOutput** error code.|
## MetadataObjectType ## MetadataObjectType
Enumerates metadata streams. Enumerates the metadata object types.
**System capability**: SystemCapability.Multimedia.Camera.Core **System capability**: SystemCapability.Multimedia.Camera.Core
| Name | Value | Description | | Name | Value | Description |
| ------------------------- | ---- | ----------------- | | ------------------------- | ---- | ----------------- |
| FACE_DETECTION | 0 | Metadata object type.| | FACE_DETECTION | 0 | Face detection.|
## Rect ## Rect
...@@ -3975,156 +2871,8 @@ Defines a rectangle. ...@@ -3975,156 +2871,8 @@ Defines a rectangle.
Implements camera metadata, which is the data source of [CameraInput](#camerainput). The metadata is obtained through metadataOutput.on('metadataObjectsAvailable'). Implements camera metadata, which is the data source of [CameraInput](#camerainput). The metadata is obtained through metadataOutput.on('metadataObjectsAvailable').
### getType | Name | Type | Mandatory | Description |
| -------- | ------------------------------- | ---- | -----------------|
getType(callback: AsyncCallback<MetadataObjectType\>): void | type | [MetadataObjectType](#metadataobjecttype) | No | Metadata data type. Only face recognition is supported.|
| timestamp | number | No | Current timestamp, in milliseconds.|
Obtains the metadata object type. This API uses an asynchronous callback to return the result. | boundingBox | [Rect](#rect) | No | Metadata rectangle.|
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | --------------------------------------------------------- | --- | -------------------- |
| callback | AsyncCallback<[MetadataObjectType](#metadataobjecttype)\> | Yes | Callback used to return the result.|
**Example**
```js
let metadataObject = metadataObjectArr[0];
metadataObject.getType((err, metadataObjectType) => {
if (err) {
console.error(`Failed to get type. ${err.message}`);
return;
}
console.log('Callback returned with an array of metadataObjectType.');
})
```
### getType
getType(): Promise<MetadataObjectType\>
Obtains the metadata object type. This API uses a promise to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Return value**
| Type | Description |
| --------------------------------------------------- | --------------------------- |
| Promise<[MetadataObjectType](#metadataobjecttype)\> | Promise used to return the result.|
**Example**
```js
let metadataObject = metadataObjectArr[0];
metadataObject.getType().then((metadataObjectType) => {
console.log('Callback returned with an array of metadataObjectType.');
})
```
### getTimestamp
getTimestamp(callback: AsyncCallback<number\>): void
Obtains the metadata timestamp. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | ----------------------------------------------------------- | ---- | ------------------------ |
| callback | AsyncCallback<number\> | Yes | Callback used to return the result.|
**Example**
```js
let metadataObject = metadataObjectArr[0];
metadataObject.getTimestamp((err,timestamp) => {
if (err) {
console.error(`Failed to get timestamp. ${err.message}`);
return;
}
console.log('Callback returned with timestamp getted timestamp : ${timestamp}');
})
```
### getTimestamp
getTimestamp(): Promise<number\>
Obtains the metadata timestamp. This API uses a promise to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Return value**
| Type | Description |
| ---------------- | --------------------------- |
| Promise<number)\> | Promise used to return the result.|
**Example**
```js
let metadataObject = metadataObjectArr[0];
metadataObject.getTimestamp().then((timestamp) => {
console.log('Callback returned with timestamp getted timestamp : ${timestamp}');
})
```
### getBoundingBox
getBoundingBox(callback: AsyncCallback<Rect\>): void
Obtains the bounding box of metadata. This API uses an asynchronous callback to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Parameters**
| Name | Type | Mandatory| Description |
| -------- | ----------------------------------------------------------- | ---- | ------------------------ |
| callback | AsyncCallback<[Rect](#rect)\> | Yes | Callback used to return the result.|
**Example**
```js
let metadataObject = metadataObjectArr[0];
metadataObject.getBoundingBox((err, rect) => {
if (err) {
console.error(`Failed to get boundingBox. ${err.message}`);
return;
}
console.log('Callback returned with boundingBox getted.');
})
```
### getBoundingBox
getBoundingBox(): Promise<Rect\>
Obtains the bounding box of metadata. This API uses a promise to return the result.
**System capability**: SystemCapability.Multimedia.Camera.Core
**Return value**
| Type | Description |
| ---------------------- | --------------------------- |
| Promise<[Rect](#rect)\> | Promise used to return the result.|
**Example**
```js
let metadataObject = metadataObjectArr[0];
metadataObject.getBoundingBox().then((rect) => {
console.log('Callback returned with boundingBox getted.');
})
```
## MetadataFaceObject
Implements the face object of metadata. It inherits [MetadataObject](#metadataobject).
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或