> Discover all available pages from the documentation index: https://mastra.zisheng.pro/zh-TW/llms.txt

# Voice 事件

語音 Provider 會在即時語音互動期間發出事件。你可以使用 [voice.on()](https://mastra.zisheng.pro/zh-TW/reference/voice/voice.on) 方法監聽這些事件；在建立互動式語音應用程式時，這些事件尤其重要。

## 常見事件

即時語音 Provider 通常會實作下列事件：

**error** (`Error`): 語音處理期間發生錯誤，或音訊資料格式不受支援時發出

**session.created** (`object`): 使用 OpenAI 服務建立新工作階段時發出

**session.updated** (`object`): 工作階段設定更新時發出

**response.created** (`object`): AI 助理建立新回應時發出

**response.done** (`object`): AI 助理完成回應時發出

**speaker** (`StreamWithId`): 發出新的音訊串流，可透過管線傳送至音訊輸出

**writing** (`object`): 正在轉錄文字（使用者）或產生文字（助理）時發出

**speaking** (`object`): 語音 Provider 有可用的音訊資料時發出

**speaking.done** (`object`): 語音 Provider 完成語音輸出時發出

**tool-call-start** (`object`): AI 助理開始執行 Tool 時發出

**tool-call-result** (`object`): Tool 執行完成並產生結果時發出

## 注意事項

- 並非所有語音 Provider 都支援所有事件
- 確切的 payload 結構可能因 Provider 而異
- 非即時 Provider 不會發出其中大多數事件
- 這些事件適合用來建立會根據對話狀態做出回應的互動式 UI
- 不再需要事件監聽器時，請考慮使用 [voice.off()](https://mastra.zisheng.pro/zh-TW/reference/voice/voice.off) 方法將其移除