# 多网状态监听

## 场景介绍

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

## 接口说明

具体API说明详见[接口文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/networkboost-nethandover#nethandoveronmultipathstatechange)。

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

## 开发步骤

1. 导入Network Boost Kit模块。

   ```typescript
   import { netHandover } from '@kit.NetworkBoostKit';
   import { BusinessError } from '@kit.BasicServicesKit';
   ```

2. 通过订阅的方式监听多网状态变化信息。

   ```typescript
   try {
     netHandover.on('multiPathStateChange', (data: netHandover.MultiPathStateInfo) => {
       // 回调信息处理
       console.info('on multiPathStateChange multiPathState:', data.multiPathState);
       console.info('on multiPathStateChange cause:', data.cause);
       console.info('on multiPathStateChange netHandle:', data.netHandle.netId);
       console.info('on multiPathStateChange pathState:', data.pathState);
       console.info('on multiPathStateChange pathType:', data.pathType);
     });
   } catch (err) {
     console.error('errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
   }
   ```

3. 当应用业务流程结束和应用退出时，取消订阅多网状态变化信息。

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