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

# 음성 이벤트

음성 Provider는 실시간 음성 상호작용 중에 이벤트를 방출합니다. 이러한 이벤트는 [voice.on()](https://mastra.zisheng.pro/ko/reference/voice/voice.on) 메서드로 수신할 수 있으며, 대화형 음성 애플리케이션을 구축할 때 특히 중요합니다.

## 일반 이벤트

이러한 이벤트는 일반적으로 실시간 음성 제공자 전반에 걸쳐 구현됩니다.

**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가 모든 이벤트를 지원하는 것은 아닙니다.
- 정확한 페이로드 구조는 Provider마다 다를 수 있습니다.
- 실시간이 아닌 Provider에서는 이러한 이벤트 대부분이 발생하지 않습니다.
- 이벤트는 대화 상태에 반응하는 대화형 UI를 구축하는 데 유용합니다.
- 이벤트 리스너가 더 이상 필요하지 않으면 [voice.off()](https://mastra.zisheng.pro/ko/reference/voice/voice.off) 메서드로 제거하는 것이 좋습니다.