마이크 장치 API 개요

Microphone Device of Deeply AI System

마이크 장치 객체#

Device 객체는 Deeply 시스템 내에서 오디오 데이터를 수집하는 개별 마이크 장치를 나타냅니다. 각 장치는 엣지 서버에 연결되며 위치와 운영 상태에 대한 정보를 포함합니다.

속성#

id#

• Type: string
• Description: 장치의 고유 식별자입니다.

name#

• Type: string
• Description: 일반적으로 장치를 쉽게 식별하기 위해 사용하는 이름입니다.

edge_id#

• Type: string
• Description: 이 장치를 관리하는 엣지 서버의 고유 식별자입니다.

location#

• Type: object
• Description: 장치 위치의 지리적 좌표입니다.
  • latitude (number): 위도 좌표 (-90 ~ 90).
  • longitude (number): 경도 좌표 (-180 ~ 180).

status#

• Type: enum(active | inactive)
• Description: 장치의 운영 상태입니다. 가능한 값은 다음과 같습니다.
  • "active": 장치가 온라인이며 정상 동작 중인 상태
  • "inactive": 장치가 오프라인이거나 사용 중이 아닌 상태

thresholds#

• Type: object
• Description: 다양한 음향 이벤트에 대한 감지 임계값입니다.
  • 각 key는 특정 이벤트 유형을 나타냅니다. (예: "breathing_heavily", "scream_female")
  • 각 value는 다음 속성을 가진 객체입니다.
    • sound_level_ge (number): 이벤트 감지에 필요한 최소 음압 레벨 (데시벨 기준, 0 ~ 100)
    • confidence (number): 이벤트 감지에 필요한 최소 신뢰도 (0 ~ 1)
  • 사용 가능한 이벤트 유형과 설명은 이벤트 카테고리를 참고해 주세요.

created_at#

• Type: string, ISO 8601 format
• Description: 장치가 시스템에 처음 등록된 시각입니다.

updated_at#

• Type: string, ISO 8601 format
• Description: 장치 정보가 마지막으로 갱신된 시각입니다.

---

단일 마이크 조회 문서를 참고하면 API 사용 예시를 더 자세히 확인할 수 있습니다.