开启功能
EnableFeature
接口描述
Windows SDK中有些功能特性是通过开关控制是否打开的，该接口用于配置这些功能的打开或者关闭。
注意事项
- 枚举中的功能项均有默认值，若对开关状态不做要求，可以不必调用该接口。
- 该接口为异步接口，返回值只代表接口是否调用成功，实际业务处理结果在对应的回调函数中返回。
方法定义
1
|
HWM_SDK_AGENT_API hwmsdk::HwmErrCode EnableFeature(HwmEnableFeatureType type, bool isEnable); |
回调函数
1
|
virtual void OnEnableFeature(hwmsdk::HwmErrCode ret, const char* msg) {}; |
参数描述
|
参数 |
是否必须 |
类型 |
描述 |
|---|---|---|---|
|
type |
是 |
HwmEnableFeatureType |
功能开关枚举。 |
|
isEnable |
是 |
bool |
开关状态。 |
|
枚举值 |
描述 |
|---|---|
|
HWM_ENABLE_FEATURE_TYPE_MULTI_MONITOR |
是否启动多显示器模式开关。在多显示器场景下，在两个显示器上同时显示桌面共享窗口和视频窗口；在单显示器模式下，开启共享后，隐藏视频窗口。默认为关。 |
|
HWM_ENABLE_FEATURE_TYPE_SHOW_HANGUP_ATTENDEE |
是否在与会者窗口上显示离会的与会者开关。默认为开。 |
|
HWM_ENABLE_FEATURE_TYPE_HOWLING_DETECTION |
是否启用啸叫抑制开关状态。默认为开。 |
|
HWM_ENABLE_FEATURE_TYPE_HIGH_RESOLUTION |
是否启用会议中大画面的1080P高清显示。默认为开。 |
|
HWM_ENABLE_FEATURE_TYPE_MIC_SWITCH |
麦克风在会议中的初始化开关状态。默认为开。 |
|
HWM_ENABLE_FEATURE_TYPE_CAM_SWITCH |
摄像头在会议中的初始化开关状态。默认为关。 |
|
HWM_ENABLE_FEATURE_TYPE_HIDE_EXTERNAL_LABEL |
外部标签在会议中的显示/隐藏状态。默认为关(显示外部标签)。 |
|
HWM_ENABLE_FEATURE_AUTO_MIC_VOLUME |
自动麦克风音量调整开关，默认为开，如果外接麦克风设备自带有AGC效果时建议关闭 |
|
HWM_ENABLE_FEATURE_BREAKOUT_CONF |
分组讨论功能开关状态。默认为开。 |
|
HWM_ENABLE_FEATURE_CONFIRM_RECORD |
录制确认开关状态。默认为关。 |
|
HWM_ENABLE_FEATURE_DEFAULT_SHARE_AUDIO |
共享音频开关。默认为关。 |
|
HWM_ENABLE_FEATURE_SUPPORT_DISCONNECT_AUDIO |
断开音频功能开关。默认为关。 |
|
HWM_ENABLE_FEATURE_DISCONNECT_AUDIO_TO_JOIN_CONF |
断开音频入会功能开关。默认为关。 |
|
HWM_ENABLE_FEATURE_CPU_REDUCTION_DETECT |
启用CPU降频检测功能开关。默认为关。 |
|
HWM_ENABLE_FEATURE_SUPPORT_GUEST_INVITE |
是否支持与会者邀请功能开关。默认为关。 |
返回值
|
类型 |
描述 |
|---|---|
|
HwmErrCode |
成功返回0，其他值表示失败。失败返回值见错误码参考。 |
示例代码
1 2 3 4 5 6 7 8 9 10 11 12 |
/** * 多显示器模式开关配置 */ void demoEnableFeatureDlg::OnBnClickedButtonMultiMonitor() { bool isCheck = true; int ret = hwmsdkagent::EnableFeature(hwmsdkagent::HWM_ENABLE_FEATURE_TYPE_MULTI_MONITOR, isCheck); if (hwmsdk::HWM_COMMON_SUCCESS != ret) { AfxMessageBox(_T("Enable multi monitor failed")); } } |
