跳到主要内容

多网发起和释放(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;
    }