华为云首页用户手册

华为云会议 MEETING-发起立即会议:StartP2pConf

时间：2024-10-28 14:49:50

华为云会议 MEETING

StartP2pConf

接口描述

该接口用于发起立即会议。

注意事项

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

方法定义

  
       HWM_SDK_AGENT_API hwmsdk::HwmErrCode StartP2pConf(const HwmP2PStartCallInfo *startCallInfo);

回调函数

  
       virtual void OnStartP2pConfResult(hwmsdk::HwmErrCode ret, const char* reason, HwmConfInfo *confInfo) {};

参数描述

参数	是否必须	类型	描述
startCallInfo	是	HwmP2PStartCallInfo	发起立即会议信息。

表1 结构体HwmP2PStartCallInfo参数说明
参数	是否必须	类型	描述
callerInfo	是	HwmCallerInfo	主叫信息。
calleeInfo	是	HwmCalleeInfo	被叫信息。
mediaType	是	HwmMediaType	媒体类型。

表2 结构体HwmCallerInfo参数说明
参数	是否必须	类型	描述
nickName	否	char[]	主叫名称。

表3 结构体HwmCalleeInfo参数说明
参数	是否必须	类型	描述
nickName	否	char[]	被叫名称。
number	是	char[]	号码。如果填分配给账号的sip号码（如+99111244216210249）则呼叫该账号的App；如果填PSTN号码（如18700000000），则通过VoIP网关呼叫该号码，前提是该企业已开通PSTN呼叫权限。与thirdUserId二选一，账号密码鉴权时使用。
thirdUserId	是	char[]	第三方用户ID。与number二选一，App ID鉴权时使用。
userUuid	否	char[]	与会者uuid

返回值

表4 返回值
类型	描述
HwmErrCode	成功返回0，其他值表示失败。失败返回值见错误码参考。
HwmConfInfo	会议信息。

示例代码

  
   
     
     
       /**
* 发起立即会议
*/
int demoStartP2pConfDlg::clickStartP2pConf()
{
    hwmsdkagent::HwmP2PStartCallInfo data{};
    
    //设置主叫信息
    string callerNickName = CTools::UNICODE2UTF( CS tring("主叫名称"));
    strncpy_s(data.callerInfo.nickName, callerNickName.c_str(), HWM_MAX_DISPLAY_NAME_LEN);
    //设置被叫信息
    string calleeNickName = CTools::UNICODE2UTF(CString("被叫名称"));
    strncpy_s(data.calleeInfo.nickName, calleeNickName.c_str(), HWM_MAX_DISPLAY_NAME_LEN);
    string calleeNumber = CTools::UNICODE2UTF(CString("123456"));
    strncpy_s(data.calleeInfo.number, calleeNumber.c_str(), HWM_MAX_NUMBER_LEN);
    string calleeThirdUserId = CTools::UNICODE2UTF(CString("123456"));
    strncpy_s(data.calleeInfo.calleeThirdUserId, calleeThirdUserId.c_str(), HWM_MAX_USER_ID_LEN);
    //设置媒体类型
    data.mediaType = hwmsdkagent::HWM_MEDIA_TYPE_VIDEO
    
    //调用SDK接口
    int ret = hwmsdkagent::StartP2pConf(&data);
    return ret;
}

      

    

  
 