网络模式设置

SetNetworkMode

接口描述

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

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

注意事项

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

方法定义

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

回调函数

     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，其他值表示失败。失败返回值见错误码参考。

示例代码

     /**
* 设置网络模式
*/
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"));
    }
}
 
 
  