Skip to content

D
Docs

OpenHarmony / Docs
1 年多 前同步成功

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

!2412 For DTS2022031703914 

Merge pull request !2412 from 蒋旻洋/master
上级 4877cc3a 4facea18
隐藏空白更改
内联 并排
Showing with 111 addition and 607 deletion
en/application-dev/reference/apis/js-apis-camera.md
浏览文件 @ c438943e
# Camera<a name="EN-US_TOPIC_0000001149807881"></a> # Camera<a name="EN-US_TOPIC_0000001149807881"></a>
> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE** > ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**
> The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version. > The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.
## Modules to Import ## Modules to Import
...@@ -31,11 +31,6 @@ Gets a **CameraManager** instance. This method uses an asynchronous callback to ...@@ -31,11 +31,6 @@ Gets a **CameraManager** instance. This method uses an asynchronous callback to
| context | Context | Yes | Application context | | context | Context | Yes | Application context |
| callback | AsyncCallback<CameraManager\> | Yes | Callback used to return the CameraManager instance | | callback | AsyncCallback<CameraManager\> | Yes | Callback used to return the CameraManager instance |
**Return values**
none
**Example** **Example**
``` ```
...@@ -82,59 +77,62 @@ camera.getCameraManager(context).then((cameraManger) => { ...@@ -82,59 +77,62 @@ camera.getCameraManager(context).then((cameraManger) => {
Enumerates camera status types. Enumerates camera status types.
**System Capabilities:**
SystemCapability.Multimedia.Camera.Core
| Name | Default Value | Description | | Name | Default Value | Description |
|---------------------------|---------------|--------------------| |---------------------------|---------------|--------------------|
| CAMERA_STATUS_APPEAR | 0 | Camera appear<br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | CAMERA_STATUS_APPEAR | 0 | Camera appear |
| CAMERA_STATUS_DISAPPEAR | 1 | Camera disappear <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | CAMERA_STATUS_DISAPPEAR | 1 | Camera disappear |
| CAMERA_STATUS_AVAILABLE | 2 | Camera available<br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | CAMERA_STATUS_AVAILABLE | 2 | Camera available |
| CAMERA_STATUS_UNAVAILABLE | 3 | Camera unavailable <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core| | CAMERA_STATUS_UNAVAILABLE | 3 | Camera unavailable |
## CameraPosition<a name="section_camera_position"></a> ## CameraPosition<a name="section_camera_position"></a>
Enumerates the camera positions. Enumerates the camera positions.
**System Capabilities:**
SystemCapability.Multimedia.Camera.Core
| Name | Default value | Description | | Name | Default value | Description |
|-----------------------------|---------------|-----------------------| |-----------------------------|---------------|-----------------------|
| CAMERA_POSITION_UNSPECIFIED | 0 | Unspecified position <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | CAMERA_POSITION_UNSPECIFIED | 0 | Unspecified position |
| CAMERA_POSITION_BACK | 1 | Rear camera <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | CAMERA_POSITION_BACK | 1 | Rear camera |
| CAMERA_POSITION_FRONT | 2 | Front camera <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | CAMERA_POSITION_FRONT | 2 | Front camera |
## CameraType<a name="section_camera_type"></a> ## CameraType<a name="section_camera_type"></a>
Enumerates the camera types. Enumerates the camera types.
**System Capabilities:**
SystemCapability.Multimedia.Camera.Core
| Name | Default value | Description | | Name | Default value | Description |
|-------------------------|---------------|-------------------------| |-------------------------|---------------|-------------------------|
| CAMERA_TYPE_UNSPECIFIED | 0 | Unspecified camera type <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | CAMERA_TYPE_UNSPECIFIED | 0 | Unspecified camera type |
| CAMERA_TYPE_WIDE_ANGLE | 1 | Wide camera <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | CAMERA_TYPE_WIDE_ANGLE | 1 | Wide camera |
| CAMERA_TYPE_ULTRA_WIDE | 2 | Ultra wide camera <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | CAMERA_TYPE_ULTRA_WIDE | 2 | Ultra wide camera |
| CAMERA_TYPE_TELEPHOTO | 3 | Telephoto camera <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | CAMERA_TYPE_TELEPHOTO | 3 | Telephoto camera |
| CAMERA_TYPE_TRUE_DEPTH | 4 | True depth camera <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | CAMERA_TYPE_TRUE_DEPTH | 4 | True depth camera |
## ConnectionType<a name="section_ConnectionType"></a> ## ConnectionType<a name="section_ConnectionType"></a>
Enumerates camera connection types. Enumerates camera connection types.
| Name | Default value | Description | **System Capabilities:**
|------------------------------|---------------|----------------------------|
| CAMERA_CONNECTION_BUILT_IN | 0 | Built-in camera <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core |
| CAMERA_CONNECTION_USB_PLUGIN | 1 | Camera connected using USB <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core |
| CAMERA_CONNECTION_REMOTE | 2 | Remote camera <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core |
## CameraFormat<a name="section_CameraFormat"></a>
Enumerates the camera formats.
| Name | Default value | Description | SystemCapability.Multimedia.Camera.Core
|----------------------------|---------------|---------------------|
| CAMERA_FORMAT_YCRCb_420_SP | 1003 | Camera YCRCb <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core |
| CAMERA_FORMAT_JPEG | 2000 | Camera format jpeg <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core |
| CAMERA_FORMAT_AVC | 3000 | Camera format avc <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core |
| CAMERA_FORMAT_HEVC | 3001 | Camera format hevc <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core |
| Name | Default value | Description |
|------------------------------|---------------|----------------------------|
| CAMERA_CONNECTION_BUILT_IN | 0 | Built-in camera |
| CAMERA_CONNECTION_USB_PLUGIN | 1 | Camera connected using USB |
| CAMERA_CONNECTION_REMOTE | 2 | Remote camera |
## CameraManager<a name="section_CameraManager"></a> ## CameraManager<a name="section_CameraManager"></a>
...@@ -156,10 +154,6 @@ Gets all cameras supported by the device. This method uses an asynchronous callb ...@@ -156,10 +154,6 @@ Gets all cameras supported by the device. This method uses an asynchronous callb
|----------|--------------------------------|-----------|---------------------------------------------------------| |----------|--------------------------------|-----------|---------------------------------------------------------|
| callback | AsyncCallback<Array<Camera\>\> | Yes | Callback used to return the array of supported cameras. | | callback | AsyncCallback<Array<Camera\>\> | Yes | Callback used to return the array of supported cameras. |
**Return values**
none
**Example** **Example**
``` ```
...@@ -182,10 +176,6 @@ SystemCapability.Multimedia.Camera.Core ...@@ -182,10 +176,6 @@ SystemCapability.Multimedia.Camera.Core
Gets all cameras supported by the device. This method uses a promise to return the array of supported cameras. Gets all cameras supported by the device. This method uses a promise to return the array of supported cameras.
**Parameters**
none
**Return values** **Return values**
| Type | Description | | Type | Description |
...@@ -218,10 +208,6 @@ Creates a **CameraInput** instance with the specified camera ID. This method use ...@@ -218,10 +208,6 @@ Creates a **CameraInput** instance with the specified camera ID. This method use
| cameraId | string | Yes | Camera ID used to create the instance | | cameraId | string | Yes | Camera ID used to create the instance |
| callback | AsyncCallback<CameraInput\> | Yes | Callback used to return the CameraInput instance | | callback | AsyncCallback<CameraInput\> | Yes | Callback used to return the CameraInput instance |
**Return values**
none
**Example** **Example**
``` ```
...@@ -282,10 +268,6 @@ Creates a **CameraInput** instance with the specified camera position and camera ...@@ -282,10 +268,6 @@ Creates a **CameraInput** instance with the specified camera position and camera
| cameraType | CameraType | Yes | Camera type | | cameraType | CameraType | Yes | Camera type |
| callback | AsyncCallback<CameraInput\> | Yes | Callback used to return the CameraInput instance | | callback | AsyncCallback<CameraInput\> | Yes | Callback used to return the CameraInput instance |
**Return values**
none
**Example** **Example**
``` ```
...@@ -346,10 +328,6 @@ Listens for camera status changes. This method uses a callback to get camera sta ...@@ -346,10 +328,6 @@ Listens for camera status changes. This method uses a callback to get camera sta
| type | string | Yes | Name of the event to listen for. | | type | string | Yes | Name of the event to listen for. |
| callback | Callback<CameraStatusInfo\> | Yes | Callback used to get the camera status change. | | callback | Callback<CameraStatusInfo\> | Yes | Callback used to get the camera status change. |
**Return value**
None
**Example** **Example**
``` ```
...@@ -361,38 +339,48 @@ cameraManager.on('cameraStatus', (cameraStatusInfo) => { ...@@ -361,38 +339,48 @@ cameraManager.on('cameraStatus', (cameraStatusInfo) => {
## Camera<a name="section_Camera"></a> ## Camera<a name="section_Camera"></a>
Camera class. when we call *cameraManager.getCameras()* API, then it will return the **Camera** class which will have all camera-related metadata such as *cameraId, cameraPosition, cameraType & connectionType*.
**System Capabilities:**
SystemCapability.Multimedia.Camera.Core
**Fields** **Fields**
| Name | Type | Access | Description | | Name | Type | Access | Description |
|----------------|----------------|----------|------------------------| |----------------|----------------|----------|------------------------|
| cameraId | string | readonly | Camera ID <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | cameraId | string | readonly | Camera ID |
| cameraPosition | cameraPosition | readonly | Camera position <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | cameraPosition | cameraPosition | readonly | Camera position |
| cameraType | cameraType | readonly | Camera type <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | cameraType | cameraType | readonly | Camera type |
| connectionType | connectionType | readonly | Camera connection type <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core| | connectionType | connectionType | readonly | Camera connection type |
``` ```
var cameraManager = await camera.getCameraManager(); async function getCameraInfo() {
var cameras = await cameraManager.getCameras(); var cameraManager = await camera.getCameraManager();
var cameraObj = cameras[0]; var cameras = await cameraManager.getCameras();
var cameraId = cameraObj.cameraId; var cameraObj = cameras[0];
var cameraPosition = cameraObj.cameraPosition; var cameraId = cameraObj.cameraId;
var cameraType = cameraObj.cameraType; var cameraPosition = cameraObj.cameraPosition;
var cameraId = cameraObj.connectionType; var cameraType = cameraObj.cameraType;
var cameraId = cameraObj.connectionType;
}
``` ```
## CameraStatusInfo<a name="section_Camera"></a> ## CameraStatusInfo<a name="section_Camera"></a>
CameraStatusInfo class. This interface is a CameraManager callback API return. **CameraStatusInfo** will have *Camera* class & *CameraStatus* predefine constants.From *Camera* class, we can have all camera-related metadata & from *CameraStatus* constants, we will have information such as *APPEAR, DISAPPEAR, AVAILABLE & UNAVAILABLE*.
**System Capabilities:**
SystemCapability.Multimedia.Camera.Core
**Fields** **Fields**
| Name | Type | Description | | Name | Type | Description |
|----------------|----------------|------------------| |----------------|----------------|------------------|
| camera | Camera | Camera object <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | camera | Camera | Camera object |
| status | CameraStatus | Camera status <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | status | CameraStatus | Camera status |
## CameraInput<a name="section_CameraInput"></a> ## CameraInput<a name="section_CameraInput"></a>
...@@ -415,10 +403,6 @@ Gets the camera ID based on which this **CameraInput** instance is created. This ...@@ -415,10 +403,6 @@ Gets the camera ID based on which this **CameraInput** instance is created. This
|----------|------------------------|-----------|---------------------------------------| |----------|------------------------|-----------|---------------------------------------|
| callback | AsyncCallback<string\> | Yes | Callback used to return the camera ID | | callback | AsyncCallback<string\> | Yes | Callback used to return the camera ID |
**Return values**
none
``` ```
cameraInput.getCameraId((err, cameraId) => { cameraInput.getCameraId((err, cameraId) => {
if (err) { if (err) {
...@@ -439,10 +423,6 @@ SystemCapability.Multimedia.Camera.Core ...@@ -439,10 +423,6 @@ SystemCapability.Multimedia.Camera.Core
Gets the camera ID based on which this **CameraInput** instance is created. This method uses a promise to return the camera ID. Gets the camera ID based on which this **CameraInput** instance is created. This method uses a promise to return the camera ID.
**Parameters**
none
**Return values** **Return values**
| Type | Description | | Type | Description |
...@@ -457,251 +437,6 @@ cameraInput.getCameraId().then((cameraId) => { ...@@ -457,251 +437,6 @@ cameraInput.getCameraId().then((cameraId) => {
}) })
``` ```
### getSupportedSizes\(format: CameraFormat, callback: AsyncCallback<Array<Size\>\>\): void;
**System Capabilities:**
SystemCapability.Multimedia.Camera.Core
**Description**
Gets supported sizes for a given format. This method uses an asynchronous callback to return the supported sizes.
**Parameters**
| Name | Type | Mandatory | Description |
|----------|------------------------------|-----------|---------------------------------------------|
| format | CameraFormat | Yes | Camera format used to get supported sizes |
| callback | AsyncCallback<Array<Size\>\> | Yes | Callback used to return the supported sizes |
**Return values**
none
**Example**
```
cameraInput.getSupportedSizes(format, (err, sizes) => {
if (err) {
console.error('Failed to get the supported sizes. ${err.message}');
return;
}
console.log('Callback returned with the supported sizes:' + sizes);
})
```
### getSupportedSizes\(format: CameraFormat\): Promise<Array<Size\>\>;
**System Capabilities:**
SystemCapability.Multimedia.Camera.Core
**Description**
Gets supported sizes for a given format. This method uses a promise to return the supported sizes.
**Parameters**
| Name | Type | Mandatory | Description |
|----------|----------------------------|-----------|-----------------------------------------------|
| format | CameraFormat | Yes | Camera format used to get the supported sizes |
**Return values**
| Type | Description |
|------------------------|---------------------------------------------|
| Promise<Array<Size\>\> | Promise used to return the supported sizes. |
**Example**
```
cameraInput.getSupportedSizes(format).then((sizes) => {
console.log('Promise returned with supported sizes: ' + sizes);
})
```
### getSupportedPreviewFormats\(callback: AsyncCallback<Array<CameraFormat\>\>\): void;
**System Capabilities:**
SystemCapability.Multimedia.Camera.Core
**Description**
Gets supported formats for preview. This method uses an asynchronous callback to return the supported formats.
**Parameters**
| Name | Type | Mandatory | Description |
|----------|--------------------------------------|-----------|---------------------------------------------------|
| callback | AsyncCallback<Array<CameraFormat\>\> | Yes | Callback used to return the supported preview formats. |
**Return values**
none
**Example**
```
cameraInput.getSupportedPreviewFormats((err, previewFormats) => {
if (err) {
console.error('Failed to get the supported preview formats. ${err.message}');
return;
}
console.log('Callback returned with supported preview formats: ' + previewFormats.length);
})
```
### getSupportedPreviewFormats\(\): Promise<Array<CameraFormat\>\>;
**System Capabilities:**
SystemCapability.Multimedia.Camera.Core
**Description**
Gets supported formats for preview. This method uses a promise to return the supported formats.
**Parameters**
none
**Return values**
| Type | Description |
|--------------------------------|-------------------------------------------------------|
| Promise<Array<CameraFormat\>\> | Promise used to return the supported preview formats |
**Example**
```
cameraInput.getSupportedPreviewFormats().then((previewFormats) => {
console.log('Promise returned with supported preview formats.' + previewFormats.length);
})
```
### getSupportedPhotoFormats\(callback: AsyncCallback<Array<CameraFormat\>\>\): void;<a name="section189141826104616"></a>
**System Capabilities:**
SystemCapability.Multimedia.Camera.Core
**Description**
Gets supported formats for photographing. This method uses an asynchronous callback to return the supported formats.
**Parameters**
| Name | Type | Mandatory | Description |
|----------|--------------------------------------|-----------|-------------------------------------------------|
| callback | AsyncCallback<Array<CameraFormat\>\> | Yes | Callback used to return the supported photo formats. |
**Return values**
none
**Example**
```
cameraInput.getSupportedPhotoFormats((err, photoFormats) => {
if (err) {
console.error('Failed to get the supported photo formats. ${err.message}');
return;
}
console.log('Callback returned with supported photo formats');
})
```
### getSupportedPhotoFormats\(\): Promise<Array<CameraFormat\>\>;<a name="section189141826104616"></a>
**System Capabilities:**
SystemCapability.Multimedia.Camera.Core
**Description**
Gets supported formats for photographing. This method uses a promise to return the supported formats.
**Parameters**
none
**Return values**
| Type | Description |
|--------------------------------|---------------------------------------------------|
| Promise<Array<CameraFormat\>\> | Promise used to return supported photo formats. |
**Example**
```
cameraInput.getSupportedPhotoFormats().then((photoFormats) => {
console.log('Promise returned with supported photo formats.' + photoFormats.length);
})
```
### getSupportedVideoFormats\(callback: AsyncCallback<Array<CameraFormat\>\>\): void;
**System Capabilities:**
SystemCapability.Multimedia.Camera.Core
**Description**
Gets supported formats for video recording. This method uses an asynchronous callback to return the supported video formats.
**Parameters**
| Name | Type | Mandatory | Description |
|----------|--------------------------------------|-----------|-------------------------------------------------|
| callback | AsyncCallback<Array<CameraFormat\>\> | Yes | Callback used to return the supported video formats. |
**Return values**
none
**Example**
```
cameraInput.getSupportedVideoFormats((err, videoFormats) => {
if (err) {
console.error('Failed to get the supported video formats. ${err.message}');
return;
}
console.log('Callback returned with supported video formats : ' + videoFormats.length);
})
```
### getSupportedVideoFormats\(\): Promise<Array<CameraFormat\>\>;
**System Capabilities:**
SystemCapability.Multimedia.Camera.Core
**Description**
Gets supported formats for video recording. This method uses a promise to return the supported video format.
**Parameters**
none
**Return values**
| Type | Description |
|--------------------------------|---------------------------------------------------|
| Promise<Array<CameraFormat\>\> | Promise used to return supported video formats. |
**Example**
```
cameraInput.getSupportedVideoFormats().then((videoFormats) => {
console.log('Promise returned with supported video formats.' + videoFormats.length);
})
```
### hasFlash(callback: AsyncCallback<boolean\>): void; <a name="sec_hasFlash"></a> ### hasFlash(callback: AsyncCallback<boolean\>): void; <a name="sec_hasFlash"></a>
**System Capabilities:** **System Capabilities:**
...@@ -718,10 +453,6 @@ Checks whether the device has flash light. This method uses an asynchronous call ...@@ -718,10 +453,6 @@ Checks whether the device has flash light. This method uses an asynchronous call
|----------|-------------------------|-----------|----------------------------------------------------| |----------|-------------------------|-----------|----------------------------------------------------|
| callback | AsyncCallback<boolean\> | Yes | Callback used to return the flash light support status | | callback | AsyncCallback<boolean\> | Yes | Callback used to return the flash light support status |
**Return values**
none
**Example** **Example**
``` ```
...@@ -744,10 +475,6 @@ SystemCapability.Multimedia.Camera.Core ...@@ -744,10 +475,6 @@ SystemCapability.Multimedia.Camera.Core
Checks whether the device has flash light. This method uses a promise to return the result. Checks whether the device has flash light. This method uses a promise to return the result.
**Parameters**
none
**Return values** **Return values**
| Type | Description | | Type | Description |
...@@ -779,10 +506,6 @@ Checks whether a specified flash mode is supported. This method uses an asynchro ...@@ -779,10 +506,6 @@ Checks whether a specified flash mode is supported. This method uses an asynchro
| flashMode | <a href="#sec_FlashMode">FlashMode</a> | Yes | Flash mode | | flashMode | <a href="#sec_FlashMode">FlashMode</a> | Yes | Flash mode |
| callback | AsyncCallback<boolean\> | Yes | Callback used to return the device flash support status | | callback | AsyncCallback<boolean\> | Yes | Callback used to return the device flash support status |
**Return values**
none
**Example** **Example**
``` ```
...@@ -844,10 +567,6 @@ Note: Before setting the flash mode, check the support for the flash light (<a h ...@@ -844,10 +567,6 @@ Note: Before setting the flash mode, check the support for the flash light (<a h
| flashMode | <a href="#sec_FlashMode">FlashMode</a> | Yes | Flash mode | | flashMode | <a href="#sec_FlashMode">FlashMode</a> | Yes | Flash mode |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -887,7 +606,7 @@ Note: Before setting the flash mode, check the support for the flash light (<a h ...@@ -887,7 +606,7 @@ Note: Before setting the flash mode, check the support for the flash light (<a h
**Example** **Example**
``` ```
cameraInput.setFlashMode(flashMode).then() => { cameraInput.setFlashMode(flashMode).then(() => {
console.log('Promise returned with the successful execution of setFlashMode.'); console.log('Promise returned with the successful execution of setFlashMode.');
}) })
``` ```
...@@ -908,10 +627,6 @@ Gets current flash mode. This method uses an asynchronous callback to return the ...@@ -908,10 +627,6 @@ Gets current flash mode. This method uses an asynchronous callback to return the
|-----------|---------------------------|-----------|------------------------------------------------| |-----------|---------------------------|-----------|------------------------------------------------|
| callback | AsyncCallback<FlashMode\> | Yes | Callback used to return the current flash mode | | callback | AsyncCallback<FlashMode\> | Yes | Callback used to return the current flash mode |
**Return values**
none
**Example** **Example**
``` ```
...@@ -934,10 +649,6 @@ SystemCapability.Multimedia.Camera.Core ...@@ -934,10 +649,6 @@ SystemCapability.Multimedia.Camera.Core
Gets current flash mode. This method uses a promise to return the result. Gets current flash mode. This method uses a promise to return the result.
**Parameters**
none
**Return values** **Return values**
| Type | Description | | Type | Description |
...@@ -947,7 +658,7 @@ none ...@@ -947,7 +658,7 @@ none
**Example** **Example**
``` ```
cameraInput.getFlashMode().then(flashMode) => { cameraInput.getFlashMode().then((flashMode) => {
console.log('Promise returned with current flash mode : ' + flashMode); console.log('Promise returned with current flash mode : ' + flashMode);
}) })
``` ```
...@@ -969,10 +680,6 @@ Checks whether a specified focus mode is supported. This method uses an asynchro ...@@ -969,10 +680,6 @@ Checks whether a specified focus mode is supported. This method uses an asynchro
| afMode | <a href="#sec_FocusMode">FocusMode</a> | Yes | Focus mode | | afMode | <a href="#sec_FocusMode">FocusMode</a> | Yes | Focus mode |
| callback | AsyncCallback<boolean\> | Yes | Callback used to return the device focus support status | | callback | AsyncCallback<boolean\> | Yes | Callback used to return the device focus support status |
**Return values**
none
**Example** **Example**
``` ```
...@@ -1034,10 +741,6 @@ Note: Before setting the focus mode, check focus mode support (<a href="#sec_isF ...@@ -1034,10 +741,6 @@ Note: Before setting the focus mode, check focus mode support (<a href="#sec_isF
| afMode | <a href="#sec_FocusMode">FocusMode</a> | Yes | Focus mode | | afMode | <a href="#sec_FocusMode">FocusMode</a> | Yes | Focus mode |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -1077,7 +780,7 @@ Note: Before setting the focus mode, check focus mode support (<a href="#sec_isF ...@@ -1077,7 +780,7 @@ Note: Before setting the focus mode, check focus mode support (<a href="#sec_isF
**Example** **Example**
``` ```
cameraInput.setFocusMode(afMode).then() => { cameraInput.setFocusMode(afMode).then(() => {
console.log('Promise returned with the successful execution of setFocusMode.'); console.log('Promise returned with the successful execution of setFocusMode.');
}) })
``` ```
...@@ -1098,10 +801,6 @@ Gets the current focus mode. This method uses an asynchronous callback to return ...@@ -1098,10 +801,6 @@ Gets the current focus mode. This method uses an asynchronous callback to return
|-----------|---------------------------|-----------|------------------------------------------------| |-----------|---------------------------|-----------|------------------------------------------------|
| callback | AsyncCallback<FocusMode\> | Yes | Callback used to return the current focus mode | | callback | AsyncCallback<FocusMode\> | Yes | Callback used to return the current focus mode |
**Return values**
none
**Example** **Example**
``` ```
...@@ -1124,10 +823,6 @@ SystemCapability.Multimedia.Camera.Core ...@@ -1124,10 +823,6 @@ SystemCapability.Multimedia.Camera.Core
Gets the current focus mode. This method uses a promise to return the result. Gets the current focus mode. This method uses a promise to return the result.
**Parameters**
none
**Return values** **Return values**
| Type | Description | | Type | Description |
...@@ -1137,7 +832,7 @@ none ...@@ -1137,7 +832,7 @@ none
**Example** **Example**
``` ```
cameraInput.getFocusMode().then(afMode) => { cameraInput.getFocusMode().then((afMode) => {
console.log('Promise returned with current focus mode : ' + afMode); console.log('Promise returned with current focus mode : ' + afMode);
}) })
``` ```
...@@ -1158,15 +853,10 @@ Gets the zoom ratios of all zoom values. This method uses an asynchronous callba ...@@ -1158,15 +853,10 @@ Gets the zoom ratios of all zoom values. This method uses an asynchronous callba
|----------|--------------------------------|-----------|-------------------------------------------------| |----------|--------------------------------|-----------|-------------------------------------------------|
| callback | AsyncCallback<Array<number\>\> | Yes | Callback used to return the zoom ratio range | | callback | AsyncCallback<Array<number\>\> | Yes | Callback used to return the zoom ratio range |
**Return values**
none
**Example** **Example**
``` ```
cameraInput.getZoomRatioRange(err, zoomRatioRange) => { cameraInput.getZoomRatioRange((err, zoomRatioRange) => {
if (err) { if (err) {
console.error('Failed to get the zoom ratio range. ${err.message}'); console.error('Failed to get the zoom ratio range. ${err.message}');
return; return;
...@@ -1185,10 +875,6 @@ SystemCapability.Multimedia.Camera.Core ...@@ -1185,10 +875,6 @@ SystemCapability.Multimedia.Camera.Core
Gets the zoom ratios of all zoom values. This method uses a promise to return the result. Gets the zoom ratios of all zoom values. This method uses a promise to return the result.
**Parameters**
none
**Return values** **Return values**
| Type | Description | | Type | Description |
...@@ -1220,10 +906,6 @@ Sets a zoom ratio. This method uses an asynchronous callback to return the resul ...@@ -1220,10 +906,6 @@ Sets a zoom ratio. This method uses an asynchronous callback to return the resul
| zoomRatio | number | Yes | Zoom ratio | | zoomRatio | number | Yes | Zoom ratio |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -1261,7 +943,7 @@ Sets a zoom ratio. This method uses a promise to return the result. ...@@ -1261,7 +943,7 @@ Sets a zoom ratio. This method uses a promise to return the result.
**Example** **Example**
``` ```
cameraInput.setZoomRatio(zoomRatio).then() => { cameraInput.setZoomRatio(zoomRatio).then(() => {
console.log('Promise returned with the successful execution of setZoomRatio.'); console.log('Promise returned with the successful execution of setZoomRatio.');
}) })
``` ```
...@@ -1282,10 +964,6 @@ Gets current zoom ratio value. This method uses an asynchronous callback to retu ...@@ -1282,10 +964,6 @@ Gets current zoom ratio value. This method uses an asynchronous callback to retu
|-----------|---------------------------|-----------|------------------------------------------------------| |-----------|---------------------------|-----------|------------------------------------------------------|
| callback | AsyncCallback<number\> | Yes | Callback used to return the current zoom ratio value | | callback | AsyncCallback<number\> | Yes | Callback used to return the current zoom ratio value |
**Return values**
none
**Example** **Example**
``` ```
...@@ -1308,10 +986,6 @@ SystemCapability.Multimedia.Camera.Core ...@@ -1308,10 +986,6 @@ SystemCapability.Multimedia.Camera.Core
Gets current zoom ratio value. This method uses a promise to return the result. Gets current zoom ratio value. This method uses a promise to return the result.
**Parameters**
none
**Return values** **Return values**
| Type | Description | | Type | Description |
...@@ -1321,7 +995,7 @@ none ...@@ -1321,7 +995,7 @@ none
**Example** **Example**
``` ```
cameraInput.getZoomRatio().then(zoomRatio) => { cameraInput.getZoomRatio().then((zoomRatio) => {
console.log('Promise returned with current zoom ratio : ' + zoomRatio); console.log('Promise returned with current zoom ratio : ' + zoomRatio);
}) })
``` ```
...@@ -1342,10 +1016,6 @@ Releases this **CameraInput** instance. This method uses an asynchronous callbac ...@@ -1342,10 +1016,6 @@ Releases this **CameraInput** instance. This method uses an asynchronous callbac
|----------|----------------------|-----------|------------------------------------| |----------|----------------------|-----------|------------------------------------|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -1368,10 +1038,6 @@ SystemCapability.Multimedia.Camera.Core ...@@ -1368,10 +1038,6 @@ SystemCapability.Multimedia.Camera.Core
Releases this **CameraInput** instance. This method uses a promise to return the result. Releases this **CameraInput** instance. This method uses a promise to return the result.
**Parameters**
none
**Return values** **Return values**
| Type | Description | | Type | Description |
...@@ -1403,10 +1069,6 @@ Listens for focus state changes. This method uses a callback to get focus state ...@@ -1403,10 +1069,6 @@ Listens for focus state changes. This method uses a callback to get focus state
| type | string | Yes | Name of the event to listen for. | | type | string | Yes | Name of the event to listen for. |
| callback | Callback<FocusState\> | Yes | Callback used to get the focus state change. | | callback | Callback<FocusState\> | Yes | Callback used to get the focus state change. |
**Return value**
None
**Example** **Example**
``` ```
...@@ -1432,10 +1094,6 @@ Listens for **CameraInput** errors. This method uses a callback to get errors. ...@@ -1432,10 +1094,6 @@ Listens for **CameraInput** errors. This method uses a callback to get errors.
| type | string | Yes | Name of the event to listen for. | | type | string | Yes | Name of the event to listen for. |
| callback | Callback<CameraInputError\> | Yes | Callback used to get the camera input errors. | | callback | Callback<CameraInputError\> | Yes | Callback used to get the camera input errors. |
**Return value**
None
**Example** **Example**
``` ```
...@@ -1448,24 +1106,31 @@ cameraInput.on('error', (cameraInputError) => { ...@@ -1448,24 +1106,31 @@ cameraInput.on('error', (cameraInputError) => {
Enumerates the flash modes. Enumerates the flash modes.
**System Capabilities:**
SystemCapability.Multimedia.Camera.Core
| Name | Default value | Description | | Name | Default value | Description |
|------------------------|---------------|------------------------| |------------------------|---------------|------------------------|
| FLASH_MODE_CLOSE | 0 | Flash mode close <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | FLASH_MODE_CLOSE | 0 | Flash mode close |
| FLASH_MODE_OPEN | 1 | Flash mode open <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | FLASH_MODE_OPEN | 1 | Flash mode open |
| FLASH_MODE_AUTO | 2 | Flash mode auto <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | FLASH_MODE_AUTO | 2 | Flash mode auto |
| FLASH_MODE_ALWAYS_OPEN | 3 | Flash mode always open <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | FLASH_MODE_ALWAYS_OPEN | 3 | Flash mode always open |
## FocusMode <a name="sec_FocusMode"></a> ## FocusMode <a name="sec_FocusMode"></a>
Enumerates the focus modes. Enumerates the focus modes.
**System Capabilities:**
SystemCapability.Multimedia.Camera.Core
| Name | Default value | Description | | Name | Default value | Description |
|----------------------------|---------------|----------------------------| |----------------------------|---------------|----------------------------|
| FOCUS_MODE_MANUAL | 0 | Focus mode manual <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | FOCUS_MODE_MANUAL | 0 | Focus mode manual |
| FOCUS_MODE_CONTINUOUS_AUTO | 1 | Focus mode continuous auto <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core| | FOCUS_MODE_CONTINUOUS_AUTO | 1 | Focus mode continuous auto |
| FOCUS_MODE_AUTO | 2 | Focus mode auto <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | FOCUS_MODE_AUTO | 2 | Focus mode auto |
| FOCUS_MODE_LOCKED | 3 | Focus mode locked <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | FOCUS_MODE_LOCKED | 3 | Focus mode locked |
## createCaptureSession\(context: Context, callback: AsyncCallback<CaptureSession\>\): void; ## createCaptureSession\(context: Context, callback: AsyncCallback<CaptureSession\>\): void;
...@@ -1484,14 +1149,10 @@ Creates a **CaptureSession** instance. This method uses an asynchronous callback ...@@ -1484,14 +1149,10 @@ Creates a **CaptureSession** instance. This method uses an asynchronous callback
| context | Context | Yes | Application context | | context | Context | Yes | Application context |
| callback | AsyncCallback<CaptureSession\> | Yes | Callback used to return the CaptureSession instance | | callback | AsyncCallback<CaptureSession\> | Yes | Callback used to return the CaptureSession instance |
**Return values**
none
**Example** **Example**
``` ```
captureSession.createCaptureSession(context), (err, captureSession) => { captureSession.createCaptureSession((context), (err, captureSession) => {
if (err) { if (err) {
console.error('Failed to create the CaptureSession instance. ${err.message}'); console.error('Failed to create the CaptureSession instance. ${err.message}');
return; return;
...@@ -1550,10 +1211,6 @@ Starts configuration for this CaptureSession instance. This method uses an async ...@@ -1550,10 +1211,6 @@ Starts configuration for this CaptureSession instance. This method uses an async
|----------|----------------------|-----------|----------------------------------------------| |----------|----------------------|-----------|----------------------------------------------|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -1576,10 +1233,6 @@ SystemCapability.Multimedia.Camera.Core ...@@ -1576,10 +1233,6 @@ SystemCapability.Multimedia.Camera.Core
Starts configuration for this CaptureSession instance. This method uses a promise to return the result. Starts configuration for this CaptureSession instance. This method uses a promise to return the result.
**Parameters**
none
**Return values** **Return values**
| Type | Description | | Type | Description |
...@@ -1611,10 +1264,6 @@ Commits the configuration for this CaptureSession instance. This method uses an ...@@ -1611,10 +1264,6 @@ Commits the configuration for this CaptureSession instance. This method uses an
|----------|---------------------|-----------|----------------------------------------------| |----------|---------------------|-----------|----------------------------------------------|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -1637,10 +1286,6 @@ SystemCapability.Multimedia.Camera.Core ...@@ -1637,10 +1286,6 @@ SystemCapability.Multimedia.Camera.Core
Commits the configuration for this CaptureSession instance. This method uses a promise to return the result. Commits the configuration for this CaptureSession instance. This method uses a promise to return the result.
**Parameters**
none
**Return values** **Return values**
| Type | Description | | Type | Description |
...@@ -1672,10 +1317,6 @@ Add a CameraInput instance to this CaptureSession instance. This method uses an ...@@ -1672,10 +1317,6 @@ Add a CameraInput instance to this CaptureSession instance. This method uses an
| cameraInput | CameraInput | Yes | CameraInput instance to add | | cameraInput | CameraInput | Yes | CameraInput instance to add |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -1735,10 +1376,6 @@ Add a PreviewOutput instance to this CaptureSession instance. This method uses a ...@@ -1735,10 +1376,6 @@ Add a PreviewOutput instance to this CaptureSession instance. This method uses a
| previewOutput | PreviewOutput | Yes | PreviewOutput instance to add | | previewOutput | PreviewOutput | Yes | PreviewOutput instance to add |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -1798,10 +1435,6 @@ Add a PhotoOutput instance to this CaptureSession instance. This method uses an ...@@ -1798,10 +1435,6 @@ Add a PhotoOutput instance to this CaptureSession instance. This method uses an
| photoOutput | PhotoOutput | Yes | PhotoOutput instance to add | | photoOutput | PhotoOutput | Yes | PhotoOutput instance to add |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -1861,10 +1494,6 @@ Add a VideoOutput instance to this CaptureSession instance. This method uses an ...@@ -1861,10 +1494,6 @@ Add a VideoOutput instance to this CaptureSession instance. This method uses an
| videoOutput | VideoOutput | Yes | VideoOutput instance to add | | videoOutput | VideoOutput | Yes | VideoOutput instance to add |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -1924,11 +1553,6 @@ Removes a **CameraInput** instance from this **CaptureSession** instance. This m ...@@ -1924,11 +1553,6 @@ Removes a **CameraInput** instance from this **CaptureSession** instance. This m
| cameraInput | CameraInput | Yes | CameraInput instance to remove | | cameraInput | CameraInput | Yes | CameraInput instance to remove |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -1988,10 +1612,6 @@ Removes a **PreviewOutput** instance from this **CaptureSession** instance. This ...@@ -1988,10 +1612,6 @@ Removes a **PreviewOutput** instance from this **CaptureSession** instance. This
| previewOutput | PreviewOutput | Yes | PreviewOutput instance to remove | | previewOutput | PreviewOutput | Yes | PreviewOutput instance to remove |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -2053,10 +1673,6 @@ Removes a **PhotoOutput** instance from this **CaptureSession** instance. This m ...@@ -2053,10 +1673,6 @@ Removes a **PhotoOutput** instance from this **CaptureSession** instance. This m
| photoOutput | PhotoOutput | Yes | PhotoOutput instance to remove | | photoOutput | PhotoOutput | Yes | PhotoOutput instance to remove |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -2118,10 +1734,6 @@ Removes a **VideoOutput** instance from this **CaptureSession** instance. This m ...@@ -2118,10 +1734,6 @@ Removes a **VideoOutput** instance from this **CaptureSession** instance. This m
| videoOutput | VideoOutput | Yes | VideoOutput instance to remove | | videoOutput | VideoOutput | Yes | VideoOutput instance to remove |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -2182,10 +1794,6 @@ Starts this **CaptureSession** instance. This method uses an asynchronous callba ...@@ -2182,10 +1794,6 @@ Starts this **CaptureSession** instance. This method uses an asynchronous callba
|----------|----------------------|-----------|----------------------------------------------| |----------|----------------------|-----------|----------------------------------------------|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -2208,10 +1816,6 @@ SystemCapability.Multimedia.Camera.Core ...@@ -2208,10 +1816,6 @@ SystemCapability.Multimedia.Camera.Core
Starts this **CaptureSession** instance. This method uses a promise to return the result. Starts this **CaptureSession** instance. This method uses a promise to return the result.
**Parameters**
none
**Return values** **Return values**
| Type | Description | | Type | Description |
...@@ -2243,10 +1847,6 @@ Stops this **CaptureSession** instance. This method uses an asynchronous callbac ...@@ -2243,10 +1847,6 @@ Stops this **CaptureSession** instance. This method uses an asynchronous callbac
|----------|----------------------|-----------|------------------------------------| |----------|----------------------|-----------|------------------------------------|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -2269,10 +1869,6 @@ SystemCapability.Multimedia.Camera.Core ...@@ -2269,10 +1869,6 @@ SystemCapability.Multimedia.Camera.Core
Stops this **CaptureSession** instance. This method uses a promise to return the result. Stops this **CaptureSession** instance. This method uses a promise to return the result.
**Parameters**
none
**Return values** **Return values**
| Type | Description | | Type | Description |
...@@ -2303,10 +1899,6 @@ Releases this **CaptureSession** instance. This method uses an asynchronous call ...@@ -2303,10 +1899,6 @@ Releases this **CaptureSession** instance. This method uses an asynchronous call
|----------|----------------------|-----------|------------------------------------| |----------|----------------------|-----------|------------------------------------|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -2329,10 +1921,6 @@ SystemCapability.Multimedia.Camera.Core ...@@ -2329,10 +1921,6 @@ SystemCapability.Multimedia.Camera.Core
Releases this **CaptureSession** instance. This method uses a promise to return the result. Releases this **CaptureSession** instance. This method uses a promise to return the result.
**Parameters**
none
**Return values** **Return values**
| Type | Description | | Type | Description |
...@@ -2364,10 +1952,6 @@ Listens for **CaptureSession** errors. This method uses a callback to get errors ...@@ -2364,10 +1952,6 @@ Listens for **CaptureSession** errors. This method uses a callback to get errors
| type | string | Yes | Name of the event to listen for. | | type | string | Yes | Name of the event to listen for. |
| callback | Callback<CaptureSessionError\> | Yes | Callback used to get the capture session errors. | | callback | Callback<CaptureSessionError\> | Yes | Callback used to get the capture session errors. |
**Return value**
None
**Example** **Example**
``` ```
...@@ -2393,14 +1977,10 @@ Creates a **PreviewOutput** instance. This method uses an asynchronous callback ...@@ -2393,14 +1977,10 @@ Creates a **PreviewOutput** instance. This method uses an asynchronous callback
| surfaceId | string | Yes | Surface ID received from XComponent view | | surfaceId | string | Yes | Surface ID received from XComponent view |
| callback | AsyncCallback<PreviewOutput\> | Yes | Callback used to return the PreviewOutput instance | | callback | AsyncCallback<PreviewOutput\> | Yes | Callback used to return the PreviewOutput instance |
**Return values**
none
**Example** **Example**
``` ```
camera.createPreviewOutput(surfaceId), (err, previewOutput) => { camera.createPreviewOutput((surfaceId), (err, previewOutput) => {
if (err) { if (err) {
console.error('Failed to create the PreviewOutput instance. ${err.message}'); console.error('Failed to create the PreviewOutput instance. ${err.message}');
return; return;
...@@ -2459,10 +2039,6 @@ Releases this **PreviewOutput** instance. This method uses an asynchronous callb ...@@ -2459,10 +2039,6 @@ Releases this **PreviewOutput** instance. This method uses an asynchronous callb
|----------|----------------------|-----------|----------------------------------------------| |----------|----------------------|-----------|----------------------------------------------|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -2485,9 +2061,6 @@ SystemCapability.Multimedia.Camera.Core ...@@ -2485,9 +2061,6 @@ SystemCapability.Multimedia.Camera.Core
Releases this **PreviewOutput** instance. This method uses a promise to return the result. Releases this **PreviewOutput** instance. This method uses a promise to return the result.
**Parameters**
none
**Return values** **Return values**
| Type | Description | | Type | Description |
...@@ -2520,10 +2093,6 @@ Listens for preview frame start events. This method uses a callback to get the e ...@@ -2520,10 +2093,6 @@ Listens for preview frame start events. This method uses a callback to get the e
| type | string | Yes | Name of the event to listen for. | | type | string | Yes | Name of the event to listen for. |
| callback | Callback<void\> | Yes | Callback used to return the result | | callback | Callback<void\> | Yes | Callback used to return the result |
**Return value**
None
**Example** **Example**
``` ```
...@@ -2549,10 +2118,6 @@ Listens for preview frame end event. This method uses a callback to get the even ...@@ -2549,10 +2118,6 @@ Listens for preview frame end event. This method uses a callback to get the even
| type | string | Yes | Name of the event to listen for. | | type | string | Yes | Name of the event to listen for. |
| callback | Callback<void\> | Yes | Callback used to return the result | | callback | Callback<void\> | Yes | Callback used to return the result |
**Return value**
None
**Example** **Example**
``` ```
...@@ -2578,10 +2143,6 @@ Listens for **PreviewOutput** errors. This method uses a callback to get errors. ...@@ -2578,10 +2143,6 @@ Listens for **PreviewOutput** errors. This method uses a callback to get errors.
| type | string | Yes | Name of the event to listen for. | | type | string | Yes | Name of the event to listen for. |
| callback | Callback<PreviewOutputError\> | Yes | Callback used to get the preview output errors. | | callback | Callback<PreviewOutputError\> | Yes | Callback used to get the preview output errors. |
**Return value**
None
**Example** **Example**
``` ```
...@@ -2607,14 +2168,10 @@ Creates a **PhotoOutput** instance. This method uses an asynchronous callback to ...@@ -2607,14 +2168,10 @@ Creates a **PhotoOutput** instance. This method uses an asynchronous callback to
| surfaceId | string | Yes | Surface ID received from ImageReceiver | | surfaceId | string | Yes | Surface ID received from ImageReceiver |
| callback | AsyncCallback<PhotoOutput\> | Yes | Callback used to return the PhotoOutput instance | | callback | AsyncCallback<PhotoOutput\> | Yes | Callback used to return the PhotoOutput instance |
**Return values**
none
**Example** **Example**
``` ```
camera.createPhotoOutput(surfaceId), (err, photoOutput) => { camera.createPhotoOutput((surfaceId), (err, photoOutput) => {
if (err) { if (err) {
console.error('Failed to create the PhotoOutput instance. ${err.message}'); console.error('Failed to create the PhotoOutput instance. ${err.message}');
return; return;
...@@ -2656,42 +2213,58 @@ camera.createPhotoOutput(surfaceId).then((photoOutput) => { ...@@ -2656,42 +2213,58 @@ camera.createPhotoOutput(surfaceId).then((photoOutput) => {
Enumerates the image rotation angles. Enumerates the image rotation angles.
**System Capabilities:**
SystemCapability.Multimedia.Camera.Core
| Name | Default Value | Description | | Name | Default Value | Description |
|--------------|---------------|----------------------------------------| |--------------|---------------|----------------------------------------|
| ROTATION_0 | 0 | The capture image rotates 0 degrees <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | ROTATION_0 | 0 | The capture image rotates 0 degrees |
| ROTATION_90 | 90 | The capture image rotates 90 degrees <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | ROTATION_90 | 90 | The capture image rotates 90 degrees |
| ROTATION_180 | 180 | The capture image rotates 180 degrees <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | ROTATION_180 | 180 | The capture image rotates 180 degrees |
| ROTATION_270 | 270 | The capture image rotates 270 degrees <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core| | ROTATION_270 | 270 | The capture image rotates 270 degrees |
## Location ## Location
Defines the location of a captured image. Defines the location of a captured image.
**System Capabilities:**
SystemCapability.Multimedia.Camera.Core
| Name | Type | Access | Description | | Name | Type | Access | Description |
|-----------|--------|--------------|-------------| |-----------|--------|--------------|-------------|
| latitude | number | read / write | Latitude <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | latitude | number | read / write | Latitude |
| longitude | number | read / write | Longitude <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | longitude | number | read / write | Longitude |
## QualityLevel ## QualityLevel
Enumerates the image quality levels. Enumerates the image quality levels.
**System Capabilities:**
SystemCapability.Multimedia.Camera.Core
| Name | Default value | Description | | Name | Default value | Description |
|----------------------|---------------|----------------------| |----------------------|---------------|----------------------|
| QUALITY_LEVEL_HIGH | 0 | High image quality <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | QUALITY_LEVEL_HIGH | 0 | High image quality |
| QUALITY_LEVEL_MEDIUM | 1 | Medium image quality <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | QUALITY_LEVEL_MEDIUM | 1 | Medium image quality |
| QUALITY_LEVEL_LOW | 2 | Low image quality <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | QUALITY_LEVEL_LOW | 2 | Low image quality |
## PhotoCaptureSetting ## PhotoCaptureSetting
Defines the settings for image capture. Defines the settings for image capture.
**System Capabilities:**
SystemCapability.Multimedia.Camera.Core
| Name | Type | Mandatory | Description | | Name | Type | Mandatory | Description |
|----------|---------------|-----------|---------------------| |----------|---------------|-----------|---------------------|
| quality | QualityLevel | Optional | Photo image quality <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core| | quality | QualityLevel | Optional | Photo image quality |
| rotation | ImageRotation | Optional | Photo rotation <br/>System Capabilities: SystemCapability.Multimedia.Camera.Core | | rotation | ImageRotation | Optional | Photo rotation |
## PhotoOutput ## PhotoOutput
...@@ -2714,10 +2287,6 @@ Captures a photo. This method uses an asynchronous callback to return the result ...@@ -2714,10 +2287,6 @@ Captures a photo. This method uses an asynchronous callback to return the result
|----------|---------------------|-----------|----------------------------------------------| |----------|---------------------|-----------|----------------------------------------------|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -2747,10 +2316,6 @@ Captures a photo with the specified capture settings. This method uses an asynch ...@@ -2747,10 +2316,6 @@ Captures a photo with the specified capture settings. This method uses an asynch
| setting | PhotoCaptureSetting | Yes | Photo capture settings | | setting | PhotoCaptureSetting | Yes | Photo capture settings |
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -2810,10 +2375,6 @@ Releases this **PhotoOutput** instance. This method uses an asynchronous callbac ...@@ -2810,10 +2375,6 @@ Releases this **PhotoOutput** instance. This method uses an asynchronous callbac
|----------|----------------------|-----------|----------------------------------------------| |----------|----------------------|-----------|----------------------------------------------|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -2836,9 +2397,6 @@ SystemCapability.Multimedia.Camera.Core ...@@ -2836,9 +2397,6 @@ SystemCapability.Multimedia.Camera.Core
Releases this **PhotoOutput** instance. This method uses a promise to return the result. Releases this **PhotoOutput** instance. This method uses a promise to return the result.
**Parameters**
none
**Return values** **Return values**
| Type | Description | | Type | Description |
...@@ -2871,10 +2429,6 @@ Listens for photo capture start events. This method uses a callback to get the e ...@@ -2871,10 +2429,6 @@ Listens for photo capture start events. This method uses a callback to get the e
| type | string | Yes | Name of the event to listen for. | | type | string | Yes | Name of the event to listen for. |
| callback | Callback<number\> | Yes | Callback used to get the capture ID. | | callback | Callback<number\> | Yes | Callback used to get the capture ID. |
**Return value**
None
**Example** **Example**
``` ```
...@@ -2900,10 +2454,6 @@ Listens for frame shutter events. This method uses a callback to get the event i ...@@ -2900,10 +2454,6 @@ Listens for frame shutter events. This method uses a callback to get the event i
| type | string | Yes | Name of the event to listen for. | | type | string | Yes | Name of the event to listen for. |
| callback | Callback<FrameShutterInfo\> | Yes | Callback used to get the frame shutter information.| | callback | Callback<FrameShutterInfo\> | Yes | Callback used to get the frame shutter information.|
**Return value**
None
**Example** **Example**
``` ```
...@@ -2930,10 +2480,6 @@ Listens for photo capture end events. This method uses a callback to get the eve ...@@ -2930,10 +2480,6 @@ Listens for photo capture end events. This method uses a callback to get the eve
| type | string | Yes | Name of the event to listen for. | | type | string | Yes | Name of the event to listen for. |
| callback | Callback<CaptureEndInfo\> | Yes | Callback used to get the capture end information | | callback | Callback<CaptureEndInfo\> | Yes | Callback used to get the capture end information |
**Return value**
None
**Example** **Example**
``` ```
...@@ -2960,10 +2506,6 @@ Listens for **PhotoOutput** errors. This method uses a callback to get errors. ...@@ -2960,10 +2506,6 @@ Listens for **PhotoOutput** errors. This method uses a callback to get errors.
| type | string | Yes | Name of the event to listen for. | | type | string | Yes | Name of the event to listen for. |
| callback | Callback<PhotoOutputError\> | Yes | Callback used to get the photo output errors. | | callback | Callback<PhotoOutputError\> | Yes | Callback used to get the photo output errors. |
**Return value**
None
**Example** **Example**
``` ```
...@@ -2989,14 +2531,10 @@ Creates a **VideoOutput** instance. This method uses an asynchronous callback to ...@@ -2989,14 +2531,10 @@ Creates a **VideoOutput** instance. This method uses an asynchronous callback to
| surfaceId | string | Yes | Surface ID received from VideoRecorder | | surfaceId | string | Yes | Surface ID received from VideoRecorder |
| callback | AsyncCallback<VideoOutput\> | Yes | Callback used to return the VideoOutput instance | | callback | AsyncCallback<VideoOutput\> | Yes | Callback used to return the VideoOutput instance |
**Return values**
none
**Example** **Example**
``` ```
camera.createVideoOutput(surfaceId), (err, videoOutput) => { camera.createVideoOutput((surfaceId), (err, videoOutput) => {
if (err) { if (err) {
console.error('Failed to create the VideoOutput instance. ${err.message}'); console.error('Failed to create the VideoOutput instance. ${err.message}');
return; return;
...@@ -3054,10 +2592,6 @@ Starts the video output. This method uses an asynchronous callback to return the ...@@ -3054,10 +2592,6 @@ Starts the video output. This method uses an asynchronous callback to return the
|----------|----------------------|-----------|----------------------------------------------| |----------|----------------------|-----------|----------------------------------------------|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -3080,9 +2614,6 @@ SystemCapability.Multimedia.Camera.Core ...@@ -3080,9 +2614,6 @@ SystemCapability.Multimedia.Camera.Core
Starts the video output. This method uses a promise to return the result. Starts the video output. This method uses a promise to return the result.
**Parameters**
none
**Return values** **Return values**
| Type | Description | | Type | Description |
...@@ -3114,10 +2645,6 @@ Stops the video output. This method uses an asynchronous callback to return the ...@@ -3114,10 +2645,6 @@ Stops the video output. This method uses an asynchronous callback to return the
|----------|----------------------|-----------|----------------------------------------------| |----------|----------------------|-----------|----------------------------------------------|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -3140,9 +2667,6 @@ SystemCapability.Multimedia.Camera.Core ...@@ -3140,9 +2667,6 @@ SystemCapability.Multimedia.Camera.Core
Stops the video output. This method uses a promise to return the result. Stops the video output. This method uses a promise to return the result.
**Parameters**
none
**Return values** **Return values**
| Type | Description | | Type | Description |
...@@ -3173,10 +2697,6 @@ Releases this VideoOutput instance. This method uses an asynchronous callback to ...@@ -3173,10 +2697,6 @@ Releases this VideoOutput instance. This method uses an asynchronous callback to
|----------|----------------------|-----------|----------------------------------------------| |----------|----------------------|-----------|----------------------------------------------|
| callback | AsyncCallback<void\> | Yes | Callback used to return the result | | callback | AsyncCallback<void\> | Yes | Callback used to return the result |
**Return values**
none
**Example** **Example**
``` ```
...@@ -3199,10 +2719,6 @@ SystemCapability.Multimedia.Camera.Core ...@@ -3199,10 +2719,6 @@ SystemCapability.Multimedia.Camera.Core
Releases this VideoOutput instance. This method uses a promise to return the result. Releases this VideoOutput instance. This method uses a promise to return the result.
**Parameters**
none
**Return values** **Return values**
| Type | Description | | Type | Description |
...@@ -3235,10 +2751,6 @@ Listens for video frame start events. This method uses a callback to get the eve ...@@ -3235,10 +2751,6 @@ Listens for video frame start events. This method uses a callback to get the eve
| type | string | Yes | Name of the event to listen for. | | type | string | Yes | Name of the event to listen for. |
| callback | Callback<void\> | Yes | Callback used to return the result | | callback | Callback<void\> | Yes | Callback used to return the result |
**Return value**
None
**Example** **Example**
``` ```
...@@ -3258,10 +2770,6 @@ Listens for video frame end events. This method uses a callback to get the event ...@@ -3258,10 +2770,6 @@ Listens for video frame end events. This method uses a callback to get the event
| type | string | Yes | Name of the event to listen for. | | type | string | Yes | Name of the event to listen for. |
| callback | Callback<void\> | Yes | Callback used to return the result | | callback | Callback<void\> | Yes | Callback used to return the result |
**Return value**
None
**Example** **Example**
``` ```
...@@ -3281,10 +2789,6 @@ Listens for **VideoOutput** errors. This method uses a callback to get errors. ...@@ -3281,10 +2789,6 @@ Listens for **VideoOutput** errors. This method uses a callback to get errors.
| type | string | Yes | Name of the event to listen for. | | type | string | Yes | Name of the event to listen for. |
| callback | Callback<VideoOutputError\> | Yes | Callback used to get the video output errors. | | callback | Callback<VideoOutputError\> | Yes | Callback used to get the video output errors. |
**Return value**
None
**Example** **Example**
``` ```
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或