怎样用HTTP接口控制智能迷你远程语音喇叭

2022-07-04 发布浏览：974 次

本文介绍了如何用 HTTP 对接智能语音喇叭Mini 的方法：可以通过接口实现远程指令语音播报控制、自定义语音内容播报、定时语音通知触发、场景联动语音提示、设备状态语音反馈、远程音量调节控制、远程播放列表管理、设备运行状态监控、多设备语音同步播报、自定义语音模板设置。

智能语音喇叭Mini

远程语音播报、语音提醒、语音通知；

广泛应用于各种线下服务的订单提醒、线下流程的语音提醒等；

体积小巧，方便插入、携带；

无需上传录音、无需后台设置；

直接通过HTTP接口推送文本，即可实时远程语音播报；

真人发声、语调自然柔和，支持男、女音色；

支持远程音量、音色、语调、语速设置；

内置铃声、提示音、警示音各5种；

可无缝接入各种OA、ERP、SaaS软件和低代码平台中；

更多...

适用场景

共享自习室小型语音通知场景、共享棋牌室小型语音播报场景、共享台球室小型语音提示场景、共享茶室小型语音广播场景、无人售货机小型语音提示场景、自助洗车设备小型语音播报场景、设备机房小型语音告警场景、产线设备小型语音通知场景、酒店客房小型语音提示场景、写字楼办公区小型语音广播场景、智慧教室小型语音播报场景、养老社区小型语音通知场景中

支持命令

音量	volume
音色	voice
语速	speed
语调	tone
播报	play:gbk:16
铃声	ring
提示音	message
警示音	alert
停止	stop

产品手册

版本	对应产品手册
白色	《智能语音喇叭Mini产品手册》

HTTP接口控制以设备控制（向设备下发命令）为例

POST  /{AppID}/device/control/sign={sign}&ts={ts} HTTP/1.1
Host: api.thingboot.com
X-APISpace-Token:
Content-Type:

/*
First you need to prepare the following values
1. AppID (in your console development settings)
2. AppSecret (in your console development settings)
3. ts (timestamp of the current time, seconds)
4. YourSign = md5(md5(AppSecret)ts);(md5 is an encryption method, AppSecret is the AppSecret prepared above, ts is the timestamp prepared above, concatenate the string after the AppSecret after md5 encryption)
In simple terms, the signature is md5(md5(your developer password)concatenate the above ts timestamp value); ts is the timestamp of the current timestamp; that is, to perform one MD5 on the developer password (AppSecret), then concatenate the timestamp, and then perform one MD5 on the entire concatenated string
Core request address: api.thingboot.com/AppID/device/control/?sign=YourSign&&ts=ts;
Request needs to pass two parameters device and order:
device[string]: unique device ID, can pass multiple [separated by ,], can be viewed in the console, or pulled through the interface
order[json string]: the command to be issued, for example:
{"power":1}, usually to connect the circuit of the switch
{"power3":0}, usually to close the third line of the switch or controller
{"play:gbk:16":"hello, welcome to visit"}, let the voice speaker report the specified content
The same type of product, the command is the same, different product types of commands, please view the product manual page of each product
Note: you must replace the formal AppID and AppSecret with real-time timestamp calculation of the signature, the request must have device device ID and order command
$appId = '开发者ID'; // 替换为实际的 AppID
$appSecret = '开发者密码'; // 替换为实际的 AppSecret
$ts = time();
$sign = md5(md5($AppSecret) . $ts); //md5(md5(开发者密码)拼接上面的ts参数)
$url = 'https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}';
AppID=qtyVWcgeMq
sign = c484eb97ee288572db7828c6071dd88f
ts = 1747212640
device=设备ID
order=命令
*/

POST /qtyVWcgeMq/device/control/?sign=c484eb97ee288572db7828c6071dd88f&ts=1747212640 HTTP/1.1
Host: api.thingboot.com
User-Agent: Your-User-Agent
Accept: application/json
Content-Type: application/json
Content-Length: 42
 
{
    "device": "1878",
    "order": {"power1": 1}
}

说明：{AppID}为您的应用ID（由平台生成），免费注册登录后，可在控制台查看；sign和ts的取值，请参考文档。