两方通话转会议

描述

用户在点对点通话过程中发起转会议，或邀请第三方（或更多）加入通话。

前提条件：

1. 鉴权登录成功。
2. SIP号码已成功注册。
3. 会议环境参数已设置。

业务流程

两方通话转会议

图1 两方通话转会议流程 

1. 会议发起方UI调用tsdk_p2p_transfer_to_conference()发起通话转会议，会议参数结构为TSDK_S_BOOK_CONF_INFO，SDK先发送创建会议请求至会议服务器。
   代码示例：

   //c code TSDK_RESULT ret; ret = tsdk_p2p_transfer_to_conference(callId,bookConfInfo); if (TSDK_SUCCESS != ret) { LOG_D_CALL_ERROR("p2p transfer to conference failed. result=%#x", ret); return -1; } return TSDK_SUCCESS;

2. 发起方SDK在收到服务器返回的立即会议创建响应后，向UI上报会议创建结果通知TSDK_E_CONF_EVT_BOOK_CONF_RESULT。
3. 会议发起方SDK完成通话转会议处理，自动挂断原通话，向UI上报通话转会议结果事件TSDK_E_CONF_EVT_TRANS_TO_CONF_RESULT，携带原通话标识callID。
   说明： 

   若转会议失败，原通话仍存在，UI需要使用原通话标识callID恢复原通话界面；若转会议成功，则UI需要清理原通话的相关界面资源。

   代码示例：

   //c code case TSDK_E_CONF_EVT_TRANS_TO_CONF_RESULT: { /*Notify UI*/ }

4. 通话双方SDK完成通话转会议处理，向UI上报会议创建结果通知TSDK_E_CONF_EVT_JOIN_CONF_RESULT，对应的结果数据结构为TSDK_S_JOIN_CONF_IND_INFO，并返回conf handle，后续会控时使用，此时， UI可跳转至会议界面。
5. 所有与会者侧SDK收到会议状态更新通知，向UI上报会议信息及状态状态更新事件TSDK_E_CONF_EVT_INFO_AND_STATUS_UPDATE，UI刷新会议成员列表和会议信息。

注意事项

无。

升级会议

描述

• “语音会议”升级至“语音+数据会议”。
• “视频会议”升级至“视频+数据会议”。

暂不支持“语音会议”升级至“语音+视频会议”。

与会者通过主席身份加入会议，或已申请获取为主席。

业务流程

升级会议

图2 升级会议流程 

1. 会议主席侧UI调用tsdk_upgrade_conference()升级会议。
   代码示例：

   //c code TSDK_RESULT ret; ret = tsdk_upgrade_conference(confHandle, upgradeParam); if (TSDK_SUCCESS != ret) { LOG_D_CALL_ERROR("update data conf failed. result=%#x", ret); return -1; } return TSDK_SUCCESS;

2. 发起方SDK在收到服务器返回的会议升级响应后，向UI上报会议升级结果通知TSDK_E_CONF_EVT_CONFCTRL_OPERATION_RESULT。
3. 所有与会者侧SDK收到TSDK_E_CONF_EVT_INFO_AND_STATUS_UPDATE 向UI上报会议状态信息，结构体为TSDK_S_CONF_STATUS_INFO。

   代码示例参见“更新会议状态信息和与会者列表”描述。

4. SDK自动获取数据会议入会参数，向UI上报数据会议入会参数获取结果TSDK_E_CONF_EVT_GET_DATACONF_PARAM_RESULT，UI应调用tsdk_join_data_conference()接口加入数据会议。

注意事项

无。