开放接口并支持对接的智能语音音柱|20W
浏览:234 次
芯步工厂提供的 智能语音音柱|20W 开放HTTP接口, 适用于任何支持HTTP请求的编程语言。 接口简单、清晰、友好, 仅需在接口携带签名、以及设备ID,即可向设备下发命令。 支持接入任何形式的软件项目:Web、APP / 小程序、窗体软件、以及SaaS / 低代码等平台。
本文介绍了智能语音音柱|20W的相关参数和命令,并在下面提供了主要类型的语言的编程示例。
智能语音音柱|20W
远程语音播报、语音提醒、语音通知、语音警报;
广泛应用于各种线下服务的订单提醒、线下流程的语音提醒等;
无需上传录音、无需后台设置;
直接通过HTTP接口推送文本,即可实时远程语音播报;
真人发声、语调自然柔和,支持男、女音色;
支持远程音量、音色、语调、语速设置;
支持多音字、支持数字(数值、金额、手机号等)读法;
内置铃声、提示音、警示音各5种;
可无缝接入各种OA、ERP、SaaS软件和低代码平台中;
防尘防水,外形美观,安装简单;
适用场景
场馆语音播报、车间语音提醒、加油站语音通知、停车场语音播报、调度站语音提示、户外场景语音通知、门店订单语音播报、无人值守空间语音提示、线下服务语音提醒场景、快递分拣站、生产车间、工厂内语音播报、校园公共区域语音通知、景区游客服务中心语音播报、社区公告语音提示、园区语音广播、物流园区语音通知、港口码头语音播报、地铁站语音提示、公交站点语音通知、商场语音播报、超市语音提示、仓库语音通知、机场语音播报、医院语音提示、银行网点语音通知、展会现场语音播报、 智能办公工位语音提醒场景、前台接待语音引导场景、会议室预约签到语音提示场景、办公室茶水间语音通知场景、写字楼大厅语音播报场景、企业前台访客引导场景、会议室预约状态语音提示场景、办公区设备故障语音告警场景、智慧教室语音点名提醒场景、培训机构教室签到提示场景、图书馆自习室座位预约语音通知场景、实验室设备状态语音播报场景、教研教室教学辅助语音提示场景、创客工坊设备操作语音引导场景、学校活动室活动通知场景、培训教室上课下课语音提醒场景、酒店前台入住引导语音提示场景、餐厅奶茶店叫号语音播报场景、便利店收银台语音提示场景、共享空间前台语音引导场景、自助服务终端操作语音提示场景、银行网点叫号业务引导场景、医院导诊台语音指引场景、共享自习室前台语音引导场景、共享棋牌室服务台语音通知场景、共享台球室叫号预约提示场景、共享茶室前台语音接待场景、无人值守门店语音提示场景、自助设备操作引导语音提示场景、共享空间设备故障语音告警场景、无人值守场所安全语音提醒场景、工厂车间工位语音提醒场景、产线设备状态语音播报场景、仓库库存语音通知场景、设备机房维护提醒语音提示场景、生产线工位操作语音引导场景、设备巡检状态语音播报场景、生产车间安全规范语音提醒场景、产线异常情况语音告警场景、活动现场语音提示、公园语音广播、广场语音通知中
支持命令
| 音量 | volume |
| 音色 | voice |
| 语速 | speed |
| 语调 | tone |
| 播报 | play:gbk:16 |
| 铃声 | ring |
| 提示音 | message |
| 警示音 | alert |
| 重复 | repeat |
| 停止 | stop |
产品手册
| 版本 | 对应产品手册 |
|---|---|
| 联网方式:无线WiFi|播报内容:文本 | 《智能语音音柱20W产品手册》 |
| 联网方式:有线以太网+无线WiFi|播报内容:文本 | 《智能语音音柱20W[有线网版]产品手册》 |
| 联网方式:无线WiFi|播报内容:音频+文本 | 《智能语音音柱Pro20W产品手册》 |
| 联网方式:有线以太网+无线WiFi|播报内容:音频+文本 | 《智能语音音柱Pro20W[有线网版]产品手册》 |
控制设备,向设备下发指令
HTTP请求地址: http(s)://api.yoyoiot.cn/{AppID}/device/control/?sign={sign}&ts={ts}
关于sign和ts的定义
或
MQTT发布主题: api/{AppID}/device/control
接收返回结果亦在同一主题
请求参数
参数较长时建议使用POST方式
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| gateway | 否 | string | 当发给设备的命令需要其关联的网关转发时,需要指定
网关的设备ID,唯一ID(在网关壳体上、控制台均可以找到)
指定多个网关时请用间隔符(,或|)连接,最多可以同时指定5台网关 |
| device | 是 | string | 设备ID,设备唯一ID(在设备壳体上、控制台均可以找到)
指定多台设备时请用间隔符(,或|)连接
指定多个设备时,不要这些设备属于同一类产品,但必须有相同的指令 |
| order | 是 | string | 命令,可传JSON字符串(推荐)或直接传参
简单命令:可直接GET或POST:设备的属性名称=属性值
复杂或较长的命令:请POST {"order":{命令内容}}
-----------------------------------------------------------------------
在一些业务场景,需要在命令里携带一些特征信息:如订单号等
可在order中增加一个字段extra,如{"power":1,"extra":"T25030700001"}
在本条命令对应的异步消息推送中,会原样返回此特征信息。
extra只支持32位以内的大小写英文字母和数字(a-zA-Z0-9) |
返回示例
x
1
//示例2
//device为设备唯一id3
//p1、p2为参数名称,v1、v2为参数的值4
5
//GET方式的参数为:6
?device=123456&p1=v1&p2=v2&sign={sign}&ts={ts}7
8
//POST方式的FORM参数为:9
device=12345610
p1=v111
p2=v212
13
//POST方式的JSON参数为:14
{"device":111,"order":{"p1":"v1","p2":"v2"}}返回结果
需要注意的是,200仅代表平台接收到了合规的设备ID与参数名称,并成功向设备下发命令。
而设备可能已离线,或命令内容 / 参数有误,在设备上并没有看到预期效果。
在一些必须要求反馈的场景,请接收云端的消息推送,通过异步消息来标记设备是否成功执行命令。
| 名称 | 类型 | 说明 |
|---|---|---|
| code | int | 200 命令下发成功。
501 未指定设备ID,设备ID为一个整型数字,或由“|”或“,"连接的多个数字。设备列表接口中输出了此ID,在本控制台的设备列表中也可以查看。
502 设备不存在或没有可用设备,传入设备ID均不存在。请检查设备ID是否正确,设备是否删除。
503 指定了过多设备,一次最多指定100台设备ID
504 一次指定了多个设备ID,但其中有一些并不可用(不存在、无权限或已删除)
50xx 请见“全局错误代码” |
返回示例