从6.0.2(22)开始，支持多网发起和释放功能。

## 场景介绍

应用可根据自身业务的需要，以及系统的建议来发起多网络加速的请求，并在使用结束后及时释放。支持WiFi和蜂窝并发以及主卡和副卡并发，不支持开发者指定并发组合，并发组合由系统决定。

说明

* 主卡和副卡并发需要开启智能切换上网卡开关，并依赖主卡和副卡驻留网络的频点，若不满足并发条件（例如主副卡插入同运营商卡场景），多网发起会失败。
* 受限于硬件，部分设备不支持双卡场景下的多网并发，开发者可通过错误码进行排查。
* 如果要使用的传输协议接口不支持指定网络，则新发起的网络无法使用。如[HTTP](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/http-request)当前只支持默认网络传输，不支持指定网络，所以无法使用。

## 开发前准备

多网发起需要开启网络加速开关，操作路径为：设置->移动网络->网络加速->允许使用移动数据加速网络，如果没有该开关，说明您当前的设备/ROM不支持多网并发能力。

## 接口说明

具体API说明详见[接口文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/network-boost-c-module)。

展开

| 接口名 | 描述 |
| --- | --- |
| int32\_t HMS\_NetworkBoost\_RequestMultiPath(HMS\_NetworkBoost\_OnMultiPathRequestResult result) | 发起多网请求。 |
| int32\_t HMS\_NetworkBoost\_ReleaseMultiPath() | 释放多网请求。 |

## 开发步骤

1. 导入Network Boost Kit模块。

   收起

   自动换行

   深色代码主题

   复制

   ```
   1. #include "NetworkBoostKit/network_boost_handover.h"
   2. #include <cstdio>
   ```
2. CMakeLists.txt中添加以下lib，具体请见[C API开发准备](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/networkboost-preparations#section16821202143413)。

   收起

   自动换行

   深色代码主题

   复制

   ```
   1. libnetwork_boost.so
   ```
3. 发起多网请求，同步监听多网状态可以获取多网的状态信息。

   收起

   自动换行

   深色代码主题

   复制

   ```
   1. void onMultiPathRequestResultCallback(NetworkBoost_MultiPathRequestResult* result)
   2. {
   3. // 多网请求的结果处理
   4. }

   6. int32_t ReleasetMultipath()
   7. {
   8. // 发起多网请求
   9. int32_t ret = HMS_NetworkBoost_RequestMultiPath(onMultiPathRequestResultCallback);
   10. printf("注册多网建议监听回调结果: %d, Id：%d\n", ret, callbackId);
   11. return ret;
   12. }
   ```
4. 当应用业务流程结束，通过ReleasetMultipath接口释放多网。

   收起

   自动换行

   深色代码主题

   复制

   ```
   1. int32_t ReleasetMultipath()
   2. {
   3. // 释放多网请求
   4. int32_t ret = HMS_NetworkBoost_ReleaseMultiPath();
   5. printf("释放多网请求结果: %d\n", ret);
   6. return ret;
   7. }
   ```