음성 이벤트
음성 Provider는 실시간 음성 상호작용 중에 이벤트를 방출합니다. 이러한 이벤트는 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() 메서드로 제거하는 것이 좋습니다.