MusicRecognizer

MusicRecognizer 인터페이스는 음악 인식과 관련된 일련의 Message를 제공합니다.

Event

Event Message의 호출 방식은 다음과 같습니다.

Recognize

MusicRecognizer.Recognize는 Service Agent에서 발생한 음악 관련 발화를 KVS에 전달하는 Event로, Multipart Message로 통신합니다.
Multipart의 <The First Part>에는 JSON 형식의 객체가 전달되며, <The Second Part>에는 Service Agent와 KVS 사이에 전송되는 오디오 데이터가 스트리밍 방식으로 배치됩니다. stream에는 320 bytes chunk 단위로 10ms의 캡처된 오디오 파일이 첨부됩니다.

Request Syntax

Content-Disposition: form-data; name="metadata"
Content-Type: application/json

{
        "state": [, , ,],
        "event": {
                "header": {
                        "type": "MusicRecognizer.Recognize",
                        "messageId": "{STRING}",
                        "dialogRequestId": "{STRING}"
                },
                "body": {
                        "format": "{STRING}",
                        "mode": "{STRING}"
                }
        }
}

Content-Disposition: form-data; name="audio"
Content-Type: application/octet-stream

{BINARY AUDIO ATTACHMENT}

Request Header

Request Body

Instruction

Event Message의 응답으로 Instruction Message를 수신할 수도 있습니다. Instruction Message 수신을 위한 Down Channel 생성 방식은 다음과 같습니다.

StopCapture

MusicRecognizer.StopCapture는 KVS가 사용자의 의도를 파악했거나 명령어 인식을 종료할 때 음성 캡처를 중지하도록 Service Agent로 지시하는 Instruction입니다. Service Agent는 MusicRecognizer.StopCapture Instruction을 받으면, 즉시 마이크를 닫고 사용자 발화를 더 이상 듣지 않습니다.

Request Syntax

{
        "header": {
                "type": "MusicRecognizer.StopCapture",
                "messageId": "{STRING}",
                "dialogRequestId": "{STRING}"
        },
        "body": {}
}

Request Header

Request Body

Request Body는 없습니다.