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

开启共享

StartShare

接口描述

该接口用于开启会议共享。SDK的UI已经实现了“共享”功能,如果第三方App不需要通过程序控制开启共享,则不用调用该接口。

注意事项

  1. 不在会议中调用该接口将返回失败。
  2. 该接口为异步接口,返回值只代表接口是否调用成功,实际业务处理结果在对应的回调函数中返回。

方法定义

1
HWM_SDK_AGENT_API hwmsdk::HwmErrCode StartShare(HwmStartShareInfo *startShareInfo);

回调函数

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

参数描述

表1 结构体HwmStartShareInfo参数说明

参数

是否必须

类型

描述

shareType

enum

共享类型。

monitorShareInfo

HwmMonitorShareInfo

屏幕共享信息。当共享类型不是屏幕共享时,该变量不需要赋值。

appShareInfo

HwmAppShareInfo

程序共享信息。当共享类型不是程序共享时,该变量不需要赋值。

operatableUiMonitor

HwmMonitor

共享时,工具栏所在的显示器。若值为0,则不指定显示器。

表2 枚举HwmShareType说明

枚举值

描述

HWM_SHARE_TYPE_MONITOR

屏幕共享。

HWM_SHARE_TYPE_APP

程序共享。

表3 结构体HwmMonitorShareInfo参数说明

参数

是否必须

类型

描述

monitor

HwmMonitor

显示器类型。

表4 枚举HwmMonitor说明

枚举值

描述

HWM_MONITOR_MAIN

主显示器。

HWM_MONITOR_SECONDARY

副显示器。

表5 结构体HwmAppShareInfo参数说明

参数

是否必须

类型

描述

appHandle

HWND

程序句柄。

返回值

表6 返回值

类型

描述

HwmErrCode

成功返回0,其他值表示失败。失败返回值见错误码参考

示例代码

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
/**
* 开启共享
*/
int demoStartShareDlg::clickStartShare()
{
    hwmsdkagent::HwmStartShareInfo data;
    memset(&data, 0, sizeof(hwmsdkagent::HwmStartShareInfo));
    //设置共享类型
    data.shareType = hwmsdkagent::HwmShareType::HWM_SHARE_TYPE_MONITOR;
    //设置共享的显示器
    data.monitorShareInfo.monitor = hwmsdkagent::HWM_MONITOR_MAIN;
    //设置工具栏所在的显示器
    data.operatableUiMonitor = hwmsdkagent::HWM_MONITOR_MAIN;
    
    int ret = hwmsdkagent::StartShare(&data);
    return ret;
}
分享:

    相关文档

    相关产品