HarmonyOS

文章40 |   阅读 20917 |   点赞0

来源:https://blog.csdn.net/forever_wj/category_11128883.html

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

x33g5p2x  于2022-03-07 转载在 其他  
字(3.1k)|赞(0)|评价(0)|浏览(406)
一、电话服务
  • 电话服务系统提供了一系列的 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);

相关文章