更新时间:2024-07-30 GMT+08:00

网络模式设置

SetNetworkMode

接口描述

如华为云会议的媒体节点下沉部署到企业,并且管理节点也是通过企业内的代理访问,需要将网络模式设置成“企业内网接入”。

企业内的App无法直接访问公网(即媒体节点下沉和管理节点代理下沉场景)的情况下才需要调用该接口。

注意事项

  1. 该接口非必需调用,若不设置,则使用默认模式。
  2. 该接口为异步接口,返回值只代表接口是否调用成功,实际业务处理结果在对应的回调函数中返回。

方法定义

1
HWM_SDK_AGENT_API hwmsdk::HwmErrCode SetNetworkMode(const HwmNetWorkModeInfo* networkInfo);

回调函数

1
virtual void OnSetNetworkModeResult(hwmsdk::HwmErrCode ret, const char* reason) {};

参数描述

表1 参数说明

参数

是否必须

类型

描述

networkInfo

HwmNetWorkModeInfo

网络模式信息。

表2 结构体HwmNetWorkModeInfo参数说明

参数

是否必须

类型

描述

accessType

HwmNetworkAccessType

网络接入类型。

netConnectType

HwmNetConnectType

网络连接类型。

表3 枚举HwmNetworkAccessType参数说明

枚举值

描述

ACCESS_TYPE_AUTO

默认值,目前和企业外网接入模式一致。

ACCESS_TYPE_INNER

企业内网接入,用于媒体和信令下沉场景,app从内网接入,信令/媒体消息走代理服务器才能访问云会议服务端。

ACCESS_TYPE_OUTER

企业外网接入,用于非媒体和信令下沉场景,互联网接入,信令/媒体消息可以直接访问云会议服务端。

表4 枚举HwmNetConnectType参数说明

枚举值

描述

NET_CONNECT_AUTO

默认值,自动模式。

NET_CONNECT_FORCE_VPN

强制vpn。

NET_CONNECT_FORCE_DIRECT

强制直连。

返回值

表5 返回值

类型

描述

HwmErrCode

成功返回0,其他值表示失败。失败返回值见错误码参考

示例代码

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
/**
* 设置网络模式
*/
void demoSetNetworkModeDlg::SetNetworkMode()
{
    hwmsdkagent::HwmNetWorkModeInfo networkMode{};
    networkMode.accessType = hwmsdkagent::HwmNetworkAccessType::ACCESS_TYPE_AUTO;
    int ret = hwmsdkagent::SetNetworkMode(&networkMode);
    if (hwmsdk::HWM_COMMON_SUCCESS != ret)
    {
        AfxMessageBox(_T("Set network mode failed"));
    }
}