# 多网发起和释放(C/C++)

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

#### 场景介绍

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

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

#### 开发前准备

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

#### 接口说明

具体API说明详见接口文档。

| 接口名 | 描述 |
| --- | --- |
| int32_t HMS_NetworkBoost_RequestMultiPath(HMS_NetworkBoost_OnMultiPathRequestResult result) | 发起多网请求。 |
| int32_t HMS_NetworkBoost_ReleaseMultiPath() | 释放多网请求。 |

#### 开发步骤

1.  导入Network Boost Kit模块。
    
    ```
    #include "NetworkBoostKit/network_boost_handover.h"
    #include <cstdio>
    ```
    
2.  CMakeLists.txt中添加以下lib，具体请见C API开发准备。
    
    ```
    libnetwork_boost.so
    ```
    
3.  发起多网请求，同步监听多网状态可以获取多网的状态信息。
    
    ```
    void onMultiPathRequestResultCallback(NetworkBoost_MultiPathRequestResult* result)
    {
        // 多网请求的结果处理
    }
    
    int32_t RequestMultiPath()
    {
        // 发起多网请求
        int32_t ret = HMS_NetworkBoost_RequestMultiPath(onMultiPathRequestResultCallback);
        printf("注册多网建议监听回调结果: %d\n", ret);
        return ret;
    }
    ```
    
4.  当应用业务流程结束，通过ReleasetMultipath接口释放多网。
    
    ```
    int32_t ReleasetMultipath()
    {
        // 释放多网请求
        int32_t ret = HMS_NetworkBoost_ReleaseMultiPath();
        printf("释放多网请求结果: %d\n", ret);
        return ret;
    }
    ```