网络模式设置
SetNetworkMode
接口描述
如华为云会议的媒体节点下沉部署到企业,并且管理节点也是通过企业内的代理访问,需要将网络模式设置成“企业内网接入”。
企业内的App无法直接访问公网(即媒体节点下沉和管理节点代理下沉场景)的情况下才需要调用该接口。
注意事项
- 该接口非必需调用,若不设置,则使用默认模式。
- 该接口为异步接口,返回值只代表接口是否调用成功,实际业务处理结果在对应的回调函数中返回。
方法定义
1
|
HWM_SDK_AGENT_API hwmsdk::HwmErrCode SetNetworkMode(const HwmNetWorkModeInfo* networkInfo); |
回调函数
1
|
virtual void OnSetNetworkModeResult(hwmsdk::HwmErrCode ret, const char* reason) {}; |
参数描述
参数 |
是否必须 |
类型 |
描述 |
---|---|---|---|
networkInfo |
是 |
HwmNetWorkModeInfo |
网络模式信息。 |
参数 |
是否必须 |
类型 |
描述 |
---|---|---|---|
accessType |
是 |
HwmNetworkAccessType |
网络接入类型。 |
netConnectType |
是 |
HwmNetConnectType |
网络连接类型。 |
枚举值 |
描述 |
---|---|
ACCESS_TYPE_AUTO |
默认值,目前和企业外网接入模式一致。 |
ACCESS_TYPE_INNER |
企业内网接入,用于媒体和信令下沉场景,app从内网接入,信令/媒体消息走代理服务器才能访问云会议服务端。 |
ACCESS_TYPE_OUTER |
企业外网接入,用于非媒体和信令下沉场景,互联网接入,信令/媒体消息可以直接访问云会议服务端。 |
枚举值 |
描述 |
---|---|
NET_CONNECT_AUTO |
默认值,自动模式。 |
NET_CONNECT_FORCE_VPN |
强制vpn。 |
NET_CONNECT_FORCE_DIRECT |
强制直连。 |
返回值
类型 |
描述 |
---|---|
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")); } } |