HarmonyOS之应用开发的电话服务与蜂窝网络

一、电话服务

• 电话服务系统提供了一系列的 API 用于获取无线蜂窝网络和 SIM 卡相关的一些信息。
• 应用可以通过调用 RadioInfoManager 中的 API，来获取当前注册网络名称、网络服务状态以及信号强度等信息；以及调用 SimInfoManager 中的 API，来获取 SIM 卡的相关信息。
• 注册获取 SIM 卡状态接口仅针对有 SIM 卡在位场景生效，若用户拔出 SIM 卡，则接收不到回调事件。应用可通过调用 hasSimCard 接口来确定当前卡槽是否有卡在位。

二、获取当前蜂窝网络信号信息

① 应用场景

• 应用通常需要获取用户所在蜂窝网络下信号信息，以便获取当前驻网质量。
• 开发者可以通过本业务，获取到用户指定SIM卡当前所在网络下的信号信息。

② API 说明

• RadioInfoManager 类中提供了获取当前网络信号信息列表的方法。
• RadioInfoManager 的主要接口：

功能分类	接口名	描述	所需权限
获取管理对象	getInstance​(Context context)	获取网络管理对象	无
信号强度信息	getSignalInfoList​​(int slotId)	获取当前注册蜂窝网络信号强度信息	无

③ 使用

• 调用 RadioInfoManager 的 getInstance 接口，获取到 RadioInfoManager 实例。
• 调用 getSignalInfoList(slotId) 方法，返回所有 SignalInformation 列表。
• 遍历 SignalInformation 列表，并分别根据 signalNetworkType 转换为对应制式的 SignalInformation 子类对象。
• 调用子类中的方法，获取信号强度信息。

	// 获取RadioInfoManager对象。
	RadioInfoManager radioInfoManager = RadioInfoManager.getInstance(context);
	
	// 获取信号信息。
	List<SignalInformation> signalList = radioInfoManager.getSignalInfoList(slotId);
	
	// 检查信号信息列表大小。
	if (signalList.size() == 0) {
	    return;
	}
	// 依次遍历list获取当前驻网networkType对应的信号信息。
	LteSignalInformation lteSignal = new LteSignalInformation();
	for (SignalInformation signal : signalList) {
	    int signalNetworkType = signal.getNetworkType();
	    if (signalNetworkType == TelephonyConstants.NETWORK_TYPE_LTE) {
	        lteSignal = (LteSignalInformation) signal;
	    }
	}
	// 调用子类中相应方法，获取对应制式的信号强度信息。
	int signalLevel = lteSignal.getSignalLevel();

三、观察蜂窝网络状态变化

① 应用场景

• 应用可以通过观察蜂窝网络状态变化，来接收最新蜂窝网络服务状态信息、信号信息等。

② API 说明

• 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);
	    }
	
	    // 网络注册状态变化的回调方法。
	    @Override
	    public void onNetworkStateUpdated(NetworkState state) {
	        ...
	    }
	
	    // 信号信息变化的回调方法。
	    @Override
	    public 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);