실시간 이벤트 API의 개요와 데이터 구조를 설명합니다.
Live Events API는 Deeply 시스템이 감지한 오디오 이벤트를 실시간으로 제공합니다. 이 API는 WebSocket 연결을 사용해 이벤트 데이터를 지속적으로 스트리밍하므로, 클라이언트는 이벤트가 발생하는 즉시 모니터링할 수 있습니다.
ws://localhost:8100/api/v1/ws이 페이지는 레퍼런스 전반에서 사용하는 로컬 기본 호스트를 기준으로 설명합니다.
클라이언트는 이 WebSocket 엔드포인트에 연결해 실시간 이벤트를 수신할 수 있습니다. 이 엔드포인트를 통해 전달되는 각 이벤트는 Event 객체 구조를 따르며, 감지된 오디오 이벤트에 대한 상세 정보를 제공합니다.
각 WebSocket 메시지는 아래와 같은 JSON 객체 구조를 가집니다.
stringobjectstring): 음향 라벨의 고유 식별자object): 라벨의 다국어 이름
string): 한국어 이름string): 영어 이름float(0.0 ~ 1.0)objectstring): 마이크의 고유 식별자string): 마이크 이름object): 장치의 지리적 위치
number): 위도 좌표number): 경도 좌표Array[float]이 예시에서 noises 배열은 2초 동안의 측정값 20개를 포함합니다.
값은 약 58 dB에서 71 dB 사이이며, 일반적인 대화 수준의 중간 정도 음량을 나타냅니다.
{
"id": "23d6ec74155f4eb187b4e7301b71b5d9",
"label": {
"id": "normal_speech_female",
"name": {
"ko": "대화(여성)",
"en": "normal speech female"
}
},
"confidence": 0.426632,
"mic": {
"id": "d00c8e3364a34439183e3462e773354a1",
"name": "예시 마이크 (715)",
"location": {
"latitude": 37.546344,
"longitude": 126.944322
}
},
"noises": [
66.99,
65.28,
68.21,
68.12,
67.56,
70.66,
67.35,
63.42,
59.98,
64.05,
65.86,
62.88,
62.41,
62.59,
61.96,
59.25,
58.16,
59.75,
64.2,
65.15
]
}