CATALOG

芯步的智能硬件全部开放HTTP接口,这意味着无论你用什么开发语言,只需几行代码就能让“智能壁挂Pro”按指令播报任何文本。以下方案涵盖从前提准备到多语言代码实现的全流程。

解决方案:对接智能壁挂Pro实现远程语音指令播报

1. 概述

智能壁挂Pro 是一款支持WiFi联网的语音播报设备。它对外提供了标准的HTTP接口,允许开发者通过POST请求向设备发送文本内容,设备接收后即刻进行TTS(文字转语音)播报。

核心优势:

  • 极速响应:毫秒级语音合成,端到端延迟低(约80-200ms)

  • 跨平台:接口基于HTTP协议,无论是Web、APP、小程序还是后端服务均可调用。

  • 语音自然:硬件级TTS芯片,支持男/女声、语速、语调、音量调节,支持数字(金额、手机号)智能读法

  • 无需录音:直接推文字,即推即播。

2. 对接前提准备

在开始编码前,需要准备以下三项关键信息:

  1. 获取开发者凭证(AppID & AppSecret)

    • 登录芯步控制台。

    • 进入“开发设置”页面。

    • 记录下 AppID(开发者ID)和 AppSecret(开发者密码)。AppSecret 在接口签名中至关重要,需妥善保管

  2. 获取设备ID

    • 在控制台的“设备列表”中找到已配网成功的“智能壁挂Pro”。

    • 记录下 Device ID(设备唯一标识)

  3. 设备网络状态

    • 确保智能壁挂Pro已连接2.4G WiFi,且与控制端网络互通(公网或同局域网均可,支持私有化部署)

3. API接口详解

设备控制的请求地址为:https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

签名算法(Sign)为防止接口被恶意调用,需要对请求进行签名,算法逻辑如下sign = md5( md5(AppSecret) + ts )

  • ts:当前Unix时间戳(秒)。

  • 步骤:先将 AppSecret 进行MD5加密得到一个字符串 S1;将 S1 与时间戳 ts 拼接成字符串 S2;再将 S2 进行MD5加密,得到最终的 sign

请求体(Body)请求方式为 POSTContent-Typeapplication/json

4. 核心功能:远程指令控制

你可以通过修改 order 中的命令参数,实现丰富的播报控制。

基础语音播报这是最核心的功能。利用 play:gbk:16 指令,直接推送文本即可实现实时播报

  • 指令示例{"play:gbk:16":"工单号10086已完成,请及时处理"}

  • 支持多音字:文本中若包含多音字,可通过特定标记指定读音,避免误读

调节音色与语速智能壁挂Pro支持在播报前或播报中动态调整参数,以适应不同场景。

  • 音量(0-9级){"volume":5} (0静音,9最大)

  • 音色{"voice":"female"}{"voice":"male"}

  • 语速(0-9级){"speed":5} (数值越大越快)

组合指令与高级播报

在实际应用中,可以通过一条指令包含多个动作,例如“先响铃、再调高音量、最后播报”

场景示例:下班打卡提醒

5. 代码实现示例

以下提供几种常见语言的对接Demo。所有代码中,AppIDAppSecretDeviceIDts(时间戳)需替换为真实值。

1. Python 实现适合后端服务或脚本任务

2. Java 实现适合企业级SpringBoot项目

3. PHP 实现适合快速集成

4. 调试工具(cURL)适合开发阶段快速验证接口连通性

6. 常见应用场景方案

  1. SaaS/ERP系统集成:直接将上述代码封装成微服务。当业务系统产生工单、告警或审批时,调用该服务即可让仓库、办公室内的喇叭发出语音提醒

  2. 无人值守警报:在监控系统中集成。当传感器(如温湿度、烟雾)数值超标时,自动触发指令,使壁挂Pro循环播放警报内容,甚至可以配合 {"repeat":3} 参数重复播报

  3. 多设备广播

    • device 字段支持传入多个ID,用英文逗号隔开。例如 "device": "1878, 1879",可以实现一个指令让多个房间的喇叭同时播报

7. 总结

通过芯步开放的HTTP接口,对接“智能壁挂Pro”非常简单。核心流程仅为:注册获取密钥 -> 计算签名 -> 发送JSON指令。无需关心底层硬件协议,只需业务系统能够发起HTTP请求,即可轻松实现远程语音播报控制的数字化改造。