网络搜索

说明：
开发前请熟悉鸿蒙开发指导文档 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
本模块首批接口从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>): void

获取指定SIM卡槽对应的注册网络信号强度信息列表，使用callback方式作为异步方法。

系统能力 ：SystemCapability.Telephony.CoreService

参数：

参数名	类型	必填	说明
slotId	number	是	卡槽ID。 - 0：卡槽1 - 1：卡槽2
callback	AsyncCallback>	是	回调函数，返回[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>

获取指定SIM卡槽对应的注册网络信号强度信息列表，使用Promise方式作为异步方法。

系统能力 ：SystemCapability.Telephony.CoreService

参数：

参数名	类型	必填	说明
slotId	number	是	卡槽ID。 - 0：卡槽1 - 1：卡槽2

返回值：

类型	说明
Promise>	以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。
鸿蒙文档.png

名称	值	说明`HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿`
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	手动选网模式。

审核编辑黄宇

声明：本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人，不代表电子发烧友网立场。文章及其配图仅供工程师学习之用，如有内容侵权或者其他违规问题，请联系本站处理。举报投诉

接口

接口

+关注

关注
33

文章
8292

浏览量
150114
鸿蒙

鸿蒙

+关注

关注
57

文章
2275

浏览量
42540

鸿蒙实战项目开发：【短信服务】

概述本示例展示了电话服务中发送短信的功能。样例展示涉及OpenHarmony技术特性网络通信难度级别中级基础信息使用@ohos.telephony.sms接口展示了

发表于 03-03 21:29

鸿蒙实战应用开发：【拨打电话】功能

概述本示例通过输入电话，进行电话拨打，及电话相关信息的显示。样例展示涉及OpenHarmony技术特性网络通信基础信息拨打电话

发表于 03-04 20:22

鸿蒙原生应用开发-网络管理模块总述

。 ohos.permission.SET_NETWORK_INFO 修改网络连接状态。 ohos.permission.INTERNET 允许程序打开网络套接字，进行

发表于 04-08 09:45

鸿蒙原生应用元服务开发-WEB跨应用跳转

web_webview from \'@ohos.web.webview\'; import call from \'@ohos.telephony.call\'; @Entry

发表于 05-27 15:06

基于鸿蒙Next模拟电话通讯录及电话拨打

一、介绍基于鸿蒙Next模拟电话通讯录，可以拨打电话，删除电话等二、场景需求客户服务、业务咨询、回访处理、沟通交流、信息交流等等三、业

发表于 08-27 15:24

HarmonyOS API Version 7版本特性说明

4所示，提供基于蜂窝网络的电话服务能力，包括SIM卡、搜网、短彩信、蜂窝数据、通话管理、网络管理等各个模块。图4 电话

发表于 11-30 15:19

HarmonyOS API Version 7版本特性说明

4所示，提供基于蜂窝网络的电话服务能力，包括SIM卡、搜网、短彩信、蜂窝数据、通话管理、网络管理等各个模块。图4 电话

发表于 12-01 10:35

什么是Cable Telephony

什么是Cable Telephony 英文缩写: Cable Telephony 中文译名: 有线电视电话分　　类: 网络与交换解　　释: 指能

发表于 02-22 17:27 •912次阅读

华为在HDC 2022发布全屏意图搜索构建无界搜索服务体验

探索与实践成果。意图搜索：基于意图理解的服务直达鸿蒙生态下，万物皆服务。华为在HDC上展示的意图搜索，通过AI将机器视觉能力与用户意图感

发表于 11-06 20:09 •647次阅读

鸿蒙开发实战：【电话服务子系统】

电话服务子系统，提供了一系列的API用于获取无线蜂窝网络和SIM卡相关的一些信息。应用可以通过调用API来获取当前注册网络名称、网络服务状态

发表于 03-14 21:49 •276次阅读

鸿蒙开发电话服务：【@ohos.telephony.call (拨打电话)】

call模块提供呼叫管理功能，包括拨打电话、跳转到拨号界面、获取通话状态、格式化电话号码等。

发表于 06-15 09:13 •536次阅读

鸿蒙开发电话服务：【@ohos.telephony.observer (observer)】

订阅网络状态变化事件，使用callback方式作为异步方法。

发表于 06-15 09:18 •443次阅读

鸿蒙开发电话服务：ohos.telephony.sim之SIM卡管理

获取指定卡槽SIM卡是否激活，使用callback方式作为异步方法。

发表于 06-16 22:28 •205次阅读

鸿蒙开发电话服务：ohos.telephony.sms之短信服务

根据协议数据单元（PDU）和指定的短信协议创建短信实例，使用callback方式作为异步方法。

发表于 06-17 15:57 •368次阅读

鸿蒙开发电话服务：ohos.telephony.data之蜂窝数据

获取默认移动数据的SIM卡，使用callback方式作为异步方法。

发表于 06-18 09:31 •218次阅读