# 网络搜索 - [导入模块](#s56d19203690d4782bfc74069abb6bd71) - [radio.getRadioTech](#section18401172810207) - [radio.getRadioTech](#section686385662419) - [radio.getNetworkState](#section2090641619263) - [radio.getNetworkState](#section392520433402) - [radio.getNetworkState](#section20661545182918) - [radio.getNetworkSelectionMode](#section79561056114711) - [radio.getNetworkSelectionMode](#section553074612507) - [radio.getISOCountryCodeForNetwork7+](#section16183194320525) - [radio.getISOCountryCodeForNetwork7+](#section56144132559) - [radio.getSignalInformation](#section1153532721018) - [radio.getSignalInformation](#section1859512161511) - [radio.isRadioOn7+](#section5456161711228) - [radio.isRadioOn7+](#section178817520243) - [RadioTechnology](#section1072135204020) - [SignalInformation](#section10701756164212) - [NetworkType](#section519718112466) - [NetworkState](#section1691213911470) - [RegState](#section18174131911514) - [NsaState](#section448018155317) - [NetworkSelectionMode](#section14219361268) >**说明：** > >标记7+的表示从API Version 7开始支持，未标记的表示从API Version 6开始支持。 ## 导入模块 ``` import radio from '@ohos.telephony.radio' ``` ## radio.getRadioTech getRadioTech\(slotId: number, callback: AsyncCallback<\{psRadioTech: RadioTechnology, csRadioTech: RadioTechnology\}\>\): void 获取当前接入的CS域和PS域无线接入技术，使用callback方式作为异步方法。 需要ohos.permission.GET\_NETWORK\_INFO权限。 - 参数

参数名

类型

必填

说明

slotId

number

是

卡槽ID。

0：卡槽1

1：卡槽2

callback

AsyncCallback<{psRadioTech: RadioTechnology, csRadioTech: RadioTechnology}>

是

回调函数。
- 示例 ``` let slotId = 0; radio.getRadioTech(slotId, (err, data) =>{ console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); }); ``` ## radio.getRadioTech getRadioTech\(slotId: number\): Promise<\{psRadioTech: RadioTechnology, csRadioTech: RadioTechnology\}\> 获取当前接入的CS域和PS域无线接入技术，使用Promise方式作为异步方法。 需要ohos.permission.GET\_NETWORK\_INFO权限。 - 参数

参数名

类型

必填

说明

slotId

number

是

卡槽ID。

0：卡槽1

1：卡槽2
- 返回值

类型

说明

Promise<{psRadioTech: RadioTechnology, csRadioTech: RadioTechnology}>

以Promise形式返回获取当前接入的CS域和PS域技术。
- 示例 ``` let slotId = 0; let promise = radio.getRadioTech(slotId); promise.then(data => { console.log(`getRadioTech success, data->${JSON.stringify(data)}`); }).catch(err => { console.log(`getRadioTech fail, err->${JSON.stringify(err)}`); }); ``` ## radio.getNetworkState getNetworkState\(callback: AsyncCallback\): void 获取网络状态，使用callback方式作为异步方法。 需要ohos.permission.GET\_NETWORK\_INFO权限。 - 参数

参数名

类型

必填

说明

callback

AsyncCallback<NetworkState>

是

回调函数。
- 示例 ``` radio.getNetworkState((err, data) =>{ console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); }); ``` ## radio.getNetworkState getNetworkState\(slotId: number, callback: AsyncCallback\): void 获取网络状态，使用callback方式作为异步方法。 需要ohos.permission.GET\_NETWORK\_INFO权限。 - 参数

参数名

类型

必填

说明

slotId

number

是

卡槽ID。

0：卡槽1

1：卡槽2

callback

AsyncCallback<NetworkState>

是

回调函数。
- 示例 ``` let slotId = 0; radio.getNetworkState(slotId, (err, data) => { console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); }); ``` ## radio.getNetworkState getNetworkState\(slotId?: number\): Promise 获取网络状态，使用Promise方式作为异步方法。 需要ohos.permission.GET\_NETWORK\_INFO权限。 - 参数

参数名

类型

必填

说明

slotId

number

否

卡槽ID。

0：卡槽1

1：卡槽2
- 返回值

类型

说明

Promise<NetworkState>

以Promise形式返回网络状态。
- 示例 ``` let slotId = 0; let promise = radio.getNetworkState(slotId); promise.then(data => { console.log(`getNetworkState success, promise: data->${JSON.stringify(data)}`); }).catch(err => { console.log(`getNetworkState fail, promise: err->${JSON.stringify(err)}`); }); ``` ## radio.getNetworkSelectionMode getNetworkSelectionMode\(slotId: number, callback: AsyncCallback\): void 获取当前选网模式，使用callback方式作为异步方法。 - 参数

参数名

类型

必填

说明

slotId

number

是

卡槽ID。

0：卡槽1

1：卡槽2

callback

AsyncCallback<NetworkSelectionMode>

是

回调函数。
- 示例 ``` let slotId = 0; radio.getNetworkSelectionMode(slotId, (err, data) => { console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); }); ``` ## radio.getNetworkSelectionMode getNetworkSelectionMode\(slotId: number\): Promise 获取当前选网模式，使用Promise方式作为异步方法。 - 参数

参数名

类型

必填

说明

slotId

number

是

卡槽ID。

0：卡槽1

1：卡槽2
- 返回值

类型

说明

Promise<NetworkSelectionMode>

