鸿蒙OS 观察蜂窝网络状态变化

场景介绍

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

接口说明

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	停止观察所有状态的变化。

开发步骤

添加观察事件

1. 调用 RadioInfoManager 的 getInstance 接口，获取到 RadioInfoManager 实例。

1. 创建继承 RadioStateObserver 的类 MyRadioStateObserver，并覆写状态变化回调方法。

1. 创建 MyRadioStateObserver 的对象 observer。

1. 调用 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);

停止观察

1. 调用 RadioInfoManager 的 getInstance 接口，获取到 RadioInfoManager 实例。

1. 调用 RadioInfoManager 的 removeObserver 方法，传入添加观察事件时创建的 MyRadioStateObserver 对象 observer。

   // 获取RadioInfoManager对象。
   RadioInfoManager radioInfoManager = RadioInfoManager.getInstance(context);
   // 停止观察
   radioInfoManager.removeObserver(observer);