两方通话转会议

描述

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

前提条件：

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

业务流程

图1 两方通话转会议流程 

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

   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需要清理原通话的相关界面资源。

   代码示例：

   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()升级会议。
   代码示例：

   -(BOOL)confCtrlVoiceUpgradeToDataConference:(BOOL)hasVideo
   {    
       int result = tsdk_upgrade_conference(_confHandle, NULL);       
       return result == TSDK_SUCCESS ? YES : NO;
   }

    
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。
   代码示例：

   case TSDK_E_CONF_EVT_INFO_AND_STATUS_UPDATE:        
   {            
       DDLogInfo(@"TSDK_E_CONF_EVT_INFO_AND_STATUS_UPDATE");                        
       [self handleAttendeeUpdateNotify:notify];        
   }           
   break;

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

注意事项

无。