开启功能
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 | 是否支持与会者邀请功能开关。默认为关。 |
HWM_ENABLE_FEATURE_HIDE_INVITE_RESULT_TOAST | 是否隐藏与会者邀请结果提示开关。默认为关。 |
HWM_ENABLE_FEATURE_SUPPORT_AUTO_ACCEPT_REMOTE_CONTROL | 是否支持自动接受远程控制开关。默认为关。 |
HWM_ENABLE_FEATURE_HIDE_OFFLINE_PARTICIPANT_LIST | 是否支持隐藏与会者列表“未入会”标签。默认为关。 |
HWM_ENABLE_FEATURE_HIDE_VB_RISK_TIP | 是否隐藏虚拟背景隐私风险提示。默认为关。 |
HWM_ENABLE_FEATURE_CONF_END_SHOW_TIPS | 是否会议结束显示提示。默认为关。 |
返回值
类型 | 描述 |
|---|---|
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")); } } |
