WebSocket 인터페이스

WebSocket 인터페이스는 WebSocket 연결을 통해 설정되는 양방향 통신 프로토콜입니다.

클라이언트 ⇔ 서버 간에는 지속적으로 명령어 패킷, 명령어 응답 패킷, 이벤트 패킷이 교환됩니다. 또한 내부에는 3개의 병렬 상태 전이 시스템이 존재합니다. 음성 공급에 관한 상태 전이 시스템, 발화 구간 검출에 관한 상태 전이 시스템, 음성 인식 처리에 관한 상태 전이 시스템입니다. 각 전이 시스템은 여러 상태를 가지며, 고유한 트리거를 기반으로 상태 전이를 반복합니다.

이를 이해하면 클라이언트 애플리케이션용으로 제공되는 Wrp 라이브러리(샘플 프로그램에 포함)를 사용하지 않고도 본 API를 활용할 수 있습니다.

엔드포인트

로그 저장 포함

wss://acp-api.amivoice.com/v1/

로그 저장 미포함

wss://acp-api.amivoice.com/v1/nolog/

인증

다음 중 하나의 방법으로 API key를 지정해 주십시오. 취득 방법은 API Key 발급 방법을 참조하십시오.

s 명령어 패킷 내에서 API key를 authorization 파라미터로 지정합니다.

authorization={API_KEY}

WebSocket 연결 시작 시 HTTP 요청 헤더에서 다음 헤더 중 하나를 지정합니다.

Authorization: Bearer {API_KEY}

Sec-WebSocket-Protocol: wrp, {API_KEY}

WebSocket 인터페이스의 요청 헤더에 의한 인증에 대한 자세한 내용은 매뉴얼의 HTTP 요청 헤더로 인증 정보를 보내는 방법을 참조하십시오.