更新时间:2024-01-24 GMT+08:00
分享

开启功能

EnableFeature

接口描述

Windows SDK中有些功能特性是通过开关控制是否打开的,该接口用于配置这些功能的打开或者关闭。

注意事项

  1. 枚举中的功能项均有默认值,若对开关状态不做要求,可以不必调用该接口。
  2. 该接口为异步接口,返回值只代表接口是否调用成功,实际业务处理结果在对应的回调函数中返回。

方法定义

1
HWM_SDK_AGENT_API hwmsdk::HwmErrCode EnableFeature(HwmEnableFeatureType type, bool isEnable);

回调函数

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

参数描述

表1 参数说明

参数

是否必须

类型

描述

type

HwmEnableFeatureType

功能开关枚举。

isEnable

bool

开关状态。

表2 枚举HwmEnableFeatureType说明

枚举值

描述

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降频检测功能开关。默认为关。

返回值

表3 返回值

类型

描述

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"));
    }
}
分享:

    相关文档

    相关产品