diff --git a/zh-cn/application-dev/reference/apis/Readme-CN.md b/zh-cn/application-dev/reference/apis/Readme-CN.md
index 837523f1a20f18fed4ab7fb79c4aa21929dda1e5..184a5d5467b37f4387fbacd33fe96c9a03763c80 100644
--- a/zh-cn/application-dev/reference/apis/Readme-CN.md
+++ b/zh-cn/application-dev/reference/apis/Readme-CN.md
@@ -19,13 +19,13 @@
- [音频管理](js-apis-audio.md)
- [媒体服务](js-apis-media.md)
- [图片处理](js-apis-image.md)
+ - [相机管理](js-apis-camera.md)
- 安全
- [用户认证](js-apis-useriam-userauth.md)
- [访问控制](js-apis-abilityAccessCtrl.md)
- [通用密钥库系统](js-apis-huks.md)
- 数据管理
- [轻量级存储](js-apis-data-preferences.md)
- - [轻量级存储(废弃 since 8)](js-apis-data-storage.md)
- [分布式数据管理](js-apis-distributed-data.md)
- [关系型数据库](js-apis-data-rdb.md)
- [结果集](js-apis-data-resultset.md)
@@ -49,7 +49,9 @@
- [网络搜索](js-apis-radio.md)
- [observer](js-apis-observer.md)
- [蜂窝数据](js-apis-telephony-data.md)
-- 网络与连接
+- 网络管理
+ - [网络连接管理](js-apis-net-connection.md)
+- 通信与连接
- [WLAN](js-apis-wifi.md)
- [Bluetooth](js-apis-bluetooth.md)
- 设备管理
diff --git a/zh-cn/application-dev/reference/apis/js-apis-camera.md b/zh-cn/application-dev/reference/apis/js-apis-camera.md
index cb34f90715f3f769607381a01ca39862ba0409ed..5393f3f49ca9a1116f9f0f586bdf9f709bcc54c7 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-camera.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-camera.md
@@ -1,4 +1,4 @@
-# 相机管理
+# 相机管理
## 导入模块
@@ -8,30 +8,22 @@ import camera from '@ohos.multimedia.camera';
## 权限
-```
ohos.permission.CAMERA
-```
-## getCameraManager(context: Context, callback: AsyncCallback): void;
-**系统能力:**
+## camera.getCameraManager
-SystemCapability.Multimedia.Camera.Core
+getCameraManager(context: Context, callback: AsyncCallback): void
-**说明:**
+获取相机管理器实例,通过注册回调函数获取结果。
-获取**相机管理器**,使用callback方式获取一个异步的实例。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|----------|-------------------------------|-----------|-----------------------------------------------------|
-| context | Context | Yes | 应用环境 |
-| callback | AsyncCallback | Yes | 使用callback方式获取**相机管理器**实例
|
-
-
-**返回值:**
-
-none
+| context | Context | 是 | 应用上下文。 |
+| callback | AsyncCallback<[CameraManager](#cameramanager)\> | 是 | 回调函数,用于获取相机管理器实例。 |
**示例:**
@@ -45,27 +37,25 @@ camera.getCameraManager(context, (err, cameraManager) => {
});
```
-## getCameraManager(context: Context): Promise;
+## camera.getCameraManager
-**系统能力:**
+getCameraManager(context: Context): Promise
-SystemCapability.Multimedia.Camera.Core
+获取相机管理器实例,通过Promise获取结果。
-**说明:**
-
-获取**相机管理器**,使用promise的方式获取一个实例。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|----------|----------------------|-----------|----------------------------|
-| context | Context | Yes | 应用环境 |
+| context | Context | 是 | 应用上下文。 |
**返回值:**
| 类型 | 说明 |
|-------------------------|--------------------------------------------------------|
-| Promise | 使用Promise的方式获取一个**相机管理器** 实例 |
+| Promise<[CameraManager](#cameramanager)\> | 使用Promise的方式获取一个相机管理器实例。 |
**示例:**
@@ -75,87 +65,81 @@ camera.getCameraManager(context).then((cameraManger) => {
})
```
-## CameraStatus
+## CameraStatus
-枚举相机状态类型。
+枚举,相机状态。
| 名称 | 默认值 | 说明 |
|---------------------------|---------------|--------------------|
-| CAMERA_STATUS_APPEAR | 0 | Camera appear
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| CAMERA_STATUS_DISAPPEAR | 1 | Camera disappear
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| CAMERA_STATUS_AVAILABLE | 2 | 相机就绪
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| CAMERA_STATUS_UNAVAILABLE | 3 | 相机未就绪
系统能力 : SystemCapability.Multimedia.Camera.Core |
+| CAMERA_STATUS_APPEAR | 0 | 相机存在。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| CAMERA_STATUS_DISAPPEAR | 1 | 相机不存在。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| CAMERA_STATUS_AVAILABLE | 2 | 相机就绪。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| CAMERA_STATUS_UNAVAILABLE | 3 | 相机未就绪。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
-## CameraPosition
+## CameraPosition
-枚举相机位置。
+枚举,相机方向。
| 名称 | 默认值 | 说明 |
|-----------------------------|---------------|-----------------------|
-| CAMERA_POSITION_UNSPECIFIED | 0 | 未指定方向相机
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| CAMERA_POSITION_BACK | 1 | 后置相机
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| CAMERA_POSITION_FRONT | 2 | 前置相机
系统能力 : SystemCapability.Multimedia.Camera.Core |
+| CAMERA_POSITION_UNSPECIFIED | 0 | 未指定方向相机。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| CAMERA_POSITION_BACK | 1 | 后置相机。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| CAMERA_POSITION_FRONT | 2 | 前置相机。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
-## CameraType
+## CameraType
-枚举相机类型。
+枚举,相机类型。
| 名称 | 默认值 | 说明 |
|-------------------------|---------------|-------------------------|
-| CAMERA_TYPE_UNSPECIFIED | 0 | 未指定相机类型
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| CAMERA_TYPE_WIDE_ANGLE | 1 | 广角相机
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| CAMERA_TYPE_ULTRA_WIDE | 2 | 超级广角相机
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| CAMERA_TYPE_TELEPHOTO | 3 | 电话相机
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| CAMERA_TYPE_TRUE_DEPTH | 4 | 深度相机
系统能力 : SystemCapability.Multimedia.Camera.Core |
+| CAMERA_TYPE_UNSPECIFIED | 0 | 未指定相机类型。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| CAMERA_TYPE_WIDE_ANGLE | 1 | 广角相机。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| CAMERA_TYPE_ULTRA_WIDE | 2 | 超级广角相机。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| CAMERA_TYPE_TELEPHOTO | 3 | 长焦相机。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| CAMERA_TYPE_TRUE_DEPTH | 4 | 深度相机。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
-## ConnectionType
+## ConnectionType
-枚举相机连接类型。
+枚举,相机连接类型。
| 名称 | 默认值 | 说明 |
|------------------------------|---------------|----------------------------|
-| CAMERA_CONNECTION_BUILT_IN | 0 | 内置相机
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| CAMERA_CONNECTION_USB_PLUGIN | 1 | USB外连相机
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| CAMERA_CONNECTION_REMOTE | 2 | 分布式相机
系统能力 : SystemCapability.Multimedia.Camera.Core |
+| CAMERA_CONNECTION_BUILT_IN | 0 | 内置相机。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| CAMERA_CONNECTION_USB_PLUGIN | 1 | 外置USB相机。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| CAMERA_CONNECTION_REMOTE | 2 | 分布式相机。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
-## CameraFormat
+## CameraFormat
-枚举相机格式。
+枚举,照片格式。
| 名称 | 默认值 | 说明 |
|----------------------------|---------------|---------------------|
-| CAMERA_FORMAT_YCRCb_420_SP | 1003 | YCRCb格式
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| CAMERA_FORMAT_JPEG | 2000 | JPEG格式
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| CAMERA_FORMAT_AVC | 3000 | AVC 格式
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| CAMERA_FORMAT_HEVC | 3001 | HEVC 格式
系统能力 : SystemCapability.Multimedia.Camera.Core |
-
+| CAMERA_FORMAT_YCRCb_420_SP | 1003 | YCRCb格式。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| CAMERA_FORMAT_JPEG | 2000 | JPEG格式。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| CAMERA_FORMAT_AVC | 3000 | AVC格式。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| CAMERA_FORMAT_HEVC | 3001 | HEVC格式。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
-## CameraManager
-相机管理器类, 包含获取相机并创建“相机输入”实例。
+## CameraManager
-### getCameras(callback: AsyncCallback\>): void;
+相机管理器类,使用前需要通过getCameraManager获取相机管理实例。
-**系统能力:**
+### getCameras
-SystemCapability.Multimedia.Camera.Core
+getCameras(callback: AsyncCallback\>): void
-**说明:**
+异步获取设备支持的相机列表,通过注册回调函数获取结果。
-获取设备支持的所有相机,使用callback方式获取异步的支持相机列表。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|----------|--------------------------------|-----------|---------------------------------------------------------|
-| callback | AsyncCallback\> | Yes | 使用callback方式获取支持的相机列表 |
-
-**返回值:**
-
-none
+| callback | AsyncCallback\> | 是 | 使用callback方式获取支持的相机列表。 |
**示例:**
@@ -169,25 +153,19 @@ cameraManager.getCameras((err, cameras) => {
})
```
-### getCameras(): Promise\>;
-
-**系统能力:**
+### getCameras
-SystemCapability.Multimedia.Camera.Core
+getCameras(): Promise\>
-**说明:**
+异步获取设备支持的相机列表,通过Promise获取结果。
-获取设备支持的所有相机,使用promise方式获取支持相机列表。
-
-**参数:**
-
-none
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**返回值:**
| 类型 | 说明 |
|------------------------|--------------------------------------------------------|
-| Promise\> | 使用promise方获取支持相机列表 |
+| Promise\> | 使用promise获取支持相机列表。 |
**示例:**
@@ -198,26 +176,20 @@ cameraManager.getCameras().then((cameraArray) => {
})
```
-### createCameraInput(cameraId: string, callback: AsyncCallback): void;
+### createCameraInput
-**系统能力:**
+createCameraInput(cameraId: string, callback: AsyncCallback): void
-SystemCapability.Multimedia.Camera.Core
+使用相机ID异步创建CameraInput实例,通过注册回调函数获取结果。
-**说明:**
-
-使用相机ID创建 **相机输入** 实例,使用callback方式获取一个异步的实例。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 默认值 | 必填 | 说明 |
|----------|------------------------------|-----------|--------------------------------------------------|
-| cameraId | string | Yes | 使用 相机ID 来创建一个实例 |
-| callback | AsyncCallback | Yes | 使用Callback方式来获取一个 CameraInput 实例 |
-
-**返回值:**
-
-none
+| cameraId | string | 是 | 指定相机ID。 |
+| callback | AsyncCallback<[CameraInput](#camerainput)\> | 是 | 回调函数,用于获取CameraInput实例。 |
**示例:**
@@ -231,27 +203,25 @@ cameraManager.createCameraInput(cameraId, (err, cameraInput) => {
})
```
-### createCameraInput(cameraId: string): Promise;
-
-**系统能力:**
+### createCameraInput
-SystemCapability.Multimedia.Camera.Core
+createCameraInput(cameraId: string): Promise
-**说明:**
+使用相机ID异步创建CameraInput实例,通过Promise获取结果。
-使用相机ID创建 **相机输入** 实例,使用promise方式获取一个实例。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 默认值 | 必填 | 说明 |
|----------|-----------------------------|-----------|------------------------------------------|
-| cameraId | string | Yes | 使用 相机ID 来创建一个实例 |
+| cameraId | string | 是 | 指定相机ID。 |
**返回值:**
| 类型 | 说明 |
|-------------------------|-------------------------------------------------|
-| Promise | 使用Promise的方式获取一个 CameraInput 的实例 |
+| Promise<[CameraInput](#camerainput)\> | 使用Promise的方式获取CameraInput的实例。 |
**示例:**
@@ -261,29 +231,23 @@ cameraManager.createCameraInput(cameraId).then((cameraInput) => {
})
```
-### createCameraInput(position: CameraPosition, type: CameraType, callback: AsyncCallback): void;
-
-**系统能力:**
+### createCameraInput
-SystemCapability.Multimedia.Camera.Core
+createCameraInput(position: CameraPosition, type: CameraType, callback: AsyncCallback): void
-**说明:**
+使用相机位置和相机类型异步创建CameraInput实例,通过注册回调函数获取结果。
-使用相机位置和相机类型创建 **相机输入** 实例, 使用callback方式获取一个异步的实例。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|----------------|----------------------------|-----------|---------------------------------------------------|
-| cameraPosition | CameraPosition | Yes | 相机位置 |
-| cameraType | CameraType | Yes | 相机类型 |
-| callback | AsyncCallback | Yes | 使用callback方式获取一个异步的实例 |
-
-**返回值:**
+| cameraPosition | [CameraPosition](#cameraposition) | 是 | 相机位置。 |
+| cameraType | [CameraType](#cameratype) | 是 | 相机类型。 |
+| callback | AsyncCallback<[CameraInput](#camerainput)\> | 是 | 回调函数,用于获取CameraInput实例。 |
-none
-
-**实例:**
+**示例:**
```
cameraManager.createCameraInput(cameraPosition, cameraType, (err, cameraInput) => {
@@ -295,28 +259,26 @@ cameraManager.createCameraInput(cameraPosition, cameraType, (err, cameraInput) =
})
```
-### createCameraInput(position: CameraPosition, type: CameraType): Promise;
-
-**系统能力:**
+### createCameraInput
-SystemCapability.Multimedia.Camera.Core
+createCameraInput(position: CameraPosition, type: CameraType): Promise
-**说明:**
+使用相机位置和相机类型异步创建CameraInput实例,通过Promise获取结果。
-使用相机位置和相机类型创建 **相机输入** 实例, 使用promise的方式获取一个实例。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|----------------|----------------------------|-----------|----------------------------------------|
-| cameraPosition | CameraPosition | Yes | 相机位置 |
-| cameraType | CameraType | Yes | 相机类型 |
+| cameraPosition | [CameraPosition](#cameraposition) | 是 | 相机位置。 |
+| cameraType | [CameraType](#cameratype) | 是 | 相机类型。 |
**返回值:**
| 类型 | 说明 |
|-------------------------|-------------------------------------------------|
-| Promise | 使用promise的方式获取一个**相机输入**实例 |
+| Promise<[CameraInput](#camerainput)\> | 使用Promise的方式获取CameraInput的实例。 |
**示例:**
@@ -326,26 +288,20 @@ cameraManager.createCameraInput(cameraPosition, cameraType).then((cameraInput) =
})
```
-### on(type: 'cameraStatus', callback: Callback): void;
+### on('cameraStatus')
-**系统能力:**
+on(type: 'cameraStatus', callback: AsyncCallback): void
-SystemCapability.Multimedia.Camera.Core
+监听相机的状态变化,通过注册回调函数获取相机的状态变化。
-**说明:**
-
-监听相机的状态变化,使用callback的方式获取相机的状态变化
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
| :------- | :--------------------- | :-------- | :--------------------------------------------------- |
-| type | string | Yes | 监听项的名称 |
-| callback | Callback | Yes | 使用callback的方式获取相机状态变化 |
-
-**返回值:**
-
-None
+| type | string | 是 | 监听事件。 |
+| callback | AsyncCallback<[CameraStatusInfo](#camerastatusinfo)\> | 是 | 回调函数,用于获取相机状态变化信息。 |
**示例:**
@@ -356,18 +312,18 @@ cameraManager.on('cameraStatus', (cameraStatusInfo) => {
})
```
-## Camera
-
-**相机**类。
+## Camera
-**字段:**
+相机实例。
-| 名称 | 类型 | 访问权限 | 说明 |
+| 名称 | 类型 | 只读 | 说明 |
|----------------|----------------|----------|------------------------|
-| cameraId | string | readonly | 相机ID
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| cameraPosition | cameraPosition | readonly | 相机位置
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| cameraType | cameraType | readonly | 相机类型
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| connectionType | connectionType | readonly | 相机连接类型
系统能力 : SystemCapability.Multimedia.Camera.Core |
+| cameraId | string | 是 | 相机ID。
**系统能力:** SystemCapability.Multimedia.Camera.Core|
+| cameraPosition | [CameraPosition](#cameraposition) | 是 | 相机位置。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| cameraType | [CameraType](#cameratype) | 是 | 相机类型。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| connectionType | [ConnectionType](#connectiontype) | 是 | 相机连接类型。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+
+**示例:**
```
var cameraManager = await camera.getCameraManager();
@@ -380,41 +336,35 @@ var cameraId = cameraObj.connectionType;
```
-## CameraStatusInfo
-
-**相机状态信息**类。
+## CameraStatusInfo
-**字段:**
+相机状态信息。
| 名称 | 类型 | 说明 |
|----------------|----------------|------------------|
-| camera | Camera | 相机类
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| status | CameraStatus | 相机状态
系统能力 : SystemCapability.Multimedia.Camera.Core |
-
+| camera | [Camera](#camera) | 相机信息。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| status | [CameraStatus](#camerastatus) | 相机状态。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
-## CameraInput
-**相机输入** 类。
+## CameraInput
-### getCameraId(callback: AsyncCallback\): void;
+相机输入类。在使用该类的方法前,需要先构建一个CameraInput实例。
-**系统能力:**
+### getCameraId
-SystemCapability.Multimedia.Camera.Core
+getCameraId(callback: AsyncCallback\): void
-**说明:**
+异步获取该CameraInput实例的相机ID,通过注册回调函数获取结果。
-获取该**相机输入** 实例的相机ID, 使用callback的方式获取一个异步的实例。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|----------|------------------------|-----------|---------------------------------------|
-| callback | AsyncCallback | Yes | 使用callback的方式获取 相机ID |
+| callback | AsyncCallback | 是 | 回调函数,用于获取相机ID。 |
-**返回值:**
-
-none
+**示例:**
```
cameraInput.getCameraId((err, cameraId) => {
@@ -426,25 +376,19 @@ cameraInput.getCameraId((err, cameraId) => {
})
```
-### getCameraId(): Promise;
+### getCameraId
-**系统能力:**
+getCameraId(): Promise
-SystemCapability.Multimedia.Camera.Core
+异步获取该CameraInput实例的相机ID,通过Promise获取结果。
-**说明:**
-
-获取该**相机输入** 实例的相机ID, 使用promise的方式获取相机ID。
-
-**参数:**
-
-none
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**返回值:**
| 类型 | 说明 |
|------------------------|--------------------------------------|
-| Promise | 使用promise的方式获取相机ID |
+| Promise | 使用Promise的方式获取相机ID。 |
**示例:**
@@ -454,27 +398,20 @@ cameraInput.getCameraId().then((cameraId) => {
})
```
-### getSupportedSizes\(format: CameraFormat, callback: AsyncCallback\>\): void;
-
-**系统能力:**
+### getSupportedSizes
-SystemCapability.Multimedia.Camera.Core
+getSupportedSizes\(format: CameraFormat, callback: AsyncCallback\>\): void
-**说明:**
+根据指定格式,获取相机支持的分辨率,通过注册回调函数获取结果。
-根据格式查询相机支持的分辨率,使用callback的方式获取一个异步的支持分辨率。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|----------|------------------------------|-----------|---------------------------------------------|
-| format | CameraFormat | Yes | 使用CameraFormat来获取支持分辨率 |
-| callback | AsyncCallback\> | Yes | 使用callback的方式来获取支持分辨率 |
-
-
-**返回值:**
-
-none
+| format | [CameraFormat](#cameraformat) | 是 | 指定照片格式。 |
+| callback | AsyncCallback\> | 是 | 回调函数,用于获取相机支持分辨率。 |
**示例:**
@@ -488,27 +425,25 @@ cameraInput.getSupportedSizes(format, (err, sizes) => {
})
```
-### getSupportedSizes\(format: CameraFormat\): Promise\>;
-
-**系统能力:**
+### getSupportedSizes
-SystemCapability.Multimedia.Camera.Core
+getSupportedSizes\(format: CameraFormat\): Promise\>
-**说明:**
+根据指定格式,获取相机支持的分辨率,通过Promise获取结果。
-获取CameraFormat的支持分辨率,使用promise的方式获取支持分辨率。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
-| 名称 | 类型 | 必填 | 说明 |
-|----------|----------------------------|-----------|-----------------------------------------------|
-| format | CameraFormat | Yes | 使用Camera format 获取支持分辨率 |
+| 名称 | 类型 | 必填 | 说明 |
+| ------ | ----------------------------- | ---- | -------------- |
+| format | [CameraFormat](#cameraformat) | 是 | 指定照片格式。 |
**返回值:**
| 类型 | 说明 |
|------------------------|---------------------------------------------|
-| Promise\> | 使用promise的方式获取支持分辨率. |
+| Promise\> | 使用Promise的方式获取相机支持的分辨率。 |
**示例:**
@@ -518,26 +453,19 @@ cameraInput.getSupportedSizes(format).then((sizes) => {
})
```
-### getSupportedPreviewFormats\(callback: AsyncCallback\>\): void;
-
-**系统能力:**
+### getSupportedPreviewFormats
-SystemCapability.Multimedia.Camera.Core
+getSupportedPreviewFormats\(callback: AsyncCallback\>\): void
-**说明:**
+获取相机预览图片的支持格式,通过注册回调函数获取结果。
-获取预览的支持格式,使用callback的方式获取一个异步的支持格式.
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
-| 名称 | 类型 | 必填 | 说明 |
-|----------|--------------------------------------|-----------|---------------------------------------------------|
-| callback | AsyncCallback\> | Yes | 使用callback的方式获取支持的预览格式. |
-
-
-**返回值:**
-
-none
+| 名称 | 类型 | 必填 | 说明 |
+| -------- | ----------------------------------------------------- | ---- | -------------------------------------- |
+| callback | AsyncCallback\> | 是 | 回调函数,用于获取预览图片的支持格式。 |
**示例:**
@@ -551,26 +479,19 @@ cameraInput.getSupportedPreviewFormats((err, previewFormats) => {
})
```
+### getSupportedPreviewFormats
-### getSupportedPreviewFormats\(\): Promise\>;
-
-**系统能力:**
-
-SystemCapability.Multimedia.Camera.Core
+getSupportedPreviewFormats\(\): Promise\>
-**说明:**
-
-获取预览的 supported formats,使用promise的方式获取supported formats.
-
-**参数:**
+获取相机预览图片的支持格式,通过注册回调函数获取结果。
-none
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**返回值:**
| 类型 | 说明 |
|--------------------------------|-------------------------------------------------------|
-| Promise\> | 使用promise的方式获取supported preview formats |
+| Promise\> | 使用Promise的方式获取预览图片的支持格式。 |
**示例:**
@@ -580,25 +501,19 @@ cameraInput.getSupportedPreviewFormats().then((previewFormats) => {
})
```
-### getSupportedPhotoFormats\(callback: AsyncCallback\>\): void;
+### getSupportedPhotoFormats
-**系统能力:**
+getSupportedPhotoFormats\(callback: AsyncCallback\>\): void
-SystemCapability.Multimedia.Camera.Core
+获取照片的支持格式,通过注册回调函数获取结果。
-**说明:**
-
-获取 photographing的supported formats,使用callback的方式获取一个异步的supported formats.
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|----------|--------------------------------------|-----------|-------------------------------------------------|
-| callback | AsyncCallback\> | Yes | 使用callback的方式获取支持的照片格式 |
-
-**返回值:**
-
-none
+| callback | AsyncCallback\> | 是 | 回调函数,用于获取支持的照片格式。 |
**示例:**
@@ -612,25 +527,19 @@ cameraInput.getSupportedPhotoFormats((err, photoFormats) => {
})
```
-### getSupportedPhotoFormats\(\): Promise\>;
-
-**系统能力:**
+### getSupportedPhotoFormats
-SystemCapability.Multimedia.Camera.Core
+getSupportedPhotoFormats\(\): Promise\>
-**说明:**
+获取照片的支持格式,通过Promise获取结果。
-获取 photographing的supported formats,使用promise的方式获取supported formats.
-
-**参数:**
-
-none
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**返回值:**
| 类型 | 说明 |
|--------------------------------|---------------------------------------------------|
-| Promise\> | 使用promise的方式获取支持的照片格式 |
+| Promise\> | 使用Promise的方式获取支持的照片格式。 |
**示例:**
@@ -640,25 +549,19 @@ cameraInput.getSupportedPhotoFormats().then((photoFormats) => {
})
```
-### getSupportedVideoFormats\(callback: AsyncCallback\>\): void;
-
-**系统能力:**
+### getSupportedVideoFormats
-SystemCapability.Multimedia.Camera.Core
+getSupportedVideoFormats\(callback: AsyncCallback\>\): void
-**说明:**
+获取录制视频的支持格式,通过注册回调函数获取结果。
-获取录制视频的supported formats,使用callback的方式获取一个异步的支持的录像格式。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|----------|--------------------------------------|-----------|-------------------------------------------------|
-| callback | AsyncCallback\> | Yes | 使用callback的方式获取支持的录像格式 |
-
-**返回值:**
-
-none
+| callback | AsyncCallback\> | 是 | 回调函数,用于获取支持的视频格式。 |
**示例:**
@@ -672,25 +575,19 @@ cameraInput.getSupportedVideoFormats((err, videoFormats) => {
})
```
-### getSupportedVideoFormats\(\): Promise\>;
-
-**系统能力:**
-
-SystemCapability.Multimedia.Camera.Core
+### getSupportedVideoFormats
-**说明:**
+getSupportedVideoFormats\(\): Promise\>
-获取录制视频的supported formats,使用promise的方式获取支持的录像格式。
+获取录制视频的支持格式,通过Promise获取结果。
-**参数:**
-
-none
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**返回值:**
| 类型 | 说明 |
|--------------------------------|---------------------------------------------------|
-| Promise\> | 使用promise的方式获取支持的录像格式 |
+| Promise\> | 使用Promise的方式获取支持的视频格式。 |
**示例:**
@@ -700,25 +597,19 @@ cameraInput.getSupportedVideoFormats().then((videoFormats) => {
})
```
-### hasFlash(callback: AsyncCallback): void;
-
-**系统能力:**
+### hasFlash
-SystemCapability.Multimedia.Camera.Core
+hasFlash(callback: AsyncCallback): void
-**说明:**
+判断设备是否支持闪光灯,通过注册回调函数获取结果。
-检查设备是否支持闪光灯,使用callback的方式获取一个异步的结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|----------|-------------------------|-----------|----------------------------------------------------|
-| callback | AsyncCallback | Yes | 使用callback的方式获取支持闪光灯的状态 |
-
-**返回值:**
-
-none
+| callback | AsyncCallback | 是 | 回调函数,返回true表示设备支持闪光灯。 |
**示例:**
@@ -732,25 +623,19 @@ cameraInput.hasFlash((err, status) => {
})
```
-### hasFlash(): Promise;
-
-**系统能力:**
-
-SystemCapability.Multimedia.Camera.Core
+### hasFlash
-**说明:**
+hasFlash(): Promise
-检查设备是否支持闪光灯,使用promise的方式获取结果。
+判断设备是否支持闪光灯,通过Promise获取结果。
-**参数:**
-
-none
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**返回值:**
| 类型 | 说明 |
|-----------------------|--------------------------------------------------------|
-| Promise | 使用promise的方式获取支持闪光灯的状态。 |
+| Promise | 使用Promise的方式获取结果,返回true表示设备支持闪光灯。 |
**示例:**
@@ -760,26 +645,20 @@ cameraInput.hasFlash().then((status) => {
})
```
-### isFlashModeSupported(flashMode: FlashMode, callback: AsyncCallback): void;
-
-**系统能力:**
+### isFlashModeSupported
-SystemCapability.Multimedia.Camera.Core
+isFlashModeSupported(flashMode: FlashMode, callback: AsyncCallback): void
-**说明:**
+判断设备是否支持指定闪光灯模式,通过注册回调函数获取结果。
-检查设备是否支持闪光灯模式,使用callback的方式获取一个异步的结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|-----------|------------------------|-----------|----------------------------------------------------|
-| flashMode | FlashMode | Yes | 闪光灯模式 |
-| callback | AsyncCallback | Yes | 使用callback的方式获取设备支持闪光灯模式 |
-
-**返回值:**
-
-none
+| flashMode | [FlashMode](#flashmode) | 是 | 指定闪光灯模式。 |
+| callback | AsyncCallback | 是 | 回调函数,返回true表示支持该闪光灯模式。 |
**示例:**
@@ -793,27 +672,25 @@ cameraInput.isFlashModeSupported(flashMode, (err, status) => {
})
```
-### isFlashModeSupported(flashMode: FlashMode): Promise;
+### isFlashModeSupported
-**系统能力:**
+isFlashModeSupported(flashMode: FlashMode): Promise
-SystemCapability.Multimedia.Camera.Core
+判断设备是否支持指定闪光灯模式,通过Promise获取结果。
-**说明:**
-
-检查设备是否支持闪光灯模式,使用promise的方式获取结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|-----------|------------------------|-----------|----------------------------------------------------|
-| flashMode | FlashMode | Yes | 闪光灯模式 |
+| flashMode | [FlashMode](#flashmode) | 是 | 指定闪光灯模式。 |
**返回值:**
| 类型 | 说明 |
|-----------------------|---------------------------------------------------|
-| Promise | 使用promise的方式获取支持的闪光灯模式 |
+| Promise | 使用Promise的方式获取结果,返回true表示设备支持该闪光灯模式。 |
**示例:**
@@ -823,28 +700,25 @@ cameraInput.isFlashModeSupported(flashMode).then((status) => {
})
```
-### setFlashMode(flashMode: FlashMode, callback: AsyncCallback): void;
+### setFlashMode
-**系统能力:**
+setFlashMode(flashMode: FlashMode, callback: AsyncCallback): void
-SystemCapability.Multimedia.Camera.Core
+设置闪光灯模式,通过注册回调函数获取结果。
-**说明:**
+进行设置之前,需要先检查:
-设置闪光灯模式,使用callback的方式获取一个异步的结果。
+1. 设备是否支持闪光灯,可使用方法[hasFlash](#hasflash)。
+2. 设备是否支持指定的闪光灯模式,可使用方法[isFlashModeSupported](#isflashmodesupported)。
-说明: 设置闪光灯模式之前, 检查支持的闪光灯 (hasFlash method) 以及支持的闪光灯模式 (isFlashModeSupported method);
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|-----------|------------------------|-----------|----------------------------------------------------|
-| flashMode | FlashMode | Yes | 闪光灯模式 |
-| callback | AsyncCallback | Yes | 使用callback的方式获取结果 |
-
-**返回值:**
-
-none
+| flashMode | [FlashMode](#flashmode) | 是 | 指定闪光灯模式。 |
+| callback | AsyncCallback | 是 | 回调函数,用于获取结果。 |
**示例:**
@@ -858,29 +732,30 @@ cameraInput.setFlashMode(flashMode, (err) => {
})
```
-### setFlashMode(flashMode: FlashMode): Promise;
+### setFlashMode
-**系统能力:**
+setFlashMode(flashMode: FlashMode): Promise
-SystemCapability.Multimedia.Camera.Core
+设置闪光灯模式,通过Promise获取结果。
-**说明:**
+进行设置之前,需要先检查:
-设置闪光灯模式,使用promise的方式获取结果。
+1. 设备是否支持闪光灯,可使用方法[hasFlash](#hasflash)。
+2. 设备是否支持指定的闪光灯模式,可使用方法[isFlashModeSupported](#isflashmodesupported)。
-说明: 设置闪光灯模式之前, 检查支持的闪光灯 (hasFlash method) 以及支持的闪光灯模式 (isFlashModeSupported method);
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|-----------|------------------------|-----------|----------------------------------------------------|
-| flashMode | FlashMode | Yes | 闪光灯模式 |
+| flashMode | [FlashMode](#flashmode) | 是 | 指定闪光灯模式。 |
**返回值:**
| 类型 | 说明 |
|-----------------------|-----------------------------------------|
-| Promise | 使用promise的方式获取结果 |
+| Promise | 使用Promise的方式获取结果。 |
**示例:**
@@ -890,25 +765,19 @@ cameraInput.setFlashMode(flashMode).then() => {
})
```
-### getFlashMode(callback: AsyncCallback): void;
-
-**系统能力:**
+### getFlashMode
-SystemCapability.Multimedia.Camera.Core
+getFlashMode(callback: AsyncCallback): void
-**说明:**
+获取当前设备的闪光灯模式,通过注册回调函数获取结果。
-获取当前闪光灯模式,使用callback的方式获取一个异步的结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|-----------|---------------------------|-----------|------------------------------------------------|
-| callback | AsyncCallback | Yes | 使用callback的方式获取当前闪光灯模式 |
-
-**返回值:**
-
-none
+| callback | AsyncCallback<[FlashMode](#flashmode)\> | 是 | 回调函数,用于获取当前设备的闪光灯模式。 |
**示例:**
@@ -922,25 +791,19 @@ cameraInput.getFlashMode((err, flashMode) => {
})
```
-### getFlashMode(): Promise;
-
-**系统能力:**
-
-SystemCapability.Multimedia.Camera.Core
-
-**说明:**
+### getFlashMode
-获取当前闪光灯模式,使用promise的方式获取结果。
+getFlashMode(): Promise
-**参数:**
+获取当前设备的闪光灯模式,通过Promise获取结果。
-none
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**返回值:**
| 类型 | 说明 |
|-----------------------|---------------------------------------------------|
-| Promise | 使用promise的方式获取当前闪光灯模式 |
+| Promise<[FlashMode](#flashmode)\> | 使用Promise的方式获取当前的闪光灯模式。 |
**示例:**
@@ -950,26 +813,20 @@ cameraInput.getFlashMode().then(flashMode) => {
})
```
-### isFocusModeSupported(afMode: FocusMode, callback: AsyncCallback): void;
-
-**系统能力:**
+### isFocusModeSupported
-SystemCapability.Multimedia.Camera.Core
+isFocusModeSupported(afMode: FocusMode, callback: AsyncCallback): void
-**说明:**
+判断设备是否支持指定的焦距模式,通过注册回调函数获取结果。
-检查支持的焦距模式,使用callback的方式获取一个异步的结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|-----------|------------------------|-----------|----------------------------------------------------|
-| afMode | FocusMode | Yes | 焦距模式 |
-| callback | AsyncCallback | Yes | 使用callback的方式获取设备支持的焦距模式 |
-
-**返回值:**
-
-none
+| afMode | [FocusMode](#focusmode) | 是 | 指定的焦距模式。 |
+| callback | AsyncCallback | 是 | 回调函数,返回true表示支持该焦距模式。 |
**示例:**
@@ -983,27 +840,25 @@ cameraInput.isFocusModeSupported(afMode, (err, status) => {
})
```
-### isFocusModeSupported(afMode: FocusMode): Promise;
-
-**系统能力:**
+### isFocusModeSupported
-SystemCapability.Multimedia.Camera.Core
+isFocusModeSupported(afMode: FocusMode): Promise
-**说明:**
+判断设备是否支持指定的焦距模式,通过Promise获取结果。
-检查支持的焦距模式,使用promise的方式获取结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|-----------|----------------------------------------|-----------|-------------|
-| afMode | FocusMode | Yes | 焦距模式 |
+| afMode | [FocusMode](#focusmode) | 是 | 指定的焦距模式。 |
**返回值:**
| 类型 | 说明 |
|-----------------------|---------------------------------------------------|
-| Promise | 使用promise的方式获取结果 |
+| Promise | 使用Promise的方式获取结果,返回true表示设备支持该焦距模式。 |
**示例:**
@@ -1013,28 +868,22 @@ cameraInput.isFocusModeSupported(afMode).then((status) => {
})
```
-### setFocusMode(afMode: FocusMode, callback: AsyncCallback): void;
+### setFocusMode
-**系统能力:**
+setFocusMode(afMode: FocusMode, callback: AsyncCallback): void
-SystemCapability.Multimedia.Camera.Core
+设置焦距模式,通过注册回调函数获取结果。
-**说明:**
+进行设置之前,需要先检查设备是否支持指定的焦距模式,可使用方法[isFocusModeSupported](#isfocusmodesupported)。
-设置焦距模式,使用callback的方式获取一个异步的结果。
-
-说明:使用设置焦距模式之前,检查设备支持的焦距模式 (isFocusModeSupported method);
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|-----------|------------------------|-----------|------------------------------------|
-| afMode | FocusMode | Yes | 焦距模式 |
-| callback | AsyncCallback | Yes | 使用callback的方式获取结果 |
-
-**返回值:**
-
-none
+| afMode | [FocusMode](#focusmode) | 是 | 指定的焦距模式。 |
+| callback | AsyncCallback | 是 | 回调函数,用于获取结果。 |
**示例:**
@@ -1048,29 +897,27 @@ cameraInput.setFocusMode(afMode, (err) => {
})
```
-### setFocusMode(afMode: FocusMode): Promise;
-
-**系统能力:**
+### setFocusMode
-SystemCapability.Multimedia.Camera.Core
+setFocusMode(afMode: FocusMode): Promise
-**说明:**
+设置焦距模式,通过Promise获取结果。
-设置焦距模式,使用promise的方式获取结果。
+进行设置之前,需要先检查设备是否支持指定的焦距模式,可使用方法[isFocusModeSupported](#isfocusmodesupported)。
-说明:使用设置焦距模式之前,检查设备支持的焦距模式 (isFocusModeSupported method);
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|-----------|-----------------------------------------|-----------|-------------|
-| afMode | FocusMode | Yes | 焦距模式 |
+| afMode | [FocusMode](#focusmode) | 是 | 指定的焦距模式。 |
**返回值:**
| 类型 | 说明 |
|-----------------------|-----------------------------------------|
-| Promise | 使用promise的方式获取结果 |
+| Promise | 使用Promise的方式获取结果。 |
**示例:**
@@ -1080,25 +927,19 @@ cameraInput.setFocusMode(afMode).then() => {
})
```
-### getFocusMode(callback: AsyncCallback): void;
-
-**系统能力:**
+### getFocusMode
-SystemCapability.Multimedia.Camera.Core
+getFocusMode(callback: AsyncCallback): void
-**说明:**
+获取当前设备的焦距模式,通过注册回调函数获取结果。
-获取当前的焦距模式,使用callback的方式获取一个异步的结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|-----------|---------------------------|-----------|------------------------------------------------|
-| callback | AsyncCallback | Yes | 使用callback的方式获取结果 |
-
-**返回值:**
-
-none
+| callback | AsyncCallback<[FocusMode](#focusmode)\> | 是 | 回调函数,用于获取当前设备的焦距模式。 |
**示例:**
@@ -1112,25 +953,19 @@ cameraInput.getFocusMode((err, afMode) => {
})
```
-### getFocusMode(): Promise;
-
-**系统能力:**
-
-SystemCapability.Multimedia.Camera.Core
+### getFocusMode
-**说明:**
+getFocusMode(): Promise
-获取当前的焦距模式,使用promise的方式获取结果。
+获取当前设备的焦距模式,通过Promise获取结果。
-**参数:**
-
-none
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**返回值:**
-| 类型 | 说明 |
-|-----------------------|---------------------------------------------------|
-| Promise | 使用promise的方式获取结果 |
+| 类型 | 说明 |
+| ------------------- | ------------------------------------- |
+| Promise | 使用Promise的方式获取当前的焦距模式。 |
**示例:**
@@ -1140,26 +975,19 @@ cameraInput.getFocusMode().then(afMode) => {
})
```
-### getZoomRatioRange\(callback: AsyncCallback\>\): void;
+### getZoomRatioRange
-**系统能力:**
+getZoomRatioRange\(callback: AsyncCallback\>\): void
-SystemCapability.Multimedia.Camera.Core
+获取可变焦距比范围,通过注册回调函数获取结果。
-**说明:**
-
-获取变焦比率的范围,使用callback的方式获取一个异步的结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|----------|--------------------------------|-----------|-------------------------------------------------|
-| callback | AsyncCallback\> | Yes | 使用callback的方式获取变焦比率的范围 |
-
-
-**返回值:**
-
-none
+| callback | AsyncCallback\> | 是 | 回调函数,用于获取结果。 |
**示例:**
@@ -1173,25 +1001,19 @@ cameraInput.getZoomRatioRange(err, zoomRatioRange) => {
})
```
-### getZoomRatioRange\(\): Promise\>;
-
-**系统能力:**
+### getZoomRatioRange
-SystemCapability.Multimedia.Camera.Core
+getZoomRatioRange\(\): Promise\>
-**说明:**
-
-获取变焦比率的范围,使用promise的方式获取结果。
-
-**参数:**
+获取可变焦距比范围,通过Promise获取结果。
-none
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**返回值:**
| 类型 | 说明 |
|------------------------|---------------------------------------------|
-| Promise\> | 使用promise的方式获取变焦比率的范围 |
+| Promise\> | 使用Promise的方式获取当前的可变焦距比范围。 |
**示例:**
@@ -1201,26 +1023,20 @@ cameraInput.getZoomRatioRange().then((zoomRatioRange) => {
})
```
-### setZoomRatio(zoomRatio: number, callback: AsyncCallback): void;
+### setZoomRatio
-**系统能力:**
+setZoomRatio(zoomRatio: number, callback: AsyncCallback): void
-SystemCapability.Multimedia.Camera.Core
+设置可变焦距比,通过注册回调函数获取结果。
-**说明:**
-
-设置变焦比率,使用callback的方式获取一个异步的结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|-----------|------------------------|-----------|------------------------------------|
-| zoomRatio | number | Yes | 变焦比率 |
-| callback | AsyncCallback | Yes | 使用callback的方式获取结果 |
-
-**返回值:**
-
-none
+| zoomRatio | number | 是 | 可变焦距比。 |
+| callback | AsyncCallback | 是 | 回调函数,用于获取结果。 |
**示例:**
@@ -1234,27 +1050,25 @@ cameraInput.setZoomRatio(zoomRatio, (err) => {
})
```
-### setZoomRatio(zoomRatio: number): Promise;
-
-**系统能力:**
+### setZoomRatio
-SystemCapability.Multimedia.Camera.Core
+setZoomRatio(zoomRatio: number): Promise
-**说明:**
+设置可变焦距比,通过Promise获取结果。
-设置变焦比率,使用promise的方式获取结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|-----------|----------|-----------|-------------|
-| zoomRatio | number | Yes | 变焦比率 |
+| zoomRatio | number | 是 | 可变焦距比。 |
**返回值:**
| 类型 | 说明 |
|-----------------------|-----------------------------------------|
-| Promise | Promise used to return the result |
+| Promise | 使用Promise的方式获取结果。 |
**示例:**
@@ -1264,25 +1078,19 @@ cameraInput.setZoomRatio(zoomRatio).then() => {
})
```
-### getZoomRatio(callback: AsyncCallback): void;
-
-**系统能力:**
+### getZoomRatio
-SystemCapability.Multimedia.Camera.Core
+getZoomRatio(callback: AsyncCallback): void
-**说明:**
+获取当前的可变焦距比,通过注册回调函数获取结果。
-获取当前的变焦比率,使用callback的方式获取一个异步的结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|-----------|---------------------------|-----------|------------------------------------------------------|
-| callback | AsyncCallback | Yes | 使用callback的方式获取结果 |
-
-**返回值:**
-
-none
+| callback | AsyncCallback | 是 | 回调函数,用于获取结果。 |
**示例:**
@@ -1296,25 +1104,19 @@ cameraInput.getZoomRatio((err, zoomRatio) => {
})
```
-### getZoomRatio(): Promise;
+### getZoomRatio
-**系统能力:**
+getZoomRatio(): Promise
-SystemCapability.Multimedia.Camera.Core
+获取当前的可变焦距比,通过Promise获取结果。
-**说明:**
-
-Gets current zoom ratio value. This method uses a promise to return the result.
-
-**参数:**
-
-none
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**返回值:**
-| 类型 | 说明 |
-|-----------------------|---------------------------------------------------|
-| Promise | Promise used to return the zoom ratio vaule |
+| 类型 | 说明 |
+| ---------------- | --------------------------- |
+| Promise | 使用Promise的方式获取结果。 |
**示例:**
@@ -1324,25 +1126,19 @@ cameraInput.getZoomRatio().then(zoomRatio) => {
})
```
-### release\(callback: AsyncCallback\): void;
+### release
-**系统能力:**
+release\(callback: AsyncCallback\): void
-SystemCapability.Multimedia.Camera.Core
+释放相机实例,通过注册回调函数获取结果。
-**说明:**
-
-释放这个 **相机输入** 实例,使用callback的方式获取一个异步的结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|----------|----------------------|-----------|------------------------------------|
-| callback | AsyncCallback | Yes | 使用异步的方式获取结果 |
-
-**返回值:**
-
-none
+| callback | AsyncCallback | 是 | 回调函数,用于获取结果。 |
**示例:**
@@ -1356,25 +1152,19 @@ camera.release((err) => {
});
```
-### release(): Promise;
-
-**系统能力:**
-
-SystemCapability.Multimedia.Camera.Core
+### release
-**说明:**
+release(): Promise
-释放这个 **相机输入** 实例,使用promise的方式获取结果。
+释放相机实例,通过Promise获取结果。
-**参数:**
-
-none
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**返回值:**
| 类型 | 说明 |
|----------------|---------------------------------------------|
-| Promise | 使用promise的方式获取结果 |
+| Promise | 使用Promise的方式获取结果。 |
**示例:**
@@ -1384,26 +1174,20 @@ cameraInput.release().then(() => {
})
```
-### on(type: 'focusStateChange', callback: Callback): void;
-
-**系统能力:**
+### on('focusStateChange')
-SystemCapability.Multimedia.Camera.Core
+on(type: 'focusStateChange', callback: AsyncCallback): void
-**说明:**
+监听焦距的状态变化,通过注册回调函数获取结果。
-监听焦距的状态变化,使用callback的方式获取焦距的状态变化。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
| :------- | :--------------------- | :-------- | :-----------------------------------------------|
-| type | string | Yes | 监听项的名称 |
-| callback | Callback | Yes | 使用callback的方式获取结果 |
-
-**返回值:**
-
-None
+| type | string | 是 | 监听事件,固定为'focusStateChange',即焦距状态变化事件。 |
+| callback | AsyncCallback<[FocusState](#focusstate)\> | 是 | 回调函数,用于获取焦距状态。 |
**示例:**
@@ -1413,26 +1197,20 @@ cameraInput.on('focusStateChange', (focusState) => {
})
```
-### on(type: 'error', callback: Callback): void;
+### on('error')
-**系统能力:**
+on('error', callback: ErrorCallback): void
-SystemCapability.Multimedia.Camera.Core
+监听CameraInput的错误事件,通过注册回调函数获取结果。
-**说明:**
-
-监听**相机输入**的报错,使用callback的方式获取错误信息。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
| :------- | :--------------------- | :-------- | :-----------------------------------------------|
-| type | string | Yes | 监听项的名称 |
-| callback | Callback | Yes | 使用callback的方式获取**相机输入**的错误信息 |
-
-**返回值:**
-
-None
+| type | string | 是 | 监听事件,固定为'error'。 |
+| callback | ErrorCallback | 是 | 回调函数,用于获取结果。 |
**示例:**
@@ -1443,49 +1221,52 @@ cameraInput.on('error', (cameraInputError) => {
```
-## FlashMode
+## FlashMode
-枚举闪光灯模式。
+枚举,闪光灯模式。
| 名称 | 默认值 | 说明 |
|------------------------|---------------|------------------------|
-| FLASH_MODE_CLOSE | 0 | 闪光灯关闭模式
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| FLASH_MODE_OPEN | 1 | 闪光灯开启模式
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| FLASH_MODE_AUTO | 2 | 闪光灯自动模式
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| FLASH_MODE_ALWAYS_OPEN | 3 | 闪光灯常亮模式
系统能力 : SystemCapability.Multimedia.Camera.Core |
+| FLASH_MODE_CLOSE | 0 | 闪光灯关闭。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| FLASH_MODE_OPEN | 1 | 闪光灯开启。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| FLASH_MODE_AUTO | 2 | 自动闪光灯。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| FLASH_MODE_ALWAYS_OPEN | 3 | 闪光灯常亮。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
-## FocusMode
+## FocusMode
-枚举焦距模式。
+枚举,焦距模式。
| 名称 | 默认值 | 说明 |
|----------------------------|---------------|----------------------------|
-| FOCUS_MODE_MANUAL | 0 | 手动变焦模式
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| FOCUS_MODE_CONTINUOUS_AUTO | 1 | 连续自动变焦模式
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| FOCUS_MODE_AUTO | 2 | 自动变焦模式
系统能力 : SystemCapability.Multimedia.Camera.Core |
-| FOCUS_MODE_LOCKED | 3 | 焦距锁定模式
系统能力 : SystemCapability.Multimedia.Camera.Core |
+| FOCUS_MODE_MANUAL | 0 | 手动变焦模式。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| FOCUS_MODE_CONTINUOUS_AUTO | 1 | 连续自动变焦模式。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| FOCUS_MODE_AUTO | 2 | 自动变焦模式。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+| FOCUS_MODE_LOCKED | 3 | 定焦模式。
**系统能力:** SystemCapability.Multimedia.Camera.Core |
+
+## FocusState
+枚举,焦距状态。
-## createCaptureSession\(context: Context, callback: AsyncCallback\): void;
+| 名称 | 默认值 | 说明 |
+| --------------------- | ------ | ------------------------------------------------------------ |
+| FOCUS_STATE_SCAN | 0 | 扫描状态。
系统能力 : SystemCapability.Multimedia.Camera.Core |
+| FOCUS_STATE_FOCUSED | 1 | 相机已对焦。
系统能力 : SystemCapability.Multimedia.Camera.Core |
+| FOCUS_STATE_UNFOCUSED | 2 | 相机未对焦。
系统能力 : SystemCapability.Multimedia.Camera.Core |
-**系统能力:**
+## camera.createCaptureSession
-SystemCapability.Multimedia.Camera.Core
+createCaptureSession\(context: Context, callback: AsyncCallback\): void
-**说明:**
+获取CaptureSession实例,通过注册回调函数获取结果。
-创建 **拍照会话** 实例,使用callback的方式获取一个异步的实例。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|----------|--------------------------------|-----------|-----------------------------------------------------|
-| context | Context | Yes | 应用环境 |
-| callback | AsyncCallback | Yes | 使用callback的方式获取 **拍照会话** 实例 |
-
-**返回值:**
-
-none
+| context | Context | 是 | 应用上下文。 |
+| callback | AsyncCallback<[CaptureSession](#capturesession)\> | 是 | 回调函数,用于获取CaptureSession实例。 |
**示例:**
@@ -1499,27 +1280,25 @@ camera.createCaptureSession(context), (err, captureSession) => {
});
```
-## createCaptureSession(context: Context\): Promise;
+## camera.createCaptureSession
-**系统能力:**
+createCaptureSession(context: Context\): Promise;
-SystemCapability.Multimedia.Camera.Core
+获取CaptureSession实例,通过Promise获取结果。
-**说明:**
-
-创建 **拍照会话** 实例,使用promise方式获取一个实例。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|----------|-------------------------------|-----------|-----------------------------------------------------|
-| context | Context | Yes | 应用环境 |
+| context | Context | 是 | 应用上下文。 |
**返回值:**
| 类型 | 说明 |
|---------------------------|---------------------------------------------------|
-| Promise | 使用promise的方式获取**拍照会话**的实例 |
+| Promise<[CaptureSession](#capturesession)\> | 使用Promise的方式获取CaptureSession实例。 |
**示例:**
@@ -1529,30 +1308,23 @@ camera.createCaptureSession(context).then((captureSession) => {
})
```
-## CaptureSession
-
-**拍照会话**类。
+## CaptureSession
-### beginConfig\(callback: AsyncCallback\): void;
+拍照会话类。
-**系统能力:**
+### beginConfig
-SystemCapability.Multimedia.Camera.Core
+beginConfig\(callback: AsyncCallback\): void
-**说明:**
+开始配置会话,通过注册回调函数获取结果。
-设置此**拍照会话**实例,使用callback的方式获取一个异步的结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|----------|----------------------|-----------|----------------------------------------------|
-| callback | AsyncCallback | Yes | 使用callback的方式获取结果 |
-
-
-**返回值:**
-
-none
+| callback | AsyncCallback | 是 | 回调函数,用于获取结果。 |
**示例:**
@@ -1566,25 +1338,19 @@ captureSession.beginConfig((err) => {
});
```
-### beginConfig\(\): Promise;
+### beginConfig
-**系统能力:**
+beginConfig\(\): Promise
-SystemCapability.Multimedia.Camera.Core
+开始配置会话,通过Promise获取结果。
-**说明:**
-
-设置此**拍照会话**实例,使用promise的方式获取结果。
-
-**参数:**
-
-none
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**返回值:**
| 类型 | 说明 |
|---------------|---------------------------------------------|
-| Promise | 使用promise的方式获取结果 |
+| Promise | 使用Promise的方式获取结果。 |
**示例:**
@@ -1595,25 +1361,19 @@ captureSession.beginConfig().then(() => {
})
```
-### commitConfig\(callback: AsyncCallback\): void;
-
-**系统能力:**
+### commitConfig
-SystemCapability.Multimedia.Camera.Core
+commitConfig\(callback: AsyncCallback\): void
-**说明:**
+提交会话配置,通过注册回调函数获取结果。
-提交此**拍照会话**实例的设置,使用callback的方式获取一个异步的结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|----------|---------------------|-----------|----------------------------------------------|
-| callback | AsyncCallback | Yes | 使用callback的方式获取一个异步的结果 |
-
-**返回值:**
-
-none
+| callback | AsyncCallback | 是 | 回调函数,用于获取结果。 |
**示例:**
@@ -1627,26 +1387,19 @@ captureSession.commitConfig((err) => {
});
```
+### commitConfig
-### commitConfig\(\): Promise;
+commitConfig\(\): Promise
-**系统能力:**
+提交会话配置,通过Promise获取结果。
-SystemCapability.Multimedia.Camera.Core
-
-**说明:**
-
-提交此**拍照会话**实例的设置,使用promise的方式获取结果。
-
-**参数:**
-
-none
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**返回值:**
| 类型 | 说明 |
|---------------|---------------------------------------------|
-| Promise | 使用promise的方式获取结果 |
+| Promise | 使用Promise的方式获取结果。 |
**示例:**
@@ -1656,27 +1409,20 @@ captureSession.commitConfig().then(() => {
})
```
-### addInput\(cameraInput: CameraInput, callback: AsyncCallback\): void;
-
-**系统能力:**
+### addInput
-SystemCapability.Multimedia.Camera.Core
+addInput\(cameraInput: CameraInput, callback: AsyncCallback\): void
-**说明:**
+在当前会话中,添加一个CameraInput实例,通过注册回调函数获取结果。
-为此**拍照会话**实例添加一个**相机输入**,使用callback的方式获取一个异步的结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|-------------|----------------------|-----------|---------------------------------------------|
-| cameraInput | CameraInput | Yes | 需要添加的**相机输入**实例 |
-| callback | AsyncCallback | Yes | 使用callback的方式获取结果 |
-
-
-**返回值:**
-
-none
+| cameraInput | [CameraInput](#camerainput) | 是 | 需要添加的CameraInput实例。 |
+| callback | AsyncCallback | 是 | 回调函数,用于获取结果。 |
**示例:**
@@ -1690,27 +1436,25 @@ captureSession.addInput(cameraInput, (err) => {
});
```
-### addInput\(cameraInput: CameraInput\): Promise;
-
-**系统能力:**
+### addInput
-SystemCapability.Multimedia.Camera.Core
+addInput\(cameraInput: CameraInput\): Promise
-**说明:**
+在当前会话中,添加一个CameraInput实例,通过Promise获取结果。
-为此**拍照会话**实例添加一个**相机输入**,使用promise的方式获取结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|-------------|---------------------|-----------|-------------------------------|
-| cameraInput | CameraInput | Yes | 需要添加的**相机输入**实例 |
+| cameraInput | [CameraInput](#camerainput) | 是 | 需要添加的CameraInput实例。 |
**返回值:**
| 类型 | 说明 |
|----------------|------------------------------------|
-| Promise | 使用promise的方式获取结果 |
+| Promise | 使用Promise的方式获取结果。 |
**示例:**
@@ -1720,27 +1464,20 @@ captureSession.addInput(cameraInput).then(() => {
})
```
-### addOutput\(previewOutput: PreviewOutput, callback: AsyncCallback\): void;
+### addOutput
-**系统能力:**
+addOutput\(previewOutput: PreviewOutput, callback: AsyncCallback\): void
-SystemCapability.Multimedia.Camera.Core
+在当前会话中,添加一个PreviewOutput实例,通过注册回调函数获取结果。
-**说明:**
-
-为此**拍照会话**实例添加一个**预览输出**实例,使用callback的方式获取一个异步的结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|---------------|----------------------|-----------|-------------------------------------|
-| previewOutput | PreviewOutput | Yes | 需要添加的**预览输出**实例 |
-| callback | AsyncCallback | Yes | 使用callback的方式获取结果 |
-
-
-**返回值:**
-
-none
+| previewOutput | [PreviewOutput](#previewoutput) | 是 | 需要添加的PreviewOutput实例。 |
+| callback | AsyncCallback | 是 | 回调函数,用于获取结果。 |
**示例:**
@@ -1754,27 +1491,25 @@ captureSession.addOutput(previewOutput, (err) => {
});
```
-### addOutput\(previewOutput: PreviewOutput\): Promise;
-
-**系统能力:**
+### addOutput
-SystemCapability.Multimedia.Camera.Core
+addOutput\(previewOutput: PreviewOutput\): Promise
-**说明:**
+在当前会话中,添加一个PreviewOutput实例,通过Promise获取结果。
-为此**拍照会话**实例添加一个**预览输出**实例,使用promise的方式获取结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|---------------|---------------------|-----------|--------------------------------|
-| previewOutput | PreviewOutput | Yes | 需要添加的**预览输出**实例 |
+| previewOutput | [PreviewOutput](#previewoutput) | 是 | 需要添加的PreviewOutput实例。 |
**返回值:**
| 类型 | 说明 |
|----------------|-----------------------------------|
-| Promise | 使用promise的方式获取结果 |
+| Promise | 使用Promise的方式获取结果。 |
**示例:**
@@ -1784,26 +1519,20 @@ captureSession.addOutput(previewOutput).then(() => {
})
```
-### addOutput\(photoOutput: PhotoOutput, callback: AsyncCallback\): void;
+### addOutput
-**系统能力:**
+addOutput\(photoOutput: PhotoOutput, callback: AsyncCallback\): void
-SystemCapability.Multimedia.Camera.Core
+在当前会话中,添加一个PhotoOutput实例,通过注册回调函数获取结果。
-**说明:**
-
-为此**拍照会话**实例添加一个**照片输出**实例, 使用callback的方式获取一个异步的结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|---------------|---------------------|-----------|-------------------------------------|
-| photoOutput | PhotoOutput | Yes | 需要添加的**照片输出**实例 |
-| callback | AsyncCallback | Yes | 使用callback的方式获取结果 |
-
-**返回值:**
-
-none
+| photoOutput | [PhotoOutput](#photooutput) | 是 | 需要添加的PhotoOutput实例。 |
+| callback | AsyncCallback | 是 | 回调函数,用于获取结果。 |
**示例:**
@@ -1817,27 +1546,25 @@ captureSession.addOutput(photoOutput, (err) => {
});
```
-### addOutput\(photoOutput: PhotoOutput\): Promise;
-
-**系统能力:**
+### addOutput
-SystemCapability.Multimedia.Camera.Core
+addOutput\(photoOutput: PhotoOutput\): Promise
-**说明:**
+在当前会话中,添加一个PreviewOutput实例,通过Promise获取结果。
-为此**拍照会话**实例添加一个**照片输出**实例,使用promise的方式获取结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|---------------|---------------------|-----------|--------------------------------|
-| photoOutput | PhotoOutput | Yes | 需要添加的**照片输出**实例 |
+| photoOutput | [PhotoOutput](#photooutput) | 是 | 需要添加的PhotoOutput实例。 |
**返回值:**
| 类型 | 说明 |
|---------------|-----------------------------------|
-| Promise | 使用promise的方式获取结果 |
+| Promise\ | 使用Promise的方式获取结果。 |
**示例:**
@@ -1847,26 +1574,20 @@ captureSession.addOutput(photoOutput).then(() => {
})
```
-### addOutput\(videoOutput: VideoOutput, callback: AsyncCallback\): void;
-
-**系统能力:**
+### addOutput
-SystemCapability.Multimedia.Camera.Core
+addOutput\(videoOutput: VideoOutput, callback: AsyncCallback\): void
-**说明:**
+在当前会话中,添加一个VideoOutput实例,通过注册回调函数获取结果。
-为此**拍照会话**实例添加一个**视频输出**实例,使用callback的方式获取一个异步的结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|---------------|---------------------|-----------|-------------------------------------|
-| videoOutput | VideoOutput | Yes | 需要添加的**视频输出**实例 |
-| callback | AsyncCallback | Yes | 使用callback的方式获取结果 |
-
-**返回值:**
-
-none
+| videoOutput | [VideoOutput](#videooutput) | 是 | 需要添加的VideoOutput实例。 |
+| callback | AsyncCallback | 是 | 回调函数,用于获取结果。 |
**示例:**
@@ -1880,27 +1601,25 @@ captureSession.addOutput(videoOutput, (err) => {
});
```
-### addOutput\(videoOutput: VideoOutput\): Promise;
+### addOutput
-**系统能力:**
+addOutput\(videoOutput: VideoOutput\): Promise
-SystemCapability.Multimedia.Camera.Core
+在当前会话中,添加一个VideoOutput实例,通过Promise获取结果。
-**说明:**
-
-为此**拍照会话**实例添加一个**视频输出**实例, 使用promise的方式获取结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
-| 名称 | 类型 | 必填 | 说明 |
-|---------------|---------------------|-----------|--------------------------------|
-| videoOutput | VideoOutput | Yes | 需要添加的**视频输出**实例 |
+| 名称 | 类型 | 必填 | 说明 |
+| ----------- | --------------------------- | ---- | --------------------------- |
+| videoOutput | [VideoOutput](#videooutput) | 是 | 需要添加的VideoOutput实例。 |
**返回值:**
-| 类型 | 说明 |
-|----------------|-----------------------------------|
-| Promise | 使用promise的方式获取结果 |
+| 类型 | 说明 |
+| -------------- | --------------------------- |
+| Promise\ | 使用Promise的方式获取结果。 |
**示例:**
@@ -1910,27 +1629,20 @@ captureSession.addOutput(videoOutput).then(() => {
})
```
-### removeInput\(cameraInput: CameraInput, callback: AsyncCallback\): void;
-
-**系统能力:**
+### removeInput
-SystemCapability.Multimedia.Camera.Core
+removeInput\(cameraInput: CameraInput, callback: AsyncCallback\): void
-**说明:**
+在当前会话中,移除一个CameraInput实例,通过注册回调函数获取结果。
-为此**拍照会话**实例移除一个**相机输入**实例,使用callback的方式获取一个异步的结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|-------------|----------------------|-----------|------------------------------------|
-| cameraInput | CameraInput | Yes | 需要移除的**相机输入**实例 |
-| callback | AsyncCallback | Yes | 使用callback的方式获取结果 |
-
-
-**返回值:**
-
-none
+| cameraInput | [CameraInput](#camerainput) | 是 | 需要移除的CameraInput实例。 |
+| callback | AsyncCallback | 是 | 回调函数,用于获取结果。 |
**示例:**
@@ -1944,27 +1656,25 @@ captureSession.removeInput(cameraInput, (err) => {
});
```
-### removeInput\(cameraInput: CameraInput\): Promise;
-
-**系统能力:**
+### removeInput
-SystemCapability.Multimedia.Camera.Core
+removeInput\(cameraInput: CameraInput\): Promise
-**说明:**
+在当前会话中,移除一个CameraInput实例,通过Promise获取结果。
-为此**拍照会话**实例移除一个**相机输入**实例,使用promise的方式获取结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|-------------|---------------------|-----------|---------------------------------|
-| cameraInput | CameraInput | Yes | 需要移除的**相机输入**实例 |
+| cameraInput | [CameraInput](#camerainput) | 是 | 需要移除的CameraInput实例。 |
**返回值:**
| 类型 | 说明 |
|----------------|-----------------------------------|
-| Promise | 使用promise的方式获取结果 |
+| Promise\ | 使用Promise的方式获取结果。 |
**示例:**
@@ -1974,26 +1684,20 @@ captureSession.removeInput(cameraInput).then(() => {
})
```
-### removeOutput\(previewOutput: PreviewOutput, callback: AsyncCallback\): void;
-
-**系统能力:**
+### removeOutput
-SystemCapability.Multimedia.Camera.Core
+removeOutput\(previewOutput: PreviewOutput, callback: AsyncCallback\): void
-**说明:**
+在当前会话中,移除一个PreviewOutput实例,通过注册回调函数获取结果。
-为此**拍照会话**实例移除一个**预览输出**实例,使用callback的方式获取一个异步的结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|---------------|----------------------|-----------|------------------------------------|
-| previewOutput | PreviewOutput | Yes | 需要移除的**预览输出**实例 |
-| callback | AsyncCallback | Yes | 使用callback的方式获取结果 |
-
-**返回值:**
-
-none
+| previewOutput | [PreviewOutput](#previewoutput) | 是 | 需要移除的PreviewOutput实例。 |
+| callback | AsyncCallback | 是 | 回调函数,用于获取结果。 |
**示例:**
@@ -2007,28 +1711,26 @@ captureSession.removeOutput(previewOutput, (err) => {
});
```
-### removeOutput(previewOutput: PreviewOutput): Promise;
+### removeOutput
-**系统能力:**
+removeOutput(previewOutput: PreviewOutput): Promise
-SystemCapability.Multimedia.Camera.Core
+在当前会话中,移除一个PreviewOutput实例,通过Promise获取结果。
-**说明:**
-
-为此**拍照会话**实例移除一个**预览输出**实例,使用promise的方式获取结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|---------------|---------------------|-----------|-----------------------------------|
-| previewOutput | PreviewOutput | Yes | 需要移除的**预览输出**实例 |
+| previewOutput | [PreviewOutput](#previewoutput) | 是 | 需要移除的PreviewOutput实例。 |
**返回值:**
| 类型 | 说明 |
|---------------|---------------------------------------------|
-| Promise | 使用promise的方式获取结果 |
+| Promise | 使用Promise的方式获取结果。 |
**示例:**
@@ -2039,26 +1741,20 @@ captureSession.removeOutput(previewOutput).then(() => {
})
```
-### removeOutput(photoOutput: PhotoOutput, callback: AsyncCallback): void;
-
-**系统能力:**
+### removeOutput
-SystemCapability.Multimedia.Camera.Core
+removeOutput(photoOutput: PhotoOutput, callback: AsyncCallback): void
-**说明:**
+在当前会话中,移除一个PhotoOutput实例,通过注册回调函数获取结果。
-为此**拍照会话**实例移除一个**照片输出**实例,使用callback的方式获取一个异步的结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|---------------|----------------------|-----------|------------------------------------|
-| photoOutput | PhotoOutput | Yes | 需要移除的**照片输出**实例 |
-| callback | AsyncCallback | Yes | 使用callback的方式获取结果 |
-
-**返回值:**
-
-none
+| photoOutput | [PhotoOutput](#photooutput) | 是 | 需要添加的PhotoOutput实例。 |
+| callback | AsyncCallback | 是 | 回调函数,用于获取结果。 |
**示例:**
@@ -2072,28 +1768,26 @@ captureSession.removeOutput(photoOutput, (err) => {
});
```
-### removeOutput(photoOutput: PhotoOutput): Promise;
-
-**系统能力:**
+### removeOutput
-SystemCapability.Multimedia.Camera.Core
+removeOutput(photoOutput: PhotoOutput): Promise
-**说明:**
+在当前会话中,移除一个PhotoOutput实例,通过Promise获取结果。
-为此**拍照会话**实例移除一个**照片输出**实例,使用promise的方式获取结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|---------------|---------------------|-----------|---------------------------------|
-| photoOutput | PhotoOutput | Yes | 需要移除的**照片输出**实例 |
+| photoOutput | [PhotoOutput](#photooutput) | 是 | 需要添加的PhotoOutput实例。 |
**返回值:**
| 类型 | 说明 |
|---------------|------------------------------------|
-| Promise | 使用promise的方式获取结果 |
+| Promise | 使用Promise的方式获取结果。 |
**示例:**
@@ -2104,26 +1798,20 @@ captureSession.removeOutput(photoOutput).then(() => {
})
```
-### removeOutput(videoOutput: VideoOutput, callback: AsyncCallback): void;
+### removeOutput
-**系统能力:**
+removeOutput(videoOutput: VideoOutput, callback: AsyncCallback): void
-SystemCapability.Multimedia.Camera.Core
+在当前会话中,移除一个VideoOutput实例,通过注册回调函数获取结果。
-**说明:**
-
-为此**拍照会话**实例移除一个**视频输出**实例,使用callback的方式获取一个异步的结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|---------------|----------------------|-----------|------------------------------------|
-| videoOutput | VideoOutput | Yes | 需要移除的**视频输出**实例 |
-| callback | AsyncCallback | Yes | 使用callback的方式获取结果 |
-
-**返回值:**
-
-none
+| videoOutput | [VideoOutput](#videooutput) | 是 | 需要添加的VideoOutput实例。 |
+| callback | AsyncCallback | 是 | 回调函数,用于获取结果。 |
**示例:**
@@ -2137,28 +1825,26 @@ captureSession.removeOutput(videoOutput, (err) => {
});
```
-### removeOutput(videoOutput: VideoOutput): Promise;
-
-**系统能力:**
+### removeOutput
-SystemCapability.Multimedia.Camera.Core
+removeOutput(videoOutput: VideoOutput): Promise
-**说明:**
+在当前会话中,移除一个VideoOutput实例,通过Promise获取结果。
-为此**拍照会话**实例移除一个**视频输出**实例,使用promise的方式获取结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|---------------|---------------------|-----------|---------------------------------|
-| videoOutput | VideoOutput | Yes | 需要移除的**照片输出**实例 |
+| videoOutput | [VideoOutput](#videooutput) | 是 | 需要添加的VideoOutput实例。 |
**返回值:**
| 类型 | 说明 |
|----------------|---------------------------------------------|
-| Promise | 使用promise的方式获取结果 |
+| Promise | 使用Promise的方式获取结果。 |
**示例:**
@@ -2169,25 +1855,19 @@ captureSession.removeOutput(videoOutput).then(() => {
})
```
-### start\(callback: AsyncCallback\): void;
-
-**系统能力:**
+### start
-SystemCapability.Multimedia.Camera.Core
+start\(callback: AsyncCallback\): void
-**说明:**
+启动拍照会话,通过注册回调函数获取结果。
-开启**拍照会话** 实例, 使用callback的方式获取一个异步的结果。
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**参数:**
| 名称 | 类型 | 必填 | 说明 |
|----------|----------------------|-----------|----------------------------------------------|
-| callback | AsyncCallback | Yes | 使用callback的方式获取结果 |
-
-**返回值:**
-
-none
+| callback | AsyncCallback | 是 | 回调函数,用于获取结果。 |
**示例:**
@@ -2201,25 +1881,19 @@ captureSession.start((err) => {
});
```
-### start\(\): Promise;
-
-**系统能力:**
-
-SystemCapability.Multimedia.Camera.Core
+### start
-**说明:**
+start\(\): Promise
-开启**拍照会话** 实例,使用promise的方式获取结果。
+启动拍照会话,通过Promise获取结果。
-**参数:**
-
-none
+**系统能力:** SystemCapability.Multimedia.Camera.Core
**返回值:**
| 类型 | 说明 |
|----------------|-----------------------------------|
-| Promise | 使用promise的方式获取结果 |
+| Promise