提交 b7b78de4 编写于 作者: Y YOUR_NAME

add interface

Signed-off-by: Nliujiandong <liujiandong1@huawei.com>
上级 361662f9
......@@ -19,6 +19,8 @@ getRadioTech\(slotId: number, callback: AsyncCallback<\{psRadioTech: RadioTechno
需要ohos.permission.GET\_NETWORK\_INFO权限。
**系统能力**:SystemCapability.Telephony.CoreService
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
......@@ -44,6 +46,8 @@ getRadioTech\(slotId: number\): Promise<\{psRadioTech: RadioTechnology, csRadioT
需要ohos.permission.GET\_NETWORK\_INFO权限。
**系统能力**:SystemCapability.Telephony.CoreService
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
......@@ -77,6 +81,8 @@ getNetworkState\(callback: AsyncCallback<NetworkState\>\): void
需要ohos.permission.GET\_NETWORK\_INFO权限。
**系统能力**:SystemCapability.Telephony.CoreService
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
......@@ -100,6 +106,8 @@ getNetworkState\(slotId: number, callback: AsyncCallback<NetworkState\>\): void
需要ohos.permission.GET\_NETWORK\_INFO权限。
**系统能力**:SystemCapability.Telephony.CoreService
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
......@@ -125,6 +133,8 @@ getNetworkState\(slotId?: number\): Promise<NetworkState\>
需要ohos.permission.GET\_NETWORK\_INFO权限。
**系统能力**:SystemCapability.Telephony.CoreService
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
......@@ -156,6 +166,8 @@ getNetworkSelectionMode\(slotId: number, callback: AsyncCallback<NetworkSelectio
获取当前选网模式,使用callback方式作为异步方法。
**系统能力**:SystemCapability.Telephony.CoreService
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
......@@ -179,6 +191,8 @@ getNetworkSelectionMode\(slotId: number\): Promise<NetworkSelectionMode\>
获取当前选网模式,使用Promise方式作为异步方法。
**系统能力**:SystemCapability.Telephony.CoreService
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
......@@ -210,6 +224,8 @@ getISOCountryCodeForNetwork\(slotId: number, callback: AsyncCallback<string\>\):
获取注册网络所在国家的ISO国家码,使用callback方式作为异步方法。
**系统能力**:SystemCapability.Telephony.CoreService
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
......@@ -233,6 +249,8 @@ getISOCountryCodeForNetwork\(slotId: number\): Promise<string\>
获取注册网络所在国家的ISO国家码,使用Promise方式作为异步方法。
**系统能力**:SystemCapability.Telephony.CoreService
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
......@@ -264,6 +282,8 @@ getSignalInformation\(slotId: number, callback: AsyncCallback<Array<SignalInform
获取指定SIM卡槽对应的注册网络信号强度信息列表,使用callback方式作为异步方法。
**系统能力**:SystemCapability.Telephony.CoreService
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
......@@ -287,6 +307,8 @@ getSignalInformation\(slotId: number\): Promise<Array<SignalInformation\>\>
获取指定SIM卡槽对应的注册网络信号强度信息列表,使用Promise方式作为异步方法。
**系统能力**:SystemCapability.Telephony.CoreService
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
......@@ -320,6 +342,8 @@ isRadioOn\(callback: AsyncCallback<boolean\>\): void
需要ohos.permission.GET\_NETWORK\_INFO权限。
**系统能力**:SystemCapability.Telephony.CoreService
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
......@@ -343,6 +367,8 @@ isRadioOn\(\): Promise<boolean\>
需要ohos.permission.GET\_NETWORK\_INFO权限。
**系统能力**:SystemCapability.Telephony.CoreService
**返回值:**
| 类型 | 说明 |
......@@ -361,35 +387,93 @@ promise.then(data => {
```
## radio.getOperatorName<sup>7+</sup><a name=radio.getOperatorName-callback></a>
getOperatorName\(slotId: number, callback: AsyncCallback<string\>\): void
获取运营商名称,使用callback方式作为异步方法。
**系统能力**:SystemCapability.Telephony.CoreService
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------- | ---- | ------------------------------------------ |
| slotId | number | 是 | 卡槽ID。<br/>- 0:卡槽1<br/>- 1:卡槽2 |
| callback | AsyncCallback\<string\> | 是 | 回调函数。返回运营商名称,例如:中国移动。 |
**示例:**
```
let slotId = 0;
radio.getOperatorName(slotId, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## radio.getOperatorName<sup>7+</sup><a name=radio.getOperatorName-promise></a>
getOperatorName\(slotId: number\): Promise<string\>
获取运营商名称,使用Promise方式作为异步方法。
**系统能力**:SystemCapability.Telephony.CoreService
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | -------------------------------------- |
| slotId | number | 是 | 卡槽ID。<br/>- 0:卡槽1<br/>- 1:卡槽2 |
**返回值:**
| 类型 | 说明 |
| ----------------- | ------------------------------------------------------------ |
| Promise\<string\> | 以Promise形式返回运营商名称,例如:中国移动。 |
**示例:**
```
let slotId = 0;
let promise = radio.getOperatorName(slotId);
promise.then(data => {
console.log(`getOperatorName success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.log(`getOperatorName fail, promise: err->${JSON.stringify(err)}`);
});
```
## RadioTechnology<a name=RadioTechnology></a>
无线接入技术。
| 变量 | 值 | 说明 |
| ------------------------- | ---- | ------------------------------------------------------------ |
| RADIO_TECHNOLOGY_UNKNOWN | 0 | 未知无线接入技术(RAT)。 |
| RADIO_TECHNOLOGY_GSM | 1 | 无线接入技术GSM(Global System For Mobile Communication)。 |
| RADIO_TECHNOLOGY_1XRTT | 2 | 无线接入技术1XRTT(Single-Carrier Radio Transmission Technology)。 |
| RADIO_TECHNOLOGY_WCDMA | 3 | 无线接入技术WCDMA(Wideband Code Division Multiple Access)。 |
| RADIO_TECHNOLOGY_HSPA | 4 | 无线接入技术HSPA(High Speed Packet Access)。 |
| RADIO_TECHNOLOGY_HSPAP | 5 | 无线接入技术HSPAP(High Speed packet access (HSPA+) )。 |
| RADIO_TECHNOLOGY_TD_SCDMA | 6 | 无线接入技术TDSCDMA(TimeDivision-Synchronous Code Division Multiple Access)。 |
| RADIO_TECHNOLOGY_EVDO | 7 | 无线接入技术EVDO(Evolution、Data Only)。 |
| RADIO_TECHNOLOGY_EHRPD | 8 | 无线接入技术EHRPD(Evolved High Rate Package Data)。 |
| RADIO_TECHNOLOGY_LTE | 9 | 无线接入技术LTE(Long Term Evolution)。 |
| RADIO_TECHNOLOGY_LTE_CA | 10 | 无线接入技术LTE_CA(Long Term Evolution_Carrier Aggregation)。 |
| RADIO_TECHNOLOGY_IWLAN | 11 | 无线接入技术IWLAN(Industrial Wireless LAN)。 |
| RADIO_TECHNOLOGY_NR | 12 | 无线接入技术NR(New Radio)。 |
| RADIO_TECHNOLOGY_UNKNOWN | 0 | 未知无线接入技术(RAT)。<br>**系统能力**:SystemCapability.Telephony.CoreService |
| RADIO_TECHNOLOGY_GSM | 1 | 无线接入技术GSM(Global System For Mobile Communication)。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| RADIO_TECHNOLOGY_1XRTT | 2 | 无线接入技术1XRTT(Single-Carrier Radio Transmission Technology)。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| RADIO_TECHNOLOGY_WCDMA | 3 | 无线接入技术WCDMA(Wideband Code Division Multiple Access)。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| RADIO_TECHNOLOGY_HSPA | 4 | 无线接入技术HSPA(High Speed Packet Access)。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| RADIO_TECHNOLOGY_HSPAP | 5 | 无线接入技术HSPAP(High Speed packet access (HSPA+) )。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| RADIO_TECHNOLOGY_TD_SCDMA | 6 | 无线接入技术TDSCDMA(TimeDivision-Synchronous Code Division Multiple Access)。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| RADIO_TECHNOLOGY_EVDO | 7 | 无线接入技术EVDO(Evolution、Data Only)。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| RADIO_TECHNOLOGY_EHRPD | 8 | 无线接入技术EHRPD(Evolved High Rate Package Data)。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| RADIO_TECHNOLOGY_LTE | 9 | 无线接入技术LTE(Long Term Evolution)。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| RADIO_TECHNOLOGY_LTE_CA | 10 | 无线接入技术LTE_CA(Long Term Evolution_Carrier Aggregation)。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| RADIO_TECHNOLOGY_IWLAN | 11 | 无线接入技术IWLAN(Industrial Wireless LAN)。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| RADIO_TECHNOLOGY_NR | 12 | 无线接入技术NR(New Radio)。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
## SignalInformation<a name=SignalInformation></a>
网络信号强度信息对象。
| 属性名 | 类型 | 说明 |
| ----------- | --------------------------- | ------------------ |
| signalType | [NetworkType](#NetworkType) | 网络信号强度类型。 |
| signalLevel | number | 网络信号强度等级。 |
| 属性名 | 类型 | 说明 |
| ----------- | --------------------------- | ------------------------------------------------------------ |
| signalType | [NetworkType](#NetworkType) | 网络信号强度类型。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| signalLevel | number | 网络信号强度等级。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
## NetworkType<a name=NetworkType></a>
......@@ -398,62 +482,63 @@ promise.then(data => {
| 变量 | 值 | 说明 |
| -------------------- | ---- | ------------------------------------------------------------ |
| NETWORK_TYPE_UNKNOWN | 0 | 未知网络类型。 |
| NETWORK_TYPE_GSM | 1 | 网络类型为GSM(Global System For Mobile Communication)。 |
| NETWORK_TYPE_CDMA | 2 | 网络类型为CDMA(Code Division Multiple Access)。 |
| NETWORK_TYPE_WCDMA | 3 | 网络类型为WCDMA(Wideband Code Division Multiple Access)。 |
| NETWORK_TYPE_TDSCDMA | 4 | 网络类型为TDSCDMA(TimeDivision-Synchronous Code Division Multiple Access)。 |
| NETWORK_TYPE_LTE | 5 | 网络类型为LTE(Long Term Evolution)。 |
| NETWORK_TYPE_NR | 6 | 网络类型为5G NR(New Radio)。 |
| NETWORK_TYPE_UNKNOWN | 0 | 未知网络类型。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| NETWORK_TYPE_GSM | 1 | 网络类型为GSM(Global System For Mobile Communication)。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| NETWORK_TYPE_CDMA | 2 | 网络类型为CDMA(Code Division Multiple Access)。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| NETWORK_TYPE_WCDMA | 3 | 网络类型为WCDMA(Wideband Code Division Multiple Access)。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| NETWORK_TYPE_TDSCDMA | 4 | 网络类型为TDSCDMA(TimeDivision-Synchronous Code Division Multiple Access)。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| NETWORK_TYPE_LTE | 5 | 网络类型为LTE(Long Term Evolution)。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| NETWORK_TYPE_NR | 6 | 网络类型为5G NR(New Radio)。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
## NetworkState<a name=NetworkState></a>
网络注册状态。
| 变量 | 类型 | 说明 |
| ----------------- | --------------------- | ------------------------------ |
| longOperatorName | string | 注册网络的长运营商名称。 |
| shortOperatorName | string | 注册网络的短运营商名称。 |
| plmnNumeric | string | 注册网络的PLMN码。 |
| isRoaming | boolean | 是否处于漫游状态。 |
| regState | [RegState](#RegState) | 设备的网络注册状态。 |
| nsaState | [NsaState](#NsaState) | 设备的NSA网络注册状态。 |
| isCaActive | boolean | CA的状态。 |
| isEmergency | boolean | 此设备是否只允许拨打紧急呼叫。 |
| 变量 | 类型 | 说明 |
| ----------------- | --------------------- | ------------------------------------------------------------ |
| longOperatorName | string | 注册网络的长运营商名称。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| shortOperatorName | string | 注册网络的短运营商名称。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| plmnNumeric | string | 注册网络的PLMN码。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| isRoaming | boolean | 是否处于漫游状态。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| regState | [RegState](#RegState) | 设备的网络注册状态。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| nsaState | [NsaState](#NsaState) | 设备的NSA网络注册状态。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| isCaActive | boolean | CA的状态。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| isEmergency | boolean | 此设备是否只允许拨打紧急呼叫。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
## RegState<a name=RegState></a>
网络注册状态。
| 变量 | 值 | 说明 |
| ----------------------------- | ---- | -------------------------- |
| REG_STATE_NO_SERVICE | 0 | 设备不能使用任何服务。 |
| REG_STATE_IN_SERVICE | 1 | 设备可以正常使用业务。 |
| REG_STATE_EMERGENCY_CALL_ONLY | 2 | 设备只能使用紧急呼叫业务。 |
| REG_STATE_POWER_OFF | 3 | 蜂窝无线电已关闭。 |
| 变量 | 值 | 说明 |
| ----------------------------- | ---- | ------------------------------------------------------------ |
| REG_STATE_NO_SERVICE | 0 | 设备不能使用任何服务。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| REG_STATE_IN_SERVICE | 1 | 设备可以正常使用业务。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| REG_STATE_EMERGENCY_CALL_ONLY | 2 | 设备只能使用紧急呼叫业务。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| REG_STATE_POWER_OFF | 3 | 蜂窝无线电已关闭。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
## NsaState<a name=NsaState></a>
非独立组网状态。
| 变量 | 值 | 说明 |
| -------------------------- | ---- | ---------------------------------------------------------- |
| NSA_STATE_NOT_SUPPORT | 1 | 设备在不支持NSA的LTE小区下处于空闲状态或连接状态。 |
| NSA_STATE_NO_DETECT | 2 | 在支持NSA但不支持NR覆盖检测的LTE小区下,设备处于空闲状态。 |
| NSA_STATE_CONNECTED_DETECT | 3 | 设备在LTE小区下连接到LTE网络支持NSA和NR覆盖检测。 |
| NSA_STATE_IDLE_DETECT | 4 | 支持NSA和NR覆盖检测的LTE小区下设备处于空闲状态。 |
| NSA_STATE_DUAL_CONNECTED | 5 | 设备在支持NSA的LTE小区下连接到LTE + NR网络。 |
| NSA_STATE_SA_ATTACHED | 6 | 设备在5GC附着时在NG-RAN小区下空闲或连接到NG-RAN小区。 |
| 变量 | 值 | 说明 |
| -------------------------- | ---- | ------------------------------------------------------------ |
| NSA_STATE_NOT_SUPPORT | 1 | 设备在不支持NSA的LTE小区下处于空闲状态或连接状态。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| NSA_STATE_NO_DETECT | 2 | 在支持NSA但不支持NR覆盖检测的LTE小区下,设备处于空闲状态。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| NSA_STATE_CONNECTED_DETECT | 3 | 设备在LTE小区下连接到LTE网络支持NSA和NR覆盖检测。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| NSA_STATE_IDLE_DETECT | 4 | 支持NSA和NR覆盖检测的LTE小区下设备处于空闲状态。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| NSA_STATE_DUAL_CONNECTED | 5 | 设备在支持NSA的LTE小区下连接到LTE + NR网络。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| NSA_STATE_SA_ATTACHED | 6 | 设备在5GC附着时在NG-RAN小区下空闲或连接到NG-RAN小区。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
## NetworkSelectionMode<a name=NetworkSelectionMode></a>
选网模式。
| 变量 | 值 | 说明 |
| --------------------------- | ---- | -------------- |
| NETWORK_SELECTION_UNKNOWN | 0 | 未知选网模式。 |
| NETWORK_SELECTION_AUTOMATIC | 1 | 自动选网模式。 |
| NETWORK_SELECTION_MANUAL | 2 | 手动选网模式。 |
\ No newline at end of file
| 变量 | 值 | 说明 |
| --------------------------- | ---- | ------------------------------------------------------------ |
| NETWORK_SELECTION_UNKNOWN | 0 | 未知选网模式。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| NETWORK_SELECTION_AUTOMATIC | 1 | 自动选网模式。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
| NETWORK_SELECTION_MANUAL | 2 | 手动选网模式。<br/>**系统能力**:SystemCapability.Telephony.CoreService |
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册