入門(mén)使用
保持和恢復(fù)音頻通話(huà)
更新時(shí)間：2019-11-20
描述
用戶(hù)可以將正在進(jìn)行的音頻通話(huà)保持，待需要的時(shí)候再恢復(fù)通話(huà)，能減少撥號(hào)次數(shù)，使用更方便。
音頻通話(huà)已建立，主被叫正在通話(huà)中。
業(yè)務(wù)流程
圖1 保持和恢復(fù)音頻通話(huà)流程
保持通話(huà)
說(shuō)明：
通話(huà)中，主被叫雙方均可以發(fā)起保持通話(huà)操作。
-
請(qǐng)求發(fā)起方UI調(diào)用tsdk_hold_call()接口保持通話(huà)。
代碼示例：
-(BOOL)holdCallWithCallId:(unsigned int)callId { TSDK_RESULT ret = tsdk_hold_call(callId); DDLogInfo(@"Call_Log: tsdk_hold_call = %@",(TSDK_SUCCESS == ret)?@"YES":@"NO"); return ret == TSDK_SUCCESS ? YES : NO; } -
請(qǐng)求方SDK發(fā)送保持通話(huà)請(qǐng)求，與業(yè)務(wù)服務(wù)器和被請(qǐng)求方完成通話(huà)保持交互處理，請(qǐng)求方SDK向UI上報(bào)保持通話(huà)成功事件TSDK_E_CALL_EVT_HOLD_SUCCESS，對(duì)應(yīng)事件數(shù)據(jù)結(jié)構(gòu)TSDK_S_CALL_INFO中，TSDK_E_CALL_STATE 標(biāo)識(shí)呼叫狀態(tài)為T(mén)SDK_E_CALL_STATE_HOLD，UI刷新界面提示當(dāng)前通話(huà)保持中，并顯示恢復(fù)通話(huà)入口；被請(qǐng)求方UI界面不感知當(dāng)前通話(huà)被保持，依然處于通話(huà)態(tài)。
說(shuō)明：
- 保持通話(huà)可能由于服務(wù)器權(quán)限或當(dāng)前通話(huà)業(yè)務(wù)限制，導(dǎo)致用戶(hù)保持通話(huà)失敗，此時(shí)SDK向UI上報(bào)保持通話(huà)失敗事件TSDK_E_CALL_EVT_HOLD_FAILED，TSDK_S_CALL_INFO中，TSDK_E_CALL_STATE 標(biāo)識(shí)呼叫狀態(tài)為T(mén)SDK_E_CALL_STATE_LIVE,通話(huà)中；
- 在業(yè)務(wù)服務(wù)器支持播放保持提示音時(shí)，被保持方可以聽(tīng)到由服務(wù)器側(cè)播放的保持提示音；
- 為了較優(yōu)的業(yè)務(wù)體驗(yàn)，建議在通話(huà)保持時(shí)，UI屏蔽掛斷通話(huà)入口。
代碼示例：case TSDK_E_CALL_EVT_HOLD_SUCCESS: { DDLogInfo(@"TSDK_E_CALL_EVT_HOLD_SUCCESS"); NSDictionary *resultInfo = @{ TSDK_CALL_HOLD_RESULT_KEY:[NSNumber numberWithBool:YES], CALL_ID : callId }; [self respondsCallDelegateWithType:CALL_HOLD_RESULT result:resultInfo]; break; }
恢復(fù)通話(huà)
說(shuō)明：
保持通話(huà)發(fā)起方才可進(jìn)行恢復(fù)通話(huà)操作。
-
請(qǐng)求發(fā)起方UI調(diào)用tsdk_unhold_call()接口恢復(fù)處于保持態(tài)的通話(huà)。
代碼示例：
-(BOOL)unHoldCallWithCallId:(unsigned int)callId { TSDK_RESULT ret = tsdk_unhold_call(callId); return ret == TSDK_SUCCESS ? YES : NO; } -
請(qǐng)求方SDK發(fā)送恢復(fù)通話(huà)請(qǐng)求，與業(yè)務(wù)服務(wù)器和被請(qǐng)求方完成通話(huà)恢復(fù)交互處理，請(qǐng)求方SDK向UI上報(bào)恢復(fù)通話(huà)成功事件TSDK_E_CALL_EVT_UNHOLD_SUCCESS，對(duì)應(yīng)事件數(shù)據(jù)結(jié)構(gòu)對(duì)應(yīng)事件數(shù)據(jù)結(jié)構(gòu)TSDK_S_CALL_INFO中，TSDK_E_CALL_STATE 標(biāo)識(shí)呼叫狀態(tài)為T(mén)SDK_E_CALL_STATE_LIVE，UI刷新界面顯示通話(huà)中。
說(shuō)明：
恢復(fù)通話(huà)可能由于網(wǎng)絡(luò)側(cè)極低概率的沖突或異常，導(dǎo)致用戶(hù)恢復(fù)通話(huà)失敗，此時(shí)SDK向UI上報(bào)恢復(fù)通話(huà)失敗事件TSDK_E_CALL_EVT_UNHOLD_FAILED，并自動(dòng)掛斷通話(huà)。
代碼示例：case TSDK_E_CALL_EVT_UNHOLD_SUCCESS: { DDLogInfo(@"TSDK_E_CALL_EVT_UNHOLD_SUCCESS"); NSDictionary *resultInfo = @{ TSDK_CALL_UNHOLD_RESULT_KEY:[NSNumber numberWithBool:YES], CALL_ID : callId }; [self respondsCallDelegateWithType:CALL_UNHOLD_RESULT result:resultInfo]; break; }
注意事項(xiàng)
因通話(huà)雙方均可以在本端處于通話(huà)態(tài)發(fā)起保持操作，即通話(huà)可能會(huì)處于雙向保持態(tài)，在任一保持方發(fā)起恢復(fù)通話(huà)時(shí)，僅能恢復(fù)本端通話(huà)狀態(tài)，不會(huì)恢復(fù)對(duì)端的通話(huà)狀態(tài)。