以Promise形式返回当前选网模式。
- 示例 ``` let slotId = 0; let promise = radio.getNetworkSelectionMode(slotId); promise.then(data => { console.log(`getNetworkSelectionMode success, promise: data->${JSON.stringify(data)}`); }).catch(err => { console.log(`getNetworkSelectionMode fail, promise: err->${JSON.stringify(err)}`); }); ``` ## radio.getISOCountryCodeForNetwork7+ getISOCountryCodeForNetwork\(slotId: number, callback: AsyncCallback\): void 获取注册网络所在国家的ISO国家码，使用callback方式作为异步方法。 - 参数

参数名

类型

必填

说明

slotId

number

是

卡槽ID。

0：卡槽1

1：卡槽2

callback

AsyncCallback<string>

是

回调函数。返回国家码，例如：CN（中国）。
- 示例 ``` let slotId = 0; radio.getISOCountryCodeForNetwork(slotId, (err, data) => { console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); }); ``` ## radio.getISOCountryCodeForNetwork7+ getISOCountryCodeForNetwork\(slotId: number\): Promise 获取注册网络所在国家的ISO国家码，使用Promise方式作为异步方法。 - 参数

参数名

类型

必填

说明

slotId

number

是

卡槽ID。

0：卡槽1

1：卡槽2
- 返回值

类型

说明

Promise<string>

以Promise形式返回注册网络所在国家的ISO国家码，例如CN（中国）。
- 示例 ``` let slotId = 0; let promise = radio.getISOCountryCodeForNetwork(slotId); promise.then(data => { console.log(`getISOCountryCodeForNetwork success, promise: data->${JSON.stringify(data)}`); }).catch(err => { console.log(`getISOCountryCodeForNetwork fail, promise: err->${JSON.stringify(err)}`); }); ``` ## radio.getSignalInformation getSignalInformation\(slotId: number, callback: AsyncCallback\>\): void 获取指定SIM卡槽对应的注册网络信号强度信息列表，使用callback方式作为异步方法。 - 参数

参数名

类型

必填

说明

slotId

number

是

卡槽ID。

0：卡槽1

1：卡槽2

callback

AsyncCallback<Array<SignalInformation>>

是

回调函数，返回SignalInformation对象的数组。
- 示例 ``` let slotId = 0; radio.getSignalInformation(slotId, (err, data) => { console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); }); ``` ## radio.getSignalInformation getSignalInformation\(slotId: number\): Promise\> 获取指定SIM卡槽对应的注册网络信号强度信息列表，使用Promise方式作为异步方法。 - 参数

参数名

类型

必填

说明

slotId

number

是

卡槽ID。

0：卡槽1

1：卡槽2
- 返回值

类型

说明

Promise<Array<SignalInformation>>

以Promise形式返回网络信号强度SignalInformation对象的数组。
- 示例 ``` let slotId = 0; let promise = radio.getSignalInformation(slotId); promise.then(data => { console.log(`getSignalInformation success, promise: data->${JSON.stringify(data)}`); }).catch(err => { console.error(`getSignalInformation fail, promise: err->${JSON.stringify(err)}`); }); ``` ## radio.isRadioOn7+ isRadioOn\(callback: AsyncCallback\): void 判断Radio是否打开，使用callback方式作为异步方法。 需要ohos.permission.GET\_NETWORK\_INFO权限。 - 参数

参数名

类型

必填

说明

callback

AsyncCallback<boolean>

是

回调函数。

true：Radio打开

false：Radio关闭
- 示例 ``` radio.isRadioOn((err, data) => { console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); }); ``` ## radio.isRadioOn7+ isRadioOn\(\): Promise 判断Radio是否打开，使用Promise方式作为异步方法。 需要ohos.permission.GET\_NETWORK\_INFO权限。 - 返回值

类型

说明

Promise<boolean>

以Promise形式返回判断Radio是否打开的结果。

true：Radio打开

false：Radio关闭
- 示例 ``` let promise = radio.isRadioOn(); promise.then(data => { console.log(`isRadioOn success, promise: data->${JSON.stringify(data)}`); }).catch(err => { console.error(`isRadioOn fail, promise: err->${JSON.stringify(err)}`); }); ``` ## RadioTechnology 无线接入技术。

变量

值

说明

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）。
## SignalInformation 网络信号强度信息对象。

属性名

类型

说明

signalType

NetworkType

网络信号强度类型。

signalLevel

number

网络信号强度等级。
## NetworkType 网络类型。

变量

值

说明

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）。
## NetworkState 网络注册状态。

变量

类型

说明

longOperatorName

string

注册网络的长运营商名称。

shortOperatorName

string

注册网络的短运营商名称。

plmnNumeric

string

注册网络的PLMN码。

isRoaming

boolean

是否处于漫游状态。

regState

RegState

设备的网络注册状态。

nsaState

NsaState

设备的NSA网络注册状态。

isCaActive

boolean

CA的状态。

isEmergency

boolean

此设备是否只允许拨打紧急呼叫。
## RegState 网络注册状态。

变量

值

说明

REG_STATE_NO_SERVICE

0

设备不能使用任何服务。

REG_STATE_IN_SERVICE

1

设备可以正常使用业务。

REG_STATE_EMERGENCY_CALL_ONLY

2

设备只能使用紧急呼叫业务。

REG_STATE_POWER_OFF

3

蜂窝无线电已关闭。
## NsaState 非独立组网状态。

变量

值

说明

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小区。
## NetworkSelectionMode 选网模式。

变量

值

说明

NETWORK_SELECTION_UNKNOWN

0

未知选网模式。

NETWORK_SELECTION_AUTOMATIC

1

自动选网模式。

NETWORK_SELECTION_MANUAL

2

手动选网模式。