跳到主要内容

多网状态监听

场景介绍

应用通过监听多网络状态的变化,感知可用网络的变化,从而选择在多网络上传输数据的策略。

接口说明

具体API说明详见接口文档

接口名描述
on(type: 'multiPathStateChange', callback: Callback<MultiPathStateInfo>): void订阅多网状态信息变化。
off(type: 'multiPathStateChange', callback?: Callback<MultiPathStateInfo>): void取消订阅多网状态信息变化。

开发步骤

  1. 导入Network Boost Kit模块。

    import { netHandover } from '@kit.NetworkBoostKit';
    import { BusinessError } from '@kit.BasicServicesKit';
  2. 通过订阅的方式监听多网状态变化信息。

    try {
    netHandover.on('multiPathStateChange', (data: netHandover.MultiPathStateInfo) => {
    // 回调信息处理
    console.info("on multiPathStateChange: " + JSON.stringify(data));
    });
    } catch (err) {
    console.error('errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
    }
  3. 当应用业务流程结束和应用退出时,取消订阅多网状态变化信息。

    try {
    netHandover.off('multiPathStateChange');
    } catch (err) {
    console.error('errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
    }