通過閱讀本文,您可以瞭解如何通過AICallKit SDK實現對講機模式。
使用說明
本樣本主要旨在協助您在不含UI整合的情況下,如何利用API實現該功能。
您需要提前整合AICallkit SDK。如何整合,請參見Android整合概覽、iOS整合概覽、Web整合概覽。
對講機模式效果預覽
開啟對講機模式 將交談模式從自然交談模式切換至對講機模式。
| 開始說話 按下並保持講話按鈕,以開始與智能體進行交流。
|
說明
該功能以及UI介面均在含UI整合方案中內建。含UI整合方案詳情,請參見含UI整合方案。
實現對講機功能
在對講機模式下,使用者的每一次輸入與智能體的每一次響應均為獨立事件,此模式類似於傳統對講機的使用方式。在這種模式下,使用者與智能體之間的交流顯得更加結構化且有序。通過對講機模式,使用者能夠以更高效、更有組織的方式與智能體進行互動。
API詳情
API | 描述 |
enablePushToTalk | 開啟/關閉對講機模式,同時智能體的最終對講機狀態會通過 |
startPushToTalk | 按住開始講話。僅在開啟對講機模式後,此調用才有效。在此期間,智能體將不會觸發斷句,並且其狀態將始終保持在聆聽狀態,將即時輸出使用者的講話字幕。 說明 建議在按鈕按下事件調用該API,不要在鬆開事件裡調用。 |
finishPushToTalk | 鬆開完成此輪次講話,智能體會進入思考狀態,並很快播報結果。 |
cancelPushToTalk | 鬆開取消此次講話,智能體不做任何處理,立即回到等待按住開始講話狀態。 |
範例程式碼
Android
// 預設情況下是關閉對講機模式,傳入true開啟對講機模式
mARTCAICallEngine.enablePushToTalk(enable: true)
// 按住開始講話
mARTCAICallEngine.startPushToTalk()
// 鬆開完成此輪次講話
mARTCAICallEngine.finishPushToTalk()
// 鬆開取消此次講話
mARTCAICallEngine.cancelPushToTalk()
// 回調處理(僅樣本相關的回調操作)
ARTCAICallEngine.IARTCAICallEngineCallback mCallEngineCallbackWrapper = new ARTCAICallEngine.IARTCAICallEngineCallback() {
@Override
public void onPushToTalk(boolean enable) {
// 當前通話的對講機模式是否啟用回調
// 最終是否開啟/關閉,以該回調為準
}
}iOS
// 預設情況下是關閉對講機模式,傳入true開啟對講機模式
_ = self.engine.enablePushToTalk(enable: true)
// 按住開始講話
_ = self.engine.startPushToTalk()
// 鬆開完成此輪次講話
_ = self.engine.finishPushToTalk()
// 鬆開取消此次講話
_ = self.engine.cancelPushToTalk()
func onPushToTalk(enable: Bool) {
// 當前通話的對講機模式是否啟用回調
// 最終是否開啟/關閉,以該回調為準
}
Web
// 預設情況下是關閉對講機模式,傳入true開啟對講機模式
engine.enablePushToTalk(enable);
// 按住開始講話
engine.startPushToTalk();
// 鬆開完成此輪次講話
engine.finishPushToTalk();
// 鬆開取消此次講話
engine.cancelPushToTalk();
engine.on('pushToTalkChanged', (enable) => {
// 當前通話的對講機模式是否啟用回調
// 最終是否開啟/關閉,以該回調為準
console.log('AICallPushToTalk', enable);
});
