WiFi 음성 알림 시스템을 HTTP 프로토콜을 통해 구현하는 방법을 설명합니다. 이 글에서는 HTTP 인터페이스를 호출하여 WiFi 스피커를 제어하는 구체적인 방식을 다룹니다.

대상 제품군

아래에서는 각 제품별로 HTTP 프로토콜을 사용한 WiFi 음성 알림 구현 코드를 설명합니다.

1. 스마트 음성 스피커 3

이 제품은 원격 음성 방송, 알림, 경고 기능을 제공합니다. 오프라인 서비스의 주문 알림, 프로세스 음성 안내 등에 폭넓게 사용됩니다. 별도의 녹음 업로드나 백엔드 설정 없이 HTTP 인터페이스를 통해 텍스트를 전송하면 실시간 음성 방송이 가능합니다. 실제 사람의 목소리처럼 자연스럽고 부드러운 톤을 지원하며, 남성/여성 음색을 선택할 수 있습니다. 또한 원격으로 볼륨, 음색, 억양, 속도를 제어할 수 있고, 한자 다중 발음, 숫자(금액, 휴대폰 번호 등) 읽기 방식을 지원합니다. 내장된 벨소리, 알림음, 경고음을 각 5종씩 제공하며, LED 링의 색상을 원격 제어하여 시각적 알림도 가능합니다. 다양한 OA, ERP, SaaS, 로우코드 플랫폼에 손쉽게 연동할 수 있으며, 플러그 앤 플레이 방식으로 설치가 간편합니다.

HTTP 인터페이스를 통한 스마트 음성 스피커 3 제어 코드

아래는 장치 제어(명령 전송) 예제입니다.

POST /{AppID}/device/control?sign={sign}&ts={ts} HTTP/1.1
Host: api.yoyoiot.cn
X-APISpace-Token: [토큰값]
Content-Type: application/x-www-form-urlencoded

device=장치ID
order=명령

파라미터 설명:

• device: 장치 고유 ID(복수 전송 가능, 콘솔 또는 API로 확인 가능)
• order: JSON 문자열 명령어. 주요 명령은 아래와 같습니다.

{AppID}는 플랫폼에서 생성된 애플리케이션 ID입니다. 무료 가입 후 콘솔에서 확인 가능하며, sign과 ts 생성 방식은 공식 문서를 참조하세요.

2. 스마트 음성 컬럼 스피커 | 10W

1번 제품과 유사한 원격 음성 방송 기능을 제공합니다. 주요 차이점은 방수·방진 설계와 알루미늄 합금 외관으로 실외 설치에 적합합니다.

HTTP 인터페이스를 통한 스마트 음성 컬럼 스피커 제어 코드

POST /{AppID}/device/control?sign={sign}&ts={ts} HTTP/1.1
Host: api.yoyoiot.cn
X-APISpace-Token: [토큰값]
Content-Type: application/x-www-form-urlencoded

device=장치ID
order=명령

order 명령어: 위 1번 제품과 동일한 명령 체계를 사용합니다(볼륨, 음색, 속도, 방송, 벨소리, 알림음, 경고음, 중지). 단, LED 제어 관련 명령(led, color, twinkle, breath, colorful)은 이 제품에서 지원되지 않습니다.

제품 사양 비교