From 45b66055be2afc6ed70fb42598584dff3bd33f35 Mon Sep 17 00:00:00 2001 From: zengyawen Date: Wed, 29 Mar 2023 15:02:50 +0800 Subject: [PATCH] update docs Signed-off-by: zengyawen --- .../reference/apis/js-apis-audio.md | 12 +- .../reference/apis/js-apis-call.md | 208 +++++++++--------- .../reference/apis/js-apis-power.md | 2 +- .../apis/js-apis-system-brightness.md | 5 +- .../errorcodes/errorcode-telephony.md | 4 +- 5 files changed, 114 insertions(+), 117 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-audio.md b/zh-cn/application-dev/reference/apis/js-apis-audio.md index b729b6dec0..6768127762 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-audio.md +++ b/zh-cn/application-dev/reference/apis/js-apis-audio.md @@ -1104,7 +1104,7 @@ setVolume(volumeType: AudioVolumeType, volume: number, callback: AsyncCallback&l 设置指定流的音量，使用callback方式异步返回结果。 > **说明：** -> 从 API version 7 开始支持，从 API version 9 开始废弃，建议使用AudioVolumeGroupManager中的[setVolume](#setvolume9)替代。 +> 从 API version 7 开始支持，从 API version 9 开始废弃。建议使用AudioVolumeGroupManager中的[setVolume](#setvolume9)替代，替代接口能力仅对系统应用开放。 **需要权限：** ohos.permission.ACCESS_NOTIFICATION_POLICY @@ -1139,7 +1139,7 @@ setVolume(volumeType: AudioVolumeType, volume: number): Promise<void> 设置指定流的音量，使用Promise方式异步返回结果。 > **说明：** -> 从 API version 7 开始支持，从 API version 9 开始废弃，建议使用AudioVolumeGroupManager中的[setVolume](#setvolume9)替代。 +> 从 API version 7 开始支持，从 API version 9 开始废弃。建议使用AudioVolumeGroupManager中的[setVolume](#setvolume9)替代，替代接口能力仅对系统应用开放。 **需要权限：** ohos.permission.ACCESS_NOTIFICATION_POLICY @@ -1358,7 +1358,7 @@ mute(volumeType: AudioVolumeType, mute: boolean, callback: AsyncCallback<void 设置指定音量流静音，使用callback方式异步返回结果。 > **说明：** -> 从 API version 7 开始支持，从 API version 9 开始废弃，建议使用AudioVolumeGroupManager中的[mute](#mute9)替代。 +> 从 API version 7 开始支持，从 API version 9 开始废弃。建议使用AudioVolumeGroupManager中的[mute](#mute9)替代，替代接口能力仅对系统应用开放。 **系统能力：** SystemCapability.Multimedia.Audio.Volume @@ -1389,7 +1389,7 @@ mute(volumeType: AudioVolumeType, mute: boolean): Promise<void> 设置指定音量流静音，使用Promise方式异步返回结果。 > **说明：** -> 从 API version 7 开始支持，从 API version 9 开始废弃，建议使用AudioVolumeGroupManager中的[mute](#mute9)替代。 +> 从 API version 7 开始支持，从 API version 9 开始废弃。建议使用AudioVolumeGroupManager中的[mute](#mute9)替代，替代接口能力仅对系统应用开放。 **系统能力：** SystemCapability.Multimedia.Audio.Volume @@ -1544,7 +1544,7 @@ setRingerMode(mode: AudioRingMode, callback: AsyncCallback<void>): void 设置铃声模式，使用callback方式异步返回结果。 > **说明：** -> 从 API version 7 开始支持，从 API version 9 开始废弃，建议使用AudioVolumeGroupManager中的[setRingerMode](#setringermode9)替代。 +> 从 API version 7 开始支持，从 API version 9 开始废弃。建议使用AudioVolumeGroupManager中的[setRingerMode](#setringermode9)替代，替代接口能力仅对系统应用开放。 **需要权限：** ohos.permission.ACCESS_NOTIFICATION_POLICY @@ -1578,7 +1578,7 @@ setRingerMode(mode: AudioRingMode): Promise<void> 设置铃声模式，使用Promise方式异步返回结果。 > **说明：** -> 从 API version 7 开始支持，从 API version 9 开始废弃，建议使用AudioVolumeGroupManager中的[setRingerMode](#setringermode9)替代。 +> 从 API version 7 开始支持，从 API version 9 开始废弃。建议使用AudioVolumeGroupManager中的[setRingerMode](#setringermode9)替代，替代接口能力仅对系统应用开放。 **需要权限：** ohos.permission.ACCESS_NOTIFICATION_POLICY diff --git a/zh-cn/application-dev/reference/apis/js-apis-call.md b/zh-cn/application-dev/reference/apis/js-apis-call.md index 06603177f7..943762c74a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-call.md +++ b/zh-cn/application-dev/reference/apis/js-apis-call.md @@ -14,110 +14,6 @@ import call from '@ohos.telephony.call'; ``` -## call.dial(deprecated) - -dial\(phoneNumber: string, callback: AsyncCallback\): void - -拨打电话。使用callback异步回调。 - ->**说明：** -> ->从API version 6 开始支持，从API version 9 开始废弃，建议使用[dialCall](#calldialcall9)替代。 - -**需要权限**：ohos.permission.PLACE_CALL - -**系统能力**：SystemCapability.Telephony.CallManager - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| ----------- | ---------------------------- | ---- | --------------------------------------- | -| phoneNumber | string | 是 | 电话号码。 | -| callback | AsyncCallback<boolean> | 是 | 回调函数，返回true为成功，false为失败。 | - -**示例：** - -```js -call.dial("138xxxxxxxx", (err, data) => { - console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); -}); -``` - - -## call.dial(deprecated) - -dial\(phoneNumber: string, options: DialOptions, callback: AsyncCallback\): void - -拨打电话，可设置通话参数。使用callback异步回调。 - ->**说明：** -> ->从API version 6 开始支持，从API version 9 开始废弃，建议使用[dialCall](#calldialcall9)替代。 - -**需要权限**：ohos.permission.PLACE_CALL - -**系统能力**：SystemCapability.Telephony.CallManager - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| ----------- | ---------------------------- | ---- | --------------------------------------- | -| phoneNumber | string | 是 | 电话号码。 | -| options | [DialOptions](#dialoptions) | 是 | 通话参数，选择为语音通话还是视频通话。 | -| callback | AsyncCallback<boolean> | 是 | 回调函数，返回true为成功，false为失败。 | - -**示例：** - -```js -call.dial("138xxxxxxxx", { - extras: false -}, (err, data) => { - console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); -}); -``` - - -## call.dial(deprecated) - -dial\(phoneNumber: string, options?: DialOptions\): Promise - -拨打电话，可设置通话参数。使用Promise异步回调。 - ->**说明：** -> ->从API version 6 开始支持，从API version 9 开始废弃，建议使用[dialCall](#calldialcall9)替代。 - -**需要权限**：ohos.permission.PLACE_CALL - -**系统能力**：SystemCapability.Telephony.CallManager - -**参数：** - -| 参数名 | 类型 | 必填 | 说明 | -| ----------- | --------------------------- | ---- | -------------------------------------- | -| phoneNumber | string | 是 | 电话号码。 | -| options | [DialOptions](#dialoptions) | 否 | 通话参数，选择为语音通话还是视频通话。 | - -**返回值：** - -| 类型 | 说明 | -| ---------------------- | ------------------------------------------------------------ | -| Promise<boolean> | 以Promise形式返回拨打电话的结果，返回true为成功，false为失败。 | - -**示例：** - -```js -let promise = call.dial("138xxxxxxxx", { - extras: false -}); -promise.then(data => { - console.log(`dial success, promise: data->${JSON.stringify(data)}`); -}).catch(err => { - console.error(`dial fail, promise: err->${JSON.stringify(err)}`); -}); -``` - - ## call.dialCall9+ dialCall\(phoneNumber: string, callback: AsyncCallback\): void @@ -158,7 +54,6 @@ call.dialCall("138xxxxxxxx", (err) => { }); ``` - ## call.dialCall9+ dialCall\(phoneNumber: string, options: DialCallOptions, callback: AsyncCallback\): void @@ -205,7 +100,6 @@ call.dialCall("138xxxxxxxx", { }); ``` - ## call.dialCall9+ dialCall\(phoneNumber: string, options?: DialCallOptions\): Promise @@ -260,6 +154,108 @@ promise.then(() => { }); ``` +## call.dial(deprecated) + +dial\(phoneNumber: string, callback: AsyncCallback\): void + +拨打电话。使用callback异步回调。 + +>**说明：** +> +> 从API version 6 开始支持，从API version 9 开始废弃。请使用[dialCall](#calldialcall9)替代，替代接口能力仅对系统应用开放。 + +**需要权限**：ohos.permission.PLACE_CALL + +**系统能力**：SystemCapability.Telephony.CallManager + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| ----------- | ---------------------------- | ---- | --------------------------------------- | +| phoneNumber | string | 是 | 电话号码。 | +| callback | AsyncCallback<boolean> | 是 | 回调函数，返回true为成功，false为失败。 | + +**示例：** + +```js +call.dial("138xxxxxxxx", (err, data) => { + console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); +}); +``` + + +## call.dial(deprecated) + +dial\(phoneNumber: string, options: DialOptions, callback: AsyncCallback\): void + +拨打电话，可设置通话参数。使用callback异步回调。 + +>**说明：** +> +> 从API version 6 开始支持，从API version 9 开始废弃。请使用[dialCall](#calldialcall9)替代，替代接口能力仅对系统应用开放。 + +**需要权限**：ohos.permission.PLACE_CALL + +**系统能力**：SystemCapability.Telephony.CallManager + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| ----------- | ---------------------------- | ---- | --------------------------------------- | +| phoneNumber | string | 是 | 电话号码。 | +| options | [DialOptions](#dialoptions) | 是 | 通话参数，选择为语音通话还是视频通话。 | +| callback | AsyncCallback<boolean> | 是 | 回调函数，返回true为成功，false为失败。 | + +**示例：** + +```js +call.dial("138xxxxxxxx", { + extras: false +}, (err, data) => { + console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); +}); +``` + + +## call.dial(deprecated) + +dial\(phoneNumber: string, options?: DialOptions\): Promise + +拨打电话，可设置通话参数。使用Promise异步回调。 + +>**说明：** +> +> 从API version 6 开始支持，从API version 9 开始废弃。请使用[dialCall](#calldialcall9)替代，替代接口能力仅对系统应用开放。 + +**需要权限**：ohos.permission.PLACE_CALL + +**系统能力**：SystemCapability.Telephony.CallManager + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| ----------- | --------------------------- | ---- | -------------------------------------- | +| phoneNumber | string | 是 | 电话号码。 | +| options | [DialOptions](#dialoptions) | 否 | 通话参数，选择为语音通话还是视频通话。 | + +**返回值：** + +| 类型 | 说明 | +| ---------------------- | ------------------------------------------------------------ | +| Promise<boolean> | 以Promise形式返回拨打电话的结果，返回true为成功，false为失败。 | + +**示例：** + +```js +let promise = call.dial("138xxxxxxxx", { + extras: false +}); +promise.then(data => { + console.log(`dial success, promise: data->${JSON.stringify(data)}`); +}).catch(err => { + console.error(`dial fail, promise: err->${JSON.stringify(err)}`); +}); +``` ## call.makeCall7+ diff --git a/zh-cn/application-dev/reference/apis/js-apis-power.md b/zh-cn/application-dev/reference/apis/js-apis-power.md index 166b4eacc1..a03ed05ddd 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-power.md +++ b/zh-cn/application-dev/reference/apis/js-apis-power.md @@ -293,7 +293,7 @@ power.setPowerMode(power.DevicePowerMode.MODE_PERFORMANCE) rebootDevice(reason: string): void -> **说明：**
从API version 9开始不再维护，建议使用[power.reboot](#powerreboot9)替代。 +> **说明：**
从API version 7开始支持，从API version 9开始不再维护。建议使用[power.reboot](#powerreboot9)替代，替代接口能力仅对系统应用开放。 重启设备。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-brightness.md b/zh-cn/application-dev/reference/apis/js-apis-system-brightness.md index a47d9f3f50..0d44e435ef 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-brightness.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-brightness.md @@ -2,8 +2,9 @@ 该模块提供屏幕亮度和模式的查询、调节接口。 -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> - 从API Version 7 开始不再维护，建议使用[`@ohos.brightness`](js-apis-brightness.md)替代。 +> **说明：** +> +> - 从API Version 7 开始不再维护。建议使用[`@ohos.brightness`](js-apis-brightness.md)替代，替代接口能力仅对系统应用开放。 > - 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 diff --git a/zh-cn/application-dev/reference/errorcodes/errorcode-telephony.md b/zh-cn/application-dev/reference/errorcodes/errorcode-telephony.md index 0bedc18489..de54fa37a3 100644 --- a/zh-cn/application-dev/reference/errorcodes/errorcode-telephony.md +++ b/zh-cn/application-dev/reference/errorcodes/errorcode-telephony.md @@ -169,8 +169,8 @@ UT未连接 **可能原因** -当前运营商不支持从Wifi下发UT请求，但是当前手机Wifi已连上。 +当前运营商不支持从WIFI下发UT请求，但是当前设备WIFI已连上。 **处理步骤** -断开wifi，再重发UT请求。 +断开WIFI，再重发UT请求。 -- GitLab