鸿蒙OS开发文档鸿蒙OS 观察蜂窝网络状态变化

2024-02-25 开发教程鸿蒙OS开发文档匿名 11℃

场景介绍

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

接口说明

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);

上一节：鸿蒙OS 获取当前蜂窝网络信号信息

"鸿蒙OS开发文档"的目录

鸿蒙OS开发文档 鸿蒙OS 观察蜂窝网络状态变化

场景介绍

接口说明

开发步骤

鸿蒙OS开发文档鸿蒙OS 观察蜂窝网络状态变化