鸿蒙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);
版权声明:本文采用知识共享 署名4.0国际许可协议 [BY-NC-SA] 进行授权
文章名称:《鸿蒙OS 观察蜂窝网络状态变化》
文章链接:https://zhuji.vsping.com/312163.html
本站资源仅供个人学习交流,请于下载后24小时内删除,不允许用于商业用途,否则法律问题自行承担。