全部產品
Search
文件中心

Intelligent Media Services:對講機模式

更新時間:Feb 03, 2026

通過閱讀本文,您可以瞭解如何通過AICallKit SDK實現對講機模式。

使用說明

對講機模式效果預覽

開啟對講機模式

將交談模式從自然交談模式切換至對講機模式。

45050f7ef32c1acc391ab1b18c7b171e

開始說話

按下並保持講話按鈕,以開始與智能體進行交流。

lQDPJww8JdHXqQHNCMbNBDiwZR5mz6fv448HV0koHPV0AA_1080_2246

說明

該功能以及UI介面均在含UI整合方案中內建。含UI整合方案詳情,請參見含UI整合方案

實現對講機功能

在對講機模式下,使用者的每一次輸入與智能體的每一次響應均為獨立事件,此模式類似於傳統對講機的使用方式。在這種模式下,使用者與智能體之間的交流顯得更加結構化且有序。通過對講機模式,使用者能夠以更高效、更有組織的方式與智能體進行互動。

API詳情

API

描述

enablePushToTalk

開啟/關閉對講機模式,同時智能體的最終對講機狀態會通過onPushToTalk回調出來,最終的開關以回調為準。

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);
});