网络搜索
说明:
本模块首批接口从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
系统能力:SystemCapability.Telephony.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
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
系统能力:SystemCapability.Telephony.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
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
系统能力:SystemCapability.Telephony.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
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
系统能力:SystemCapability.Telephony.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
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
系统能力:SystemCapability.Telephony.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
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方式作为异步方法。
系统能力:SystemCapability.Telephony.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
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方式作为异步方法。
系统能力:SystemCapability.Telephony.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
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方式作为异步方法。
系统能力:SystemCapability.Telephony.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
callback | AsyncCallback | 是 | 回调函数。返回国家码,例如: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方式作为异步方法。
系统能力:SystemCapability.Telephony.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
返回值:
类型 | 说明 |
---|---|
Promise | 以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.getPrimarySlotId7+
getPrimarySlotId(callback: AsyncCallback): void
获取主卡所在卡槽的索引号,使用callback方式作为异步方法。
系统能力:SystemCapability.Telephony.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
callback | AsyncCallback | 是 | 回调函数 |
示例:
radio.getPrimarySlotId((err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
radio.getPrimarySlotId7+
getPrimarySlotId(): Promise
获取主卡所在卡槽的索引号,使用Promise方式作为异步方法。
系统能力:SystemCapability.Telephony.CoreService
返回值:
类型 | 说明 |
---|---|
Promise | 以Promise形式返回获取设备主卡所在卡槽的索引号的结果。 |
示例:
let promise = radio.getPrimarySlotId();
promise.then(data => {
console.log(`getPrimarySlotId success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.error(`getPrimarySlotId fail, promise: err->${JSON.stringify(err)}`);
});
radio.getSignalInformation7+
getSignalInformation(slotId: number, callback: AsyncCallback<Array>): void
获取指定SIM卡槽对应的注册网络信号强度信息列表,使用callback方式作为异步方法。
系统能力:SystemCapability.Telephony.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
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.getSignalInformation7+
getSignalInformation(slotId: number): Promise<Array>
获取指定SIM卡槽对应的注册网络信号强度信息列表,使用Promise方式作为异步方法。
系统能力:SystemCapability.Telephony.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
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.isNrSupported8+
isNrSupported(slotId: number): boolean
判断当前设备是否支持5G(NR)。
系统能力:SystemCapability.Telephony.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
返回值:
类型 | 说明 |
---|---|
boolean | - true:支持 - false:不支持 |
示例:
let slotId = 0;
let result = radio.isNrSupported(slotId);
console.log("Result: "+ result);
radio.isRadioOn7+
isRadioOn(callback: AsyncCallback): void
判断主卡的Radio是否打开,使用callback方式作为异步方法。
需要权限:ohos.permission.GET_NETWORK_INFO
系统能力:SystemCapability.Telephony.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
callback | AsyncCallback | 是 | 回调函数。 - true:Radio打开 - false:Radio关闭 |
示例:
radio.isRadioOn((err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
radio.isRadioOn7+
isRadioOn(slotId: number, callback: AsyncCallback): void
判断指定卡槽位的Radio是否打开,使用callback方式作为异步方法。
需要权限:ohos.permission.GET_NETWORK_INFO
系统能力:SystemCapability.Telephony.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
callback | AsyncCallback | 是 | 回调函数。 - true:Radio打开 - false:Radio关闭 |
示例:
let slotId = 0;
radio.isRadioOn(slotId, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
radio.isRadioOn7+
isRadioOn(slotId?: number): Promise
判断Radio是否打开,使用Promise方式作为异步方法。
需要权限:ohos.permission.GET_NETWORK_INFO
系统能力:SystemCapability.Telephony.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 否 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 如果不指定slotId,默认判断主卡Radio是否打开 |
返回值:
类型 | 说明 |
---|---|
Promise | 以Promise形式返回判断Radio是否打开的结果。 - true:Radio打开 - false:Radio关闭 |
示例:
let slotId = 0;
let promise = radio.isRadioOn(slotId);
promise.then(data => {
console.log(`isRadioOn success, promise: data->${JSON.stringify(data)}`);
}).catch(err => {
console.error(`isRadioOn fail, promise: err->${JSON.stringify(err)}`);
});
radio.getOperatorName7+
getOperatorName(slotId: number, callback: AsyncCallback): void
获取运营商名称,使用callback方式作为异步方法。
系统能力:SystemCapability.Telephony.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
callback | AsyncCallback | 是 | 回调函数。返回运营商名称,例如:中国移动。 |
示例:
let slotId = 0;
radio.getOperatorName(slotId, (err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
radio.getOperatorName7+
getOperatorName(slotId: number): Promise
获取运营商名称,使用Promise方式作为异步方法。
系统能力:SystemCapability.Telephony.CoreService
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
slotId | number | 是 | 卡槽ID。 - 0:卡槽1 - 1:卡槽2 |
返回值:
类型 | 说明 |
---|---|
Promise | 以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
无线接入技术。
系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。
名称 | 值 | 说明 |
---|---|---|
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
网络信号强度信息对象。
系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。
参数名 | 类型 | 说明 |
---|---|---|
signalType | [NetworkType] | 网络信号强度类型。 |
signalLevel | number | 网络信号强度等级。 |
NetworkType
网络类型。
系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。
名称 | 值 | 说明 |
---|---|---|
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
网络注册状态。
系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。
名称 | 类型 | 说明 |
---|---|---|
longOperatorName | string | 注册网络的长运营商名称。 |
shortOperatorName | string | 注册网络的短运营商名称。 |
plmnNumeric | string | 注册网络的PLMN码。 |
isRoaming | boolean | 是否处于漫游状态。 |
regState | [RegState] | 设备的网络注册状态。 |
cfgTech8+ | [RadioTechnology] | 设备的无线接入技术。 |
nsaState | [NsaState] | 设备的NSA网络注册状态。 |
isCaActive | boolean | CA的状态。 |
isEmergency | boolean | 此设备是否只允许拨打紧急呼叫。 |
RegState
网络注册状态。
系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。
名称 | 值 | 说明 |
---|---|---|
REG_STATE_NO_SERVICE | 0 | 设备不能使用任何服务。 |
REG_STATE_IN_SERVICE | 1 | 设备可以正常使用业务。 |
REG_STATE_EMERGENCY_CALL_ONLY | 2 | 设备只能使用紧急呼叫业务。 |
REG_STATE_POWER_OFF | 3 | 蜂窝无线电已关闭。 |
NsaState
非独立组网状态。
系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。
名称 | 值 | 说明 |
---|---|---|
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
选网模式。
系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。
名称 | 值 | 说明 |
---|---|---|
NETWORK_SELECTION_UNKNOWN | 0 | 未知选网模式。 |
NETWORK_SELECTION_AUTOMATIC | 1 | 自动选网模式。 |
NETWORK_SELECTION_MANUAL | 2 | 手动选网模式。 |