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

2024-06-16 23:52
文章标签 服务 开发 搜索 网络 电话 radio 鸿蒙 ohos telephony

本文主要是介绍鸿蒙开发电话服务：【@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。

相关文章

关于DNS域名解析服务

关于DNS域名解析服务

《关于DNS域名解析服务》：本文主要介绍关于DNS域名解析服务,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录DNS系统的作用及类型DNS使用的协议及端口号DNS系统的分布式数据结构DNS的分布式互联网解析库域名体系结构两种查询方式DNS服务器类型统计构建DNS域
阅读更多...
Linux中压缩、网络传输与系统监控工具的使用完整指南

Linux中压缩、网络传输与系统监控工具的使用完整指南

《Linux中压缩、网络传输与系统监控工具的使用完整指南》在Linux系统管理中,压缩与传输工具是数据备份和远程协作的桥梁,而系统监控工具则是保障服务器稳定运行的眼睛,下面小编就来和大家详细介绍一下它... 目录引言一、压缩与解压：数据存储与传输的优化核心1. zip/unzip：通用压缩格式的便捷操作2.
阅读更多...
Linux中SSH服务配置的全面指南

Linux中SSH服务配置的全面指南

《Linux中SSH服务配置的全面指南》作为网络安全工程师,SSH（SecureShell）服务的安全配置是我们日常工作中不可忽视的重要环节,本文将从基础配置到高级安全加固,全面解析SSH服务的各项参... 目录概述基础配置详解端口与监听设置主机密钥配置认证机制强化禁用密码认证禁止root直接登录实现双因素
阅读更多...
java向微信服务号发送消息的完整步骤实例

java向微信服务号发送消息的完整步骤实例

《java向微信服务号发送消息的完整步骤实例》：本文主要介绍java向微信服务号发送消息的相关资料,包括申请测试号获取appID/appsecret、关注公众号获取openID、配置消息模板及代码... 目录步骤1. 申请测试系统2. 公众号账号信息3. 关注测试号二维码4. 消息模板接口5. Java测试
阅读更多...
SpringBoot开发中十大常见陷阱深度解析与避坑指南

SpringBoot开发中十大常见陷阱深度解析与避坑指南

《SpringBoot开发中十大常见陷阱深度解析与避坑指南》在SpringBoot的开发过程中,即使是经验丰富的开发者也难免会遇到各种棘手的问题,本文将针对SpringBoot开发中十大常见的“坑... 目录引言一、配置总出错？是不是同时用了.properties和.yml？二、换个位置配置就失效？搞清楚加
阅读更多...
Python中对FFmpeg封装开发库FFmpy详解

Python中对FFmpeg封装开发库FFmpy详解

《Python中对FFmpeg封装开发库FFmpy详解》：本文主要介绍Python中对FFmpeg封装开发库FFmpy,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐... 目录一、FFmpy简介与安装1.1 FFmpy概述1.2 安装方法二、FFmpy核心类与方法2.1 FF
阅读更多...
基于Python开发Windows屏幕控制工具

基于Python开发Windows屏幕控制工具

《基于Python开发Windows屏幕控制工具》在数字化办公时代,屏幕管理已成为提升工作效率和保护眼睛健康的重要环节,本文将分享一个基于Python和PySide6开发的Windows屏幕控制工具,... 目录概述功能亮点界面展示实现步骤详解1. 环境准备2. 亮度控制模块3. 息屏功能实现4. 息屏时间
阅读更多...
HTML5 搜索框Search Box详解

HTML5 搜索框Search Box详解

《HTML5搜索框SearchBox详解》HTML5的搜索框是一个强大的工具，能够有效提升用户体验,通过结合自动补全功能和适当的样式，可以创建出既美观又实用的搜索界面,这篇文章给大家介绍HTML5... html5 搜索框（Search Box）详解搜索框是一个用于输入查询内容的控件，通常用于网站或应用程
阅读更多...
Python实例题之pygame开发打飞机游戏实例代码

Python实例题之pygame开发打飞机游戏实例代码

《Python实例题之pygame开发打飞机游戏实例代码》对于python的学习者,能够写出一个飞机大战的程序代码,是不是感觉到非常的开心,：本文主要介绍Python实例题之pygame开发打飞机... 目录题目pygame-aircraft-game使用 Pygame 开发的打飞机游戏脚本代码解释初始化部
阅读更多...
使用Python开发一个现代化屏幕取色器

使用Python开发一个现代化屏幕取色器

《使用Python开发一个现代化屏幕取色器》在UI设计、网页开发等场景中,颜色拾取是高频需求,：本文主要介绍如何使用Python开发一个现代化屏幕取色器,有需要的小伙伴可以参考一下... 目录一、项目概述二、核心功能解析2.1 实时颜色追踪2.2 智能颜色显示三、效果展示四、实现步骤详解4.1 环境配置4.
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2