HarmonyOS学习路之开发篇—网络与连接（电话服务）

电话服务开发概述

电话服务系统提供了一系列的API用于获取无线蜂窝网络和SIM卡相关的一些信息。

应用可以通过调用RadioInfoManager中的API，来获取当前注册网络名称、网络服务状态以及信号强度等信息；以及调用SimInfoManager中的API，来获取SIM卡的相关信息。

约束与限制

注册获取SIM卡状态接口仅针对有SIM卡在位场景生效，若用户拔出SIM卡，则接收不到回调事件。应用可通过调用hasSimCard接口来确定当前卡槽是否有卡在位。

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

场景介绍

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

接口说明

RadioInfoManager类中提供了获取当前网络信号信息列表的方法。

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

开发步骤

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

代码语言：javascript复制

// 获取RadioInfoManager对象。
RadioInfoManager radioInfoManager = RadioInfoManager.getInstance(context);

// 获取信号信息。
List<SignalInformation> signalList = radioInfoManager.getSignalInfoList(slotId);

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

观察蜂窝网络状态变化

场景介绍

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

接口说明

RadioStateObserver类中提供了观察蜂窝网络状态变化的方法，为了能够实时观察蜂窝网络状态变化，应用必须包含以下权限。

观察状态名称	权限名称
网络状态信息(NETWORK_STATE)	ohos.permission.GET_NETWORK_INFO
信号信息(SIGNAL_INFO)	NA

需要使用RadioInfoManager的如下接口将继承RadioStateObserver类的对象注册到系统服务：

接口名	观察事件的掩码	描述
addObserver	OBSERVE_MASK_NETWORK_STATE	观察蜂窝网络驻网状态信息。
addObserver	OBSERVE_MASK_SIGNAL_INFO	观察蜂窝网络信号信息。
removeObserver	N/A	停止观察所有状态的变化。

开发步骤

添加观察事件

调用RadioInfoManager的getInstance接口，获取到RadioInfoManager实例。
创建继承RadioStateObserver的类MyRadioStateObserver，并覆写状态变化回调方法。
创建MyRadioStateObserver的对象observer。
调用RadioInfoManager的addObserver方法，传入已创建的MyRadioStateObserver对象observer和需要观察的mask。

代码语言：javascript复制

// 获取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。

代码语言：javascript复制

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

harmonyos 服务开发连接网络

0 人点赞