电话服务开发概述
电话服务系统提供了一系列的API用于获取无线蜂窝网络和SIM卡相关的一些信息。
应用可以通过调用RadioInfoManager中的API，来获取当前注册网络名称、网络服务状态以及信号强度等信息；以及调用SimInfoManager中的API，来获取SIM卡的相关信息。
约束与限制
注册获取SIM卡状态接口仅针对有SIM卡在位场景生效，若用户拔出SIM卡，则接收不到回调事件。应用可通过调用hasSimCard接口来确定当前卡槽是否有卡在位。
获取当前蜂窝网络信号信息
场景介绍
应用通常需要获取用户所在蜂窝网络下信号信息，以便获取当前驻网质量。开发者可以通过本业务，获取到用户指定SIM卡当前所在网络下的信号信息。
接口说明
RadioInfoManager类中提供了获取当前网络信号信息列表的方法。
| 功能分类 | 接口名 | 描述 | 所需权限 |
|---|---|---|---|
| 获取管理对象 | getInstance(Context context) | 获取网络管理对象。 | 无 |
| 信号强度信息 | getSignalInfoList(int slotId) | 获取当前注册蜂窝网络信号强度信息。 | 无 |
开发步骤
- 调用RadioInfoManager的getInstance接口，获取到RadioInfoManager实例。
- 调用getSignalInfoList(slotId)方法，返回所有SignalInformation列表。
- 遍历SignalInformation列表，并分别根据getNetworkType()转换为对应制式的SignalInformation子类对象。
- 调用子类中的方法，获取信号强度信息。
// 获取RadioInfoManager对象。
RadioInfoManager radioInfoManager = RadioInfoManager.getInstance(context);// 获取信号信息。
List<SignalInformation> signalList = radioInfoManager.getSignalInfoList(slotId);// 检查信号信息列表大小。
if (signalList.size() == 0) {return;
}
// 依次遍历list获取当前驻网networkType对应的信号信息。
LteSignalInformation lteSignal = null;
for (SignalInformation signal : signalList) {int signalNetworkType = signal.getNetworkType();if (signalNetworkType == TelephonyConstants.NETWORK_TYPE_LTE) {lteSignal = (LteSignalInformation) signal;}
}
// 调用子类中相应方法，获取对应制式的信号强度信息。
int signalLevel = lteSignal != null ? lteSignal.getSignalLevel() : 0;观察蜂窝网络状态变化
场景介绍
应用可以通过观察蜂窝网络状态变化，来接收最新蜂窝网络服务状态信息、信号信息等。
接口说明
RadioStateObserver类中提供了观察蜂窝网络状态变化的方法，为了能够实时观察蜂窝网络状态变化，应用必须包含以下权限。
| 观察状态名称 | 权限名称 |
|---|---|
| 网络状态信息(NETWORK_STATE) | ohos.permission.GET_NETWORK_INFO |
| 信号信息(SIGNAL_INFO) | NA |
需要使用RadioInfoManager的如下接口将继承RadioStateObserver类的对象注册到系统服务：
| 接口名 | 观察事件的掩码 | 描述 |
|---|---|---|
| addObserver | OBSERVE_MASK_NETWORK_STATE | 观察蜂窝网络驻网状态信息。 |
| OBSERVE_MASK_SIGNAL_INFO | 观察蜂窝网络信号信息。 | |
| removeObserver | N/A | 停止观察所有状态的变化。 |
开发步骤
添加观察事件
- 调用RadioInfoManager的getInstance接口，获取到RadioInfoManager实例。
- 创建继承RadioStateObserver的类MyRadioStateObserver，并覆写状态变化回调方法。
- 创建MyRadioStateObserver的对象observer。
- 调用RadioInfoManager的addObserver方法，传入已创建的MyRadioStateObserver对象observer和需要观察的mask。
// 获取RadioInfoManager对象。
RadioInfoManager radioInfoManager = RadioInfoManager.getInstance(context);
// 创建继承RadioStateObserver的类MyRadioStateObserver
class MyRadioStateObserver extends RadioStateObserver {// 构造方法，在当前线程的runner中执行回调，slotId需要传入要观察的卡槽ID（0或1）。MyRadioStateObserver(int slotId) {super(slotId);}// 构造方法，在执行runner中执行回调。MyRadioStateObserver(int slotId, EventRunner runner) {super(slotId, runner);}// 网络注册状态变化的回调方法。@Overridepublic void onNetworkStateUpdated(NetworkState state) {...}// 信号信息变化的回调方法。@Overridepublic void onSignalInfoUpdated(List<SignalInformation> signalInfos) {...}
}// 执行回调的runner。
EventRunner runner = EventRunner.create();// 创建MyRadioStateObserver的对象。
MyRadioStateObserver observer = new MyRadioStateObserver(slotId, runner);// 添加回调，以NETWORK_STATE和SIGNAL_INFO为例。
radioInfoManager.addObserver(observer, RadioStateObserver.OBSERVE_MASK_NETWORK_STATE | RadioStateObserver.OBSERVE_MASK_SIGNAL_INFO);停止观察
- 调用RadioInfoManager的getInstance接口，获取到RadioInfoManager实例。
- 调用RadioInfoManager的removeObserver方法，传入添加观察事件时创建的MyRadioStateObserver对象observer。
// 获取RadioInfoManager对象。
RadioInfoManager radioInfoManager = RadioInfoManager.getInstance(context);
// 停止观察
radioInfoManager.removeObserver(observer);
