文档首页/ 华为云会议 Meeting/ 客户端SDK参考/ Windows SDK/ 接口参考/ 基础配置/ 开启功能
更新时间：2024-06-28 GMT+08:00
查看PDF
分享

开启功能

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

HWM_ENABLE_FEATURE_SUPPORT_GUEST_INVITE

是否支持与会者邀请功能开关。默认为关。

返回值

表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"));
    }
}
父主题： 基础配置

相关文档