网络搜索

About 37 min

网络搜索

说明:

标记7+的表示从API Version 7开始支持,未标记的表示从API Version 6开始支持。

导入模块

import radio from '@ohos.telephony.radio'
1

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)}`);
    });
    
    1
    2
    3
    4

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)}`);
    });
    
    1
    2
    3
    4
    5
    6
    7

radio.getNetworkState

getNetworkState(callback: AsyncCallback<NetworkState>): 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)}`);
    });
    
    1
    2
    3

radio.getNetworkState

getNetworkState(slotId: number, callback: AsyncCallback<NetworkState>): 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)}`);
    });
    
    1
    2
    3
    4

radio.getNetworkState

getNetworkState(slotId?: number): Promise<NetworkState>

获取网络状态,使用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)}`);
    });
    
    1
    2
    3
    4
    5
    6
    7

radio.getNetworkSelectionMode

getNetworkSelectionMode(slotId: number, callback: AsyncCallback<NetworkSelectionMode>): 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)}`);
    });
    
    1
    2
    3
    4

radio.getNetworkSelectionMode

getNetworkSelectionMode(slotId: number): Promise<NetworkSelectionMode>

获取当前选网模式,使用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)}`);
    });
    
    1
    2
    3
    4
    5
    6
    7

radio.getISOCountryCodeForNetwork7+

getISOCountryCodeForNetwork(slotId: number, callback: AsyncCallback<string>): 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)}`);
    });
    
    1
    2
    3
    4

radio.getISOCountryCodeForNetwork7+

getISOCountryCodeForNetwork(slotId: number): Promise<string>

获取注册网络所在国家的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)}`);
    });
    
    1
    2
    3
    4
    5
    6
    7

radio.getSignalInformation

getSignalInformation(slotId: number, callback: AsyncCallback<Array<SignalInformation>>): 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)}`);
    });
    
    1
    2
    3
    4

radio.getSignalInformation

getSignalInformation(slotId: number): Promise<Array<SignalInformation>>

获取指定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)}`);
    });
    
    1
    2
    3
    4
    5
    6
    7

radio.isRadioOn7+

isRadioOn(callback: AsyncCallback<boolean>): 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)}`);
    });
    
    1
    2
    3

radio.isRadioOn7+

isRadioOn(): Promise<boolean>

判断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)}`);
    });
    
    1
    2
    3
    4
    5
    6

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

手动选网模式。