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

# Voice 事件

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

## 常見事件

實時 voice provider 一般都會實作以下事件：

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

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

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

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

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

**speaker** (`StreamWithId`): 在有可輸送至音訊輸出的新音訊串流時發出

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

**speaking** (`object`): voice provider 有音訊資料可用時發出

**speaking.done** (`object`): voice provider 完成發聲時發出

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

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

## 注意事項

- 並非所有 voice provider 都支援全部事件
- 確切的 payload 結構可能因 provider 而異
- 對於非實時 provider，大部分這些事件都不會發出
- 事件有助建立可回應對話狀態的互動式 UI
- 不再需要事件監聽器時，可考慮使用 [voice.off()](https://mastra.zisheng.pro/zh-HK/reference/voice/voice.off) 方法將其移除