鸿蒙开发电话服务:【@ohos.telephony.radio (网络搜索)】

2024-06-16 23:52

本文主要是介绍鸿蒙开发电话服务:【@ohos.telephony.radio (网络搜索)】,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

网络搜索

说明:

本模块首批接口从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

参数:

参数名类型必填说明
slotIdnumber卡槽ID。 - 0:卡槽1 - 1:卡槽2
callbackAsyncCallback<{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

参数:

参数名类型必填说明
slotIdnumber卡槽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

参数:

参数名类型必填说明
callbackAsyncCallback<[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

参数:

参数名类型必填说明
slotIdnumber卡槽ID。 - 0:卡槽1 - 1:卡槽2
callbackAsyncCallback<[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

参数:

参数名类型必填说明
slotIdnumber卡槽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

参数:

参数名类型必填说明
slotIdnumber卡槽ID。 - 0:卡槽1 - 1:卡槽2
callbackAsyncCallback<[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

参数:

参数名类型必填说明
slotIdnumber卡槽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

参数:

参数名类型必填说明
slotIdnumber卡槽ID。 - 0:卡槽1 - 1:卡槽2
callbackAsyncCallback回调函数。返回国家码,例如: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

参数:

参数名类型必填说明
slotIdnumber卡槽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

参数:

参数名类型必填说明
callbackAsyncCallback回调函数

示例:

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

参数:

参数名类型必填说明
slotIdnumber卡槽ID。 - 0:卡槽1 - 1:卡槽2
callbackAsyncCallback<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

参数:

参数名类型必填说明
slotIdnumber卡槽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

参数:

参数名类型必填说明
slotIdnumber卡槽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

参数:

参数名类型必填说明
callbackAsyncCallback回调函数。 - 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

参数:

参数名类型必填说明
slotIdnumber卡槽ID。 - 0:卡槽1 - 1:卡槽2
callbackAsyncCallback回调函数。 - 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

参数:

参数名类型必填说明
slotIdnumber卡槽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

参数:

参数名类型必填说明
slotIdnumber卡槽ID。 - 0:卡槽1 - 1:卡槽2
callbackAsyncCallback回调函数。返回运营商名称,例如:中国移动。

示例:

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

参数:

参数名类型必填说明
slotIdnumber卡槽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_UNKNOWN0未知无线接入技术(RAT)。
RADIO_TECHNOLOGY_GSM1无线接入技术GSM(Global System For Mobile Communication)。
RADIO_TECHNOLOGY_1XRTT2无线接入技术1XRTT(Single-Carrier Radio Transmission Technology)。
RADIO_TECHNOLOGY_WCDMA3无线接入技术WCDMA(Wideband Code Division Multiple Access)。
RADIO_TECHNOLOGY_HSPA4无线接入技术HSPA(High Speed Packet Access)。
RADIO_TECHNOLOGY_HSPAP5无线接入技术HSPAP(High Speed packet access (HSPA+) )。
RADIO_TECHNOLOGY_TD_SCDMA6无线接入技术TDSCDMA(TimeDivision-Synchronous Code Division Multiple Access)。
RADIO_TECHNOLOGY_EVDO7无线接入技术EVDO(Evolution、Data Only)。
RADIO_TECHNOLOGY_EHRPD8无线接入技术EHRPD(Evolved High Rate Package Data)。
RADIO_TECHNOLOGY_LTE9无线接入技术LTE(Long Term Evolution)。
RADIO_TECHNOLOGY_LTE_CA10无线接入技术LTE_CA(Long Term Evolution_Carrier Aggregation)。
RADIO_TECHNOLOGY_IWLAN11无线接入技术IWLAN(Industrial Wireless LAN)。
RADIO_TECHNOLOGY_NR12无线接入技术NR(New Radio)。

SignalInformation

网络信号强度信息对象。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

参数名类型说明
signalType[NetworkType]网络信号强度类型。
signalLevelnumber网络信号强度等级。

NetworkType

网络类型。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称说明
NETWORK_TYPE_UNKNOWN0未知网络类型。
NETWORK_TYPE_GSM1网络类型为GSM(Global System For Mobile Communication)。
NETWORK_TYPE_CDMA2网络类型为CDMA(Code Division Multiple Access)。
NETWORK_TYPE_WCDMA3网络类型为WCDMA(Wideband Code Division Multiple Access)。
NETWORK_TYPE_TDSCDMA4网络类型为TDSCDMA(TimeDivision-Synchronous Code Division Multiple Access)。
NETWORK_TYPE_LTE5网络类型为LTE(Long Term Evolution)。
NETWORK_TYPE_NR6网络类型为5G NR(New Radio)。

NetworkState

网络注册状态。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称类型说明
longOperatorNamestring注册网络的长运营商名称。
shortOperatorNamestring注册网络的短运营商名称。
plmnNumericstring注册网络的PLMN码。
isRoamingboolean是否处于漫游状态。
regState[RegState]设备的网络注册状态。
cfgTech8+[RadioTechnology]设备的无线接入技术。
nsaState[NsaState]设备的NSA网络注册状态。
isCaActivebooleanCA的状态。
isEmergencyboolean此设备是否只允许拨打紧急呼叫。

RegState

网络注册状态。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称说明
REG_STATE_NO_SERVICE0设备不能使用任何服务。
REG_STATE_IN_SERVICE1设备可以正常使用业务。
REG_STATE_EMERGENCY_CALL_ONLY2设备只能使用紧急呼叫业务。
REG_STATE_POWER_OFF3蜂窝无线电已关闭。

NsaState

非独立组网状态。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称说明
NSA_STATE_NOT_SUPPORT1设备在不支持NSA的LTE小区下处于空闲状态或连接状态。
NSA_STATE_NO_DETECT2在支持NSA但不支持NR覆盖检测的LTE小区下,设备处于空闲状态。
NSA_STATE_CONNECTED_DETECT3设备在LTE小区下连接到LTE网络支持NSA和NR覆盖检测。
NSA_STATE_IDLE_DETECT4支持NSA和NR覆盖检测的LTE小区下设备处于空闲状态。
NSA_STATE_DUAL_CONNECTED5设备在支持NSA的LTE小区下连接到LTE + NR网络。
NSA_STATE_SA_ATTACHED6设备在5GC附着时在NG-RAN小区下空闲或连接到NG-RAN小区。

NetworkSelectionMode

选网模式。

系统能力:以下各项对应的系统能力均为SystemCapability.Telephony.CoreService。

名称说明
NETWORK_SELECTION_UNKNOWN0未知选网模式。
NETWORK_SELECTION_AUTOMATIC1自动选网模式。
NETWORK_SELECTION_MANUAL2手动选网模式。

这篇关于鸿蒙开发电话服务:【@ohos.telephony.radio (网络搜索)】的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1067903

相关文章

Linux系统配置NAT网络模式的详细步骤(附图文)

《Linux系统配置NAT网络模式的详细步骤(附图文)》本文详细指导如何在VMware环境下配置NAT网络模式,包括设置主机和虚拟机的IP地址、网关,以及针对Linux和Windows系统的具体步骤,... 目录一、配置NAT网络模式二、设置虚拟机交换机网关2.1 打开虚拟机2.2 管理员授权2.3 设置子

揭秘Python Socket网络编程的7种硬核用法

《揭秘PythonSocket网络编程的7种硬核用法》Socket不仅能做聊天室,还能干一大堆硬核操作,这篇文章就带大家看看Python网络编程的7种超实用玩法,感兴趣的小伙伴可以跟随小编一起... 目录1.端口扫描器:探测开放端口2.简易 HTTP 服务器:10 秒搭个网页3.局域网游戏:多人联机对战4.

Spring Boot + MyBatis Plus 高效开发实战从入门到进阶优化(推荐)

《SpringBoot+MyBatisPlus高效开发实战从入门到进阶优化(推荐)》本文将详细介绍SpringBoot+MyBatisPlus的完整开发流程,并深入剖析分页查询、批量操作、动... 目录Spring Boot + MyBATis Plus 高效开发实战:从入门到进阶优化1. MyBatis

Python基于wxPython和FFmpeg开发一个视频标签工具

《Python基于wxPython和FFmpeg开发一个视频标签工具》在当今数字媒体时代,视频内容的管理和标记变得越来越重要,无论是研究人员需要对实验视频进行时间点标记,还是个人用户希望对家庭视频进行... 目录引言1. 应用概述2. 技术栈分析2.1 核心库和模块2.2 wxpython作为GUI选择的优

SpringBoot使用OkHttp完成高效网络请求详解

《SpringBoot使用OkHttp完成高效网络请求详解》OkHttp是一个高效的HTTP客户端,支持同步和异步请求,且具备自动处理cookie、缓存和连接池等高级功能,下面我们来看看SpringB... 目录一、OkHttp 简介二、在 Spring Boot 中集成 OkHttp三、封装 OkHttp

利用Python开发Markdown表格结构转换为Excel工具

《利用Python开发Markdown表格结构转换为Excel工具》在数据管理和文档编写过程中,我们经常使用Markdown来记录表格数据,但它没有Excel使用方便,所以本文将使用Python编写一... 目录1.完整代码2. 项目概述3. 代码解析3.1 依赖库3.2 GUI 设计3.3 解析 Mark

Linux上设置Ollama服务配置(常用环境变量)

《Linux上设置Ollama服务配置(常用环境变量)》本文主要介绍了Linux上设置Ollama服务配置(常用环境变量),Ollama提供了多种环境变量供配置,如调试模式、模型目录等,下面就来介绍一... 目录在 linux 上设置环境变量配置 OllamPOgxSRJfa手动安装安装特定版本查看日志在

利用Go语言开发文件操作工具轻松处理所有文件

《利用Go语言开发文件操作工具轻松处理所有文件》在后端开发中,文件操作是一个非常常见但又容易出错的场景,本文小编要向大家介绍一个强大的Go语言文件操作工具库,它能帮你轻松处理各种文件操作场景... 目录为什么需要这个工具?核心功能详解1. 文件/目录存javascript在性检查2. 批量创建目录3. 文件

Linux系统之主机网络配置方式

《Linux系统之主机网络配置方式》:本文主要介绍Linux系统之主机网络配置方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、查看主机的网络参数1、查看主机名2、查看IP地址3、查看网关4、查看DNS二、配置网卡1、修改网卡配置文件2、nmcli工具【通用

SpringCloud之LoadBalancer负载均衡服务调用过程

《SpringCloud之LoadBalancer负载均衡服务调用过程》:本文主要介绍SpringCloud之LoadBalancer负载均衡服务调用过程,具有很好的参考价值,希望对大家有所帮助,... 目录前言一、LoadBalancer是什么?二、使用步骤1、启动consul2、客户端加入依赖3、以服务