Skip to content

D
Docs

OpenHarmony / Docs
大约 1 年 前同步成功

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

!19277 补充radio新增接口资料 

Merge pull request !19277 from Aurora/master
上级 78c09c04 4cb7a972
隐藏空白更改
内联 并排
Showing with 225 addition and 10 deletion
zh-cn/application-dev/reference/apis/js-apis-radio.md
浏览文件 @ c3406574
......@@ -1824,12 +1824,16 @@ promise.then(data => {
});
```
## radio.getNrOptionMode<sup>8+</sup>
## radio.getNrOptionMode<sup>(deprecated)</sup>
getNrOptionMode\(callback: AsyncCallback\<NrOptionMode\>\): void
获取Nr选项模式 。使用callback异步回调。
> **说明：**
>
> 从 API version 8开始支持，从API version 10开始废弃。建议使用[getNROptionMode](#radiogetnroptionmode10)替代。
**系统接口：** 此接口为系统接口。
**系统能力**：SystemCapability.Telephony.CoreService
......@@ -1838,7 +1842,7 @@ getNrOptionMode\(callback: AsyncCallback\<NrOptionMode\>\): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------------------- | ---- | ---------- |
| callback | AsyncCallback\<[NrOptionMode](#nroptionmode8)\> | 是 | 回调函数。 |
| callback | AsyncCallback\<[NrOptionMode](#nroptionmodedeprecated)\> | 是 | 回调函数。 |
**错误码：**
......@@ -1862,12 +1866,16 @@ radio.getNrOptionMode((err, data) => {
```
## radio.getNrOptionMode<sup>8+</sup>
## radio.getNrOptionMode<sup>(deprecated)</sup>
getNrOptionMode\(slotId: number, callback: AsyncCallback\<NrOptionMode\>\): void
获取Nr选项模式 。使用callback异步回调。
> **说明：**
>
> 从 API version 8开始支持，从API version 10开始废弃。建议使用[getNROptionMode](#radiogetnroptionmode10)替代。
**系统接口：** 此接口为系统接口。
**系统能力**：SystemCapability.Telephony.CoreService
......@@ -1875,9 +1883,9 @@ getNrOptionMode\(slotId: number, callback: AsyncCallback\<NrOptionMode\>\): void
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------------------- | ---- | -------------------------------------- |
| -------- | ----------------------------------------------- | ---- | ------------------------------------- |
| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 |
| callback | AsyncCallback\<[NrOptionMode](#nroptionmode8)\> | 是 | 回调函数。 |
| callback | AsyncCallback\<[NrOptionMode](#nroptionmodedeprecated)\> | 是 | 回调函数。 |
**错误码：**
......@@ -1902,12 +1910,16 @@ radio.getNrOptionMode(slotId, (err, data) => {
```
## radio.getNrOptionMode<sup>8+</sup>
## radio.getNrOptionMode<sup>(deprecated)</sup>
getNrOptionMode\(slotId?: number\): Promise\<NrOptionMode\>
获取Nr选项模式 。使用Promise异步回调。
> **说明：**
>
> 从 API version 8开始支持，从API version 10开始废弃。建议使用[getNROptionMode](#radiogetnroptionmode10)替代。
**系统接口：** 此接口为系统接口。
**系统能力**：SystemCapability.Telephony.CoreService
......@@ -1920,9 +1932,9 @@ getNrOptionMode\(slotId?: number\): Promise\<NrOptionMode\>
**返回值：**
| 类型 | 说明 |
| ----------------------------------------- | ----------------------- |
| Promise\<[NrOptionMode](#nroptionmode8)\> | 以Promise形式返回结果。 |
| 类型 | 说明 |
| -------------------------------------------------- | ----------------------- |
| Promise\<[NrOptionMode](#nroptionmodedeprecated)\> | 以Promise形式返回结果。 |
**错误码：**
......@@ -2671,6 +2683,190 @@ promise.then(data => {
```
## radio.setNROptionMode<sup>10+</sup>
setNROptionMode\(slotId: number, mode: NROptionMode, callback: AsyncCallback\<void\>\): void
设置Nr选项模式 。使用callback异步回调。
**系统接口：** 此接口为系统接口。
**需要权限**：ohos.permission.SET_TELEPHONY_STATE
**系统能力**：SystemCapability.Telephony.CoreService
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------ | ---- | -------------------------------------- |
| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 |
| mode | [NROptionMode](#nroptionmode10) | 是 | NR的选择模式。 |
| callback | AsyncCallback\<void\> | 是 | 回调函数。 |
**错误码：**
以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。
| 错误码ID | 错误信息 |
| -------- | -------------------------------------------- |
| 201 | Permission denied. |
| 202 | Non-system applications use system APIs. |
| 401 | Parameter error. |
| 8300001 | Invalid parameter value. |
| 8300002 | Operation failed. Cannot connect to service. |
| 8300003 | System internal error. |
| 8300999 | Unknown error code. |
**示例：**
```js
let slotId = 0;
radio.setNROptionMode(slotId, 1, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## radio.setNROptionMode<sup>10+</sup>
setNROptionMode\(slotId: number, mode: NROptionMode\): Promise\<void\>
设置Nr选项模式 。使用Promise异步回调。
**系统接口：** 此接口为系统接口。
**需要权限**：ohos.permission.SET_TELEPHONY_STATE
**系统能力**：SystemCapability.Telephony.CoreService
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------------------------------- | ---- | ------------------------------------- |
| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 |
| mode | [NROptionMode](#nroptionmode10) | 是 | NR的选择模式。 |
**返回值：**
| 类型 | 说明 |
| ----------------- | ----------------------- |
| Promise\<void\> | 以Promise形式返回结果。 |
**错误码：**
以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。
| 错误码ID | 错误信息 |
| -------- | -------------------------------------------- |
| 201 | Permission denied. |
| 202 | Non-system applications use system APIs. |
| 401 | Parameter error. |
| 8300001 | Invalid parameter value. |
| 8300002 | Operation failed. Cannot connect to service. |
| 8300003 | System internal error. |
| 8300999 | Unknown error code. |
**示例：**
```js
let slotId = 0;
let promise = radio.setNROptionMode(slotId, 1);
promise.then(data => {
console.log(`setNROptionMode success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.error(`setNROptionMode failed, promise: err->${JSON.stringify(err)}`);
});
```
## radio.getNROptionMode<sup>10+</sup>
getNROptionMode\(slotId: number, callback: AsyncCallback\<NROptionMode\>\): void
获取Nr选项模式 。使用callback异步回调。
**系统接口：** 此接口为系统接口。
**系统能力**：SystemCapability.Telephony.CoreService
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------ | ---- | -------------------------------------- |
| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 |
| callback | AsyncCallback\<[NROptionMode](#nroptionmode10)\> | 是 | 回调函数。 |
**错误码：**
以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。
| 错误码ID | 错误信息 |
| -------- | -------------------------------------------- |
| 202 | Non-system applications use system APIs. |
| 401 | Parameter error. |
| 8300001 | Invalid parameter value. |
| 8300002 | Operation failed. Cannot connect to service. |
| 8300003 | System internal error. |
| 8300999 | Unknown error code. |
**示例：**
```js
let slotId = 0;
radio.getNROptionMode(slotId, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## radio.getNROptionMode<sup>10+</sup>
getNROptionMode\(slotId: number\): Promise\<NROptionMode\>
获取Nr选项模式 。使用Promise异步回调。
**系统接口：** 此接口为系统接口。
**系统能力**：SystemCapability.Telephony.CoreService
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------------------------------------- |
| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 |
**返回值：**
| 类型 | 说明 |
| ----------------------------------------- | ----------------------- |
| Promise\<[NROptionMode](#nroptionmode10)\> | 以Promise形式返回结果。 |
**错误码：**
以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。
| 错误码ID | 错误信息 |
| -------- | -------------------------------------------- |
| 202 | Non-system applications use system APIs. |
| 401 | Parameter error. |
| 8300001 | Invalid parameter value. |
| 8300002 | Operation failed. Cannot connect to service. |
| 8300003 | System internal error. |
| 8300999 | Unknown error code. |
**示例：**
```js
let slotId = 0;
let promise = radio.getNROptionMode(slotId);
promise.then(data => {
console.log(`getNROptionMode success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.error(`getNROptionMode failed, promise: err->${JSON.stringify(err)}`);
});
```
## RadioTechnology
无线接入技术。
......@@ -2947,10 +3143,14 @@ WCDMA小区信息。
| mcc | string | 是 | 移动国家码。 |
| mnc | string | 是 | 移动网号。 |
## NrOptionMode<sup>8+</sup>
## NrOptionMode<sup>(deprecated)</sup>
NR的选择模式。
> **说明：**
>
> 从 API version 8开始支持，从API version 10开始废弃。建议使用[NROptionMode](#nroptionmode10)替代。
**系统接口：** 此接口为系统接口。
**系统能力**：SystemCapability.Telephony.CoreService
......@@ -2962,6 +3162,21 @@ NR的选择模式。
| NR_OPTION_SA_ONLY | 2 | 仅独立组网的NR选择模式。 |
| NR_OPTION_NSA_AND_SA | 3 | 非独立组网和独立组网的NR选择模式。 |
## NROptionMode<sup>10+</sup>
NR的选择模式。
**系统接口：** 此接口为系统接口。
**系统能力**：SystemCapability.Telephony.CoreService
| 名称 | 值 | 说明 |
| -------------------- | ---- | --------------------------------- |
| NR_OPTION_UNKNOWN | 0 | 未知的NR选择模式。 |
| NR_OPTION_NSA_ONLY | 1 | 仅非独立组网的NR选择模式。 |
| NR_OPTION_SA_ONLY | 2 | 仅独立组网的NR选择模式。 |
| NR_OPTION_NSA_AND_SA | 3 | 非独立组网和独立组网的NR选择模式。 |
## NetworkSearchResult
网络搜索结果。
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或