入門使用
漸進式會議
更新時間：2019-11-20
兩方通話轉會議
描述
用戶在點對點通話過程中發(fā)起轉會議，或邀請第三方（或更多）加入通話。
前提條件：
- 鑒權登錄成功。
- SIP號碼已成功注冊。
- 會議環(huán)境參數已設置。
業(yè)務流程
圖1 兩方通話轉會議流程
-
會議發(fā)起方UI調用tsdk_p2p_transfer_to_conference()發(fā)起通話轉會議，會議參數結構為TSDK_S_BOOK_CONF_INFO，SDK先發(fā)送創(chuàng)建會議請求至會議服務器。
代碼示例：
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; - 發(fā)起方SDK在收到服務器返回的立即會議創(chuàng)建響應后，向UI上報會議創(chuàng)建結果通知TSDK_E_CONF_EVT_BOOK_CONF_RESULT。
-
會議發(fā)起方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*/ } - 通話雙方SDK完成通話轉會議處理，向UI上報會議創(chuàng)建結果通知TSDK_E_CONF_EVT_JOIN_CONF_RESULT，對應的結果數據結構為TSDK_S_JOIN_CONF_IND_INFO，并返回conf handle，后續(xù)會控時使用，此時， UI可跳轉至會議界面。
- 所有與會者側SDK收到會議狀態(tài)更新通知，向UI上報會議信息及狀態(tài)狀態(tài)更新事件TSDK_E_CONF_EVT_INFO_AND_STATUS_UPDATE，UI刷新會議成員列表和會議信息。
注意事項
無。
升級會議
描述
- “語音會議”升級至“語音+數據會議”。
- “視頻會議”升級至“視頻+數據會議”。
暫不支持“語音會議”升級至“語音+視頻會議”。
與會者通過主席身份加入會議，或已申請獲取為主席。
業(yè)務流程
圖2 升級會議流程
-
會議主席側UI調用tsdk_upgrade_conference()升級會議。
代碼示例：
-(BOOL)confCtrlVoiceUpgradeToDataConference:(BOOL)hasVideo { int result = tsdk_upgrade_conference(_confHandle, NULL); return result == TSDK_SUCCESS ? YES : NO; } - 發(fā)起方SDK在收到服務器返回的會議升級響應后，向UI上報會議升級結果通知TSDK_E_CONF_EVT_CONFCTRL_OPERATION_RESULT。
-
所有與會者側SDK收到TSDK_E_CONF_EVT_INFO_AND_STATUS_UPDATE 向UI上報會議狀態(tài)信息，結構體為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; - SDK自動獲取數據會議入會參數，向UI上報數據會議入會參數獲取結果TSDK_E_CONF_EVT_GET_DATACONF_PARAM_RESULT，UI應調用tsdk_join_data_conference()接口加入數據會議。
注意事項
無。
