华为云首页用户手册 H

华为云会议 Meeting-发起投屏:StartProjection

时间：2025-02-12 15:11:45

华为云会议 Meeting

StartProjection

接口描述

该接口用于发起投屏。

注意事项

该接口在已登录状态下才能调用。
该接口为异步接口，返回值只代表接口是否调用成功，实际业务处理结果在对应的回调函数中返回。

方法定义

  
       HWM_SDK_AGENT_API hwmsdk::HwmErrCode StartProjection(const HwmStartProjectionParam *startProjectionParam);

回调函数

  
       virtual void OnStartProjectionResult(hwmsdk::HwmErrCode ret, const char* reason, const HwmStartProjectionResult *startProjectionResult) {};

参数描述

参数	是否必须	类型	描述
startProjectionParam	是	HwmStartProjectionParam	发起投屏参数。

表1 结构体HwmStartProjectionParam参数说明
参数	是否必须	类型	描述
pairCode	是	char[]	配对码。
randomNumber	否	char[]	随机数，跨企业投屏场景需要携带。跨企业投屏时，只输入pairCode，投屏失败，回调结果返回错误码222020012，startProjectionResult中上报randomNumber，填充此字段，二次投屏
verifyCode	否	char[]	验证码，跨企业投屏场景需要携带。跨企业投屏时，只输入pairCode，投屏失败，回调结果返回错误码222020012，查看被投屏端的验证码，填充此字段，二次投屏

返回值

表2 返回值
类型	描述
HwmErrCode	成功返回0，其他值表示失败。失败返回值见错误码参考。
HwmStartProjectionResult	发起投屏结果。

表3 结构体HwmStartProjectionResult参数说明
参数	类型	描述
randomNumber	char[]	随机数。跨企业投屏场景下返回，用于二次投屏

示例代码

  
       /*** 发起投屏*/int demoStartProjectionDlg::clickStartProjection(){    m_pairCodeEdit.GetWindowText(m_pairCode);    m_randomNumberEdit.GetWindowText(m_randomNumber);    m_verifyCodeEdit.GetWindowText(m_verifyCode);    std::string pairCode = CTools::UNICODE2UTF(m_pairCode.GetString());    std::string randomNumber = CTools::UNICODE2UTF(m_randomNumber.GetString());    std::string verifyCode = CTools::UNICODE2UTF(m_verifyCode.GetString());    hwmsdkagent::HwmStartProjectionParam data{};    strncpy_s(data.pairCode, pairCode.c_str(), sizeof(data.pairCode));    strncpy_s(data.randomNumber, randomNumber.c_str(), sizeof(data.randomNumber));    strncpy_s(data.verifyCode, verifyCode.c_str(), sizeof(data.verifyCode));    hwmsdk::HwmErrCode ret = hwmsdkagent::StartProjection(&data);    if (ret != hwmsdk::HWM_COMMON_SUC CES S)    {        CTools::OutputRetStr("Start projection error");        return;    }    return ret;}