You need to sign in or sign up before continuing.
提交 bbeea70d 编写于 作者: Z zengyawen

update docs

Signed-off-by: Nzengyawen <zengyawen1@huawei.com>
上级 9a9e637f
...@@ -1110,7 +1110,7 @@ setVolume(volumeType: AudioVolumeType, volume: number, callback: AsyncCallback&l ...@@ -1110,7 +1110,7 @@ setVolume(volumeType: AudioVolumeType, volume: number, callback: AsyncCallback&l
设置指定流的音量,使用callback方式异步返回结果。 设置指定流的音量,使用callback方式异步返回结果。
> **说明:** > **说明:**
> 从 API version 7 开始支持,从 API version 9 开始废弃,建议使用AudioVolumeGroupManager中的[setVolume](#setvolume9)替代 > 从 API version 7 开始支持,从 API version 9 开始废弃。建议使用AudioVolumeGroupManager中的[setVolume](#setvolume9)替代,替代接口能力仅对系统应用开放
**需要权限:** ohos.permission.ACCESS_NOTIFICATION_POLICY **需要权限:** ohos.permission.ACCESS_NOTIFICATION_POLICY
...@@ -1145,7 +1145,7 @@ setVolume(volumeType: AudioVolumeType, volume: number): Promise&lt;void&gt; ...@@ -1145,7 +1145,7 @@ setVolume(volumeType: AudioVolumeType, volume: number): Promise&lt;void&gt;
设置指定流的音量,使用Promise方式异步返回结果。 设置指定流的音量,使用Promise方式异步返回结果。
> **说明:** > **说明:**
> 从 API version 7 开始支持,从 API version 9 开始废弃,建议使用AudioVolumeGroupManager中的[setVolume](#setvolume9)替代 > 从 API version 7 开始支持,从 API version 9 开始废弃。建议使用AudioVolumeGroupManager中的[setVolume](#setvolume9)替代,替代接口能力仅对系统应用开放
**需要权限:** ohos.permission.ACCESS_NOTIFICATION_POLICY **需要权限:** ohos.permission.ACCESS_NOTIFICATION_POLICY
...@@ -1364,7 +1364,7 @@ mute(volumeType: AudioVolumeType, mute: boolean, callback: AsyncCallback&lt;void ...@@ -1364,7 +1364,7 @@ mute(volumeType: AudioVolumeType, mute: boolean, callback: AsyncCallback&lt;void
设置指定音量流静音,使用callback方式异步返回结果。 设置指定音量流静音,使用callback方式异步返回结果。
> **说明:** > **说明:**
> 从 API version 7 开始支持,从 API version 9 开始废弃,建议使用AudioVolumeGroupManager中的[mute](#mute9)替代 > 从 API version 7 开始支持,从 API version 9 开始废弃。建议使用AudioVolumeGroupManager中的[mute](#mute9)替代,替代接口能力仅对系统应用开放
**系统能力:** SystemCapability.Multimedia.Audio.Volume **系统能力:** SystemCapability.Multimedia.Audio.Volume
...@@ -1395,7 +1395,7 @@ mute(volumeType: AudioVolumeType, mute: boolean): Promise&lt;void&gt; ...@@ -1395,7 +1395,7 @@ mute(volumeType: AudioVolumeType, mute: boolean): Promise&lt;void&gt;
设置指定音量流静音,使用Promise方式异步返回结果。 设置指定音量流静音,使用Promise方式异步返回结果。
> **说明:** > **说明:**
> 从 API version 7 开始支持,从 API version 9 开始废弃,建议使用AudioVolumeGroupManager中的[mute](#mute9)替代 > 从 API version 7 开始支持,从 API version 9 开始废弃。建议使用AudioVolumeGroupManager中的[mute](#mute9)替代,替代接口能力仅对系统应用开放
**系统能力:** SystemCapability.Multimedia.Audio.Volume **系统能力:** SystemCapability.Multimedia.Audio.Volume
...@@ -1550,7 +1550,7 @@ setRingerMode(mode: AudioRingMode, callback: AsyncCallback&lt;void&gt;): void ...@@ -1550,7 +1550,7 @@ setRingerMode(mode: AudioRingMode, callback: AsyncCallback&lt;void&gt;): void
设置铃声模式,使用callback方式异步返回结果。 设置铃声模式,使用callback方式异步返回结果。
> **说明:** > **说明:**
> 从 API version 7 开始支持,从 API version 9 开始废弃,建议使用AudioVolumeGroupManager中的[setRingerMode](#setringermode9)替代 > 从 API version 7 开始支持,从 API version 9 开始废弃。建议使用AudioVolumeGroupManager中的[setRingerMode](#setringermode9)替代,替代接口能力仅对系统应用开放
**需要权限:** ohos.permission.ACCESS_NOTIFICATION_POLICY **需要权限:** ohos.permission.ACCESS_NOTIFICATION_POLICY
...@@ -1584,7 +1584,8 @@ setRingerMode(mode: AudioRingMode): Promise&lt;void&gt; ...@@ -1584,7 +1584,8 @@ setRingerMode(mode: AudioRingMode): Promise&lt;void&gt;
设置铃声模式,使用Promise方式异步返回结果。 设置铃声模式,使用Promise方式异步返回结果。
> **说明:** > **说明:**
> 从 API version 7 开始支持,从 API version 9 开始废弃,建议使用AudioVolumeGroupManager中的[setRingerMode](#setringermode9)替代。 > 从 API version 7 开始支持,从 API version 9 开始废弃。建议使用AudioVolumeGroupManager中的[setRingerMode](#setringermode9)替代,替代接口能力仅对系统应用开放。
**需要权限:** ohos.permission.ACCESS_NOTIFICATION_POLICY **需要权限:** ohos.permission.ACCESS_NOTIFICATION_POLICY
......
...@@ -14,110 +14,6 @@ ...@@ -14,110 +14,6 @@
import call from '@ohos.telephony.call'; import call from '@ohos.telephony.call';
``` ```
## call.dial<sup>(deprecated)</sup>
dial\(phoneNumber: string, callback: AsyncCallback<boolean\>\): void
拨打电话。使用callback异步回调。
>**说明:**
>
>从API version 6 开始支持,从API version 9 开始废弃,建议使用[dialCall](#calldialcall9)替代。
**需要权限**:ohos.permission.PLACE_CALL
**系统能力**:SystemCapability.Telephony.CallManager
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ---------------------------- | ---- | --------------------------------------- |
| phoneNumber | string | 是 | 电话号码。 |
| callback | AsyncCallback&lt;boolean&gt; | 是 | 回调函数,返回true为成功,false为失败。 |
**示例:**
```js
call.dial("138xxxxxxxx", (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## call.dial<sup>(deprecated)</sup>
dial\(phoneNumber: string, options: DialOptions, callback: AsyncCallback<boolean\>\): void
拨打电话,可设置通话参数。使用callback异步回调。
>**说明:**
>
>从API version 6 开始支持,从API version 9 开始废弃,建议使用[dialCall](#calldialcall9)替代。
**需要权限**:ohos.permission.PLACE_CALL
**系统能力**:SystemCapability.Telephony.CallManager
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ---------------------------- | ---- | --------------------------------------- |
| phoneNumber | string | 是 | 电话号码。 |
| options | [DialOptions](#dialoptions) | 是 | 通话参数,选择为语音通话还是视频通话。 |
| callback | AsyncCallback&lt;boolean&gt; | 是 | 回调函数,返回true为成功,false为失败。 |
**示例:**
```js
call.dial("138xxxxxxxx", {
extras: false
}, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## call.dial<sup>(deprecated)</sup>
dial\(phoneNumber: string, options?: DialOptions\): Promise<boolean\>
拨打电话,可设置通话参数。使用Promise异步回调。
>**说明:**
>
>从API version 6 开始支持,从API version 9 开始废弃,建议使用[dialCall](#calldialcall9)替代。
**需要权限**:ohos.permission.PLACE_CALL
**系统能力**:SystemCapability.Telephony.CallManager
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | --------------------------- | ---- | -------------------------------------- |
| phoneNumber | string | 是 | 电话号码。 |
| options | [DialOptions](#dialoptions) | 否 | 通话参数,选择为语音通话还是视频通话。 |
**返回值:**
| 类型 | 说明 |
| ---------------------- | ------------------------------------------------------------ |
| Promise&lt;boolean&gt; | 以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.dialCall<sup>9+</sup> ## call.dialCall<sup>9+</sup>
dialCall\(phoneNumber: string, callback: AsyncCallback<void\>\): void dialCall\(phoneNumber: string, callback: AsyncCallback<void\>\): void
...@@ -260,6 +156,107 @@ promise.then(() => { ...@@ -260,6 +156,107 @@ promise.then(() => {
}); });
``` ```
## call.dial<sup>(deprecated)</sup>
dial\(phoneNumber: string, callback: AsyncCallback<boolean\>\): void
拨打电话。使用callback异步回调。
> **说明:**
>
> 从API version 6 开始支持,从API version 9 开始废弃。请使用[dialCall](#calldialcall9)替代,替代接口能力仅对系统应用开放。
**需要权限**:ohos.permission.PLACE_CALL
**系统能力**:SystemCapability.Telephony.CallManager
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ---------------------------- | ---- | --------------------------------------- |
| phoneNumber | string | 是 | 电话号码。 |
| callback | AsyncCallback&lt;boolean&gt; | 是 | 回调函数,返回true为成功,false为失败。 |
**示例:**
```js
call.dial("138xxxxxxxx", (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## call.dial<sup>(deprecated)</sup>
dial\(phoneNumber: string, options: DialOptions, callback: AsyncCallback<boolean\>\): void
拨打电话,可设置通话参数。使用callback异步回调。
> **说明:**
>
> 从API version 6 开始支持,从API version 9 开始废弃。请使用[dialCall](#calldialcall9)替代,替代接口能力仅对系统应用开放。
**需要权限**:ohos.permission.PLACE_CALL
**系统能力**:SystemCapability.Telephony.CallManager
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | ---------------------------- | ---- | --------------------------------------- |
| phoneNumber | string | 是 | 电话号码。 |
| options | [DialOptions](#dialoptions) | 是 | 通话参数,选择为语音通话还是视频通话。 |
| callback | AsyncCallback&lt;boolean&gt; | 是 | 回调函数,返回true为成功,false为失败。 |
**示例:**
```js
call.dial("138xxxxxxxx", {
extras: false
}, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## call.dial<sup>(deprecated)</sup>
dial\(phoneNumber: string, options?: DialOptions\): Promise<boolean\>
拨打电话,可设置通话参数。使用Promise异步回调。
> **说明:**
>
> 从API version 6 开始支持,从API version 9 开始废弃。请使用[dialCall](#calldialcall9)替代,替代接口能力仅对系统应用开放。
**需要权限**:ohos.permission.PLACE_CALL
**系统能力**:SystemCapability.Telephony.CallManager
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ----------- | --------------------------- | ---- | -------------------------------------- |
| phoneNumber | string | 是 | 电话号码。 |
| options | [DialOptions](#dialoptions) | 否 | 通话参数,选择为语音通话还是视频通话。 |
**返回值:**
| 类型 | 说明 |
| ---------------------- | ------------------------------------------------------------ |
| Promise&lt;boolean&gt; | 以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.makeCall<sup>7+</sup> ## call.makeCall<sup>7+</sup>
......
...@@ -293,7 +293,7 @@ power.setPowerMode(power.DevicePowerMode.MODE_PERFORMANCE) ...@@ -293,7 +293,7 @@ power.setPowerMode(power.DevicePowerMode.MODE_PERFORMANCE)
rebootDevice(reason: string): void rebootDevice(reason: string): void
> **说明:**<br>从API version 9开始不再维护,建议使用[power.reboot](#powerreboot9)替代 > **说明:**<br>从API version 7开始支持,从API version 9开始不再维护。建议使用[power.reboot](#powerreboot9)替代,替代接口能力仅对系统应用开放
重启设备。 重启设备。
......
...@@ -3,7 +3,8 @@ ...@@ -3,7 +3,8 @@
该模块提供屏幕亮度和模式的查询、调节接口。 该模块提供屏幕亮度和模式的查询、调节接口。
> **说明:** > **说明:**
> - 从API Version 7 开始不再维护,建议使用[`@ohos.brightness`](js-apis-brightness.md)替代。 >
> - 从API Version 7 开始不再维护。建议使用[`@ohos.brightness`](js-apis-brightness.md)替代,替代接口能力仅对系统应用开放。
> - 本模块首批接口从API version 3开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > - 本模块首批接口从API version 3开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册