入門使用
漸進(jìn)式會(huì)議
更新時(shí)間：2019-11-20
兩方通話轉(zhuǎn)會(huì)議
描述
用戶在點(diǎn)對(duì)點(diǎn)通話過(guò)程中發(fā)起轉(zhuǎn)會(huì)議，或邀請(qǐng)第三方（或更多）加入通話。
前提條件：
- 鑒權(quán)登錄成功。
- SIP號(hào)碼已成功注冊(cè)。
- 會(huì)議環(huán)境參數(shù)已設(shè)置。
業(yè)務(wù)流程
兩方通話轉(zhuǎn)會(huì)議
圖1 兩方通話轉(zhuǎn)會(huì)議流程
-
會(huì)議發(fā)起方UI調(diào)用tsdk_p2p_transfer_to_conference()發(fā)起通話轉(zhuǎn)會(huì)議，會(huì)議參數(shù)結(jié)構(gòu)為TSDK_S_BOOK_CONF_INFO，SDK先發(fā)送創(chuàng)建會(huì)議請(qǐng)求至?xí)h服務(wù)器。
代碼示例：
//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;
- 發(fā)起方SDK在收到服務(wù)器返回的立即會(huì)議創(chuàng)建響應(yīng)后，向UI上報(bào)會(huì)議創(chuàng)建結(jié)果通知TSDK_E_CONF_EVT_BOOK_CONF_RESULT。
-
會(huì)議發(fā)起方SDK完成通話轉(zhuǎn)會(huì)議處理，自動(dòng)掛斷原通話，向UI上報(bào)通話轉(zhuǎn)會(huì)議結(jié)果事件TSDK_E_CONF_EVT_TRANS_TO_CONF_RESULT，攜帶原通話標(biāo)識(shí)callID。
說(shuō)明：
若轉(zhuǎn)會(huì)議失敗，原通話仍存在，UI需要使用原通話標(biāo)識(shí)callID恢復(fù)原通話界面；若轉(zhuǎn)會(huì)議成功，則UI需要清理原通話的相關(guān)界面資源。
代碼示例：//c code case TSDK_E_CONF_EVT_TRANS_TO_CONF_RESULT: { /*Notify UI*/ }
- 通話雙方SDK完成通話轉(zhuǎn)會(huì)議處理，向UI上報(bào)會(huì)議創(chuàng)建結(jié)果通知TSDK_E_CONF_EVT_JOIN_CONF_RESULT，對(duì)應(yīng)的結(jié)果數(shù)據(jù)結(jié)構(gòu)為TSDK_S_JOIN_CONF_IND_INFO，并返回conf handle，后續(xù)會(huì)控時(shí)使用，此時(shí)， UI可跳轉(zhuǎn)至?xí)h界面。
- 所有與會(huì)者側(cè)SDK收到會(huì)議狀態(tài)更新通知，向UI上報(bào)會(huì)議信息及狀態(tài)狀態(tài)更新事件TSDK_E_CONF_EVT_INFO_AND_STATUS_UPDATE，UI刷新會(huì)議成員列表和會(huì)議信息。
注意事項(xiàng)
無(wú)。
升級(jí)會(huì)議
描述
- “語(yǔ)音會(huì)議”升級(jí)至“語(yǔ)音+數(shù)據(jù)會(huì)議”。
- “視頻會(huì)議”升級(jí)至“視頻+數(shù)據(jù)會(huì)議”。
暫不支持“語(yǔ)音會(huì)議”升級(jí)至“語(yǔ)音+視頻會(huì)議”。
與會(huì)者通過(guò)主席身份加入會(huì)議，或已申請(qǐng)獲取為主席。
業(yè)務(wù)流程
升級(jí)會(huì)議
圖2 升級(jí)會(huì)議流程
-
會(huì)議主席側(cè)UI調(diào)用tsdk_upgrade_conference()升級(jí)會(huì)議。
代碼示例：
//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;
- 發(fā)起方SDK在收到服務(wù)器返回的會(huì)議升級(jí)響應(yīng)后，向UI上報(bào)會(huì)議升級(jí)結(jié)果通知TSDK_E_CONF_EVT_CONFCTRL_OPERATION_RESULT。
-
所有與會(huì)者側(cè)SDK收到TSDK_E_CONF_EVT_INFO_AND_STATUS_UPDATE 向UI上報(bào)會(huì)議狀態(tài)信息，結(jié)構(gòu)體為TSDK_S_CONF_STATUS_INFO。
代碼示例參見(jiàn)“更新會(huì)議狀態(tài)信息和與會(huì)者列表”描述。
- SDK自動(dòng)獲取數(shù)據(jù)會(huì)議入會(huì)參數(shù)，向UI上報(bào)數(shù)據(jù)會(huì)議入會(huì)參數(shù)獲取結(jié)果TSDK_E_CONF_EVT_GET_DATACONF_PARAM_RESULT，UI應(yīng)調(diào)用tsdk_join_data_conference()接口加入數(shù)據(jù)會(huì)議。
注意事項(xiàng)
無(wú)。
