车间语音提醒：怎么将60W HTTP接口语音音柱接入到自己的项目中_解决方案

CATALOG

车间环境嘈杂，传统广播找人效率低，设备告警也常被忽略。芯步60W语音音柱支持HTTP接口远程调用，可直接接入MES、ERP或自研系统，把文字转成语音播报。以下是完整的接入方案。

1. 引言

在现代车间管理中，及时、清晰的信息传递对于提高生产效率、保障生产安全至关重要。传统的声光报警器或对讲机通知往往存在信息模糊、覆盖不全的问题。芯步推出的 60W智能语音音柱 凭借其大功率输出（覆盖面积高达400-600平方米，适合车间环境）和开放的 HTTP接口 ，可以无缝集成到现有的MES、ERP或自研管理系统中，实现精准、实时的语音播报。

本文将详细介绍如何将该设备以最低成本、最快速度接入到您自己的项目中。

2. 准备工作

在开始对接前，请确认具备以下条件：

硬件设备：芯步智能语音音柱 Pro 60W（已接通电源并开机）。
网络环境：车间内覆盖2.4G WiFi信号（设备不支持5G，但支持有线网络版本可选）。
平台账号：注册芯步官方平台账号。
开发资料：获取AppID、AppSecret以及目标设备的Device ID。

3. 设备联网与配置

由于设备通过HTTP指令控制，第一步需确保音柱在线。

配网：使用手机App或电脑端工具，将音柱连接到车间内的指定WiFi网络。
获取关键凭证
- 登录芯步控制台。
- 在“开发设置”中获取 AppID 和 AppSecret（后者用于签名计算，需妥善保管）。
- 在“设备列表”中获取目标音柱的 Device ID（通常是纯数字字符串）。
网络模式：如果是内网环境（无互联网），芯步支持私有化部署，可将API请求指向本地服务器地址，确保数据不出园区，响应更快。

4. HTTP接口对接核心逻辑

芯步的接口设计遵循RESTful风格，其核心在于签名计算和命令下发。

4.1 接口地址与签名机制

为了保护接口安全，所有指令下发都需要携带动态签名（Sign）。

请求地址： http(s)://api.thingboot.com/{AppID}/device/control/
参数
- ts：当前Unix时间戳（秒）。
- sign：MD5加密字符串。

签名计算方法（通用代码逻辑）：

这是接入过程中唯一需要注意的技术细节，算法如下

将您的 AppSecret 进行第一次MD5加密，得到 secret_md5。
将 secret_md5 与当前时间戳 ts （作为字符串）拼接，得到新的字符串 str。
将 str 进行第二次MD5加密，得到最终的 sign。

*签名公式： sign = md5( md5(AppSecret) . ts )*

例如（伪代码思路）：AppSecret = “abc123” -> MD5加密 -> “xxxxx” + 时间戳 -> 再次MD5 -> 最终Sign。

4.2 核心命令：文本播报

这是车间最常用的功能。只需将文字通过JSON格式推送给音柱，它就会自动进行TTS（文字转语音）播报。

请求方式： POST
Header： Content-Type: application/json
Body示例

命令详解： play:gbk:16 中，play 代表播报，gbk 是编码格式（支持中文），16 是文本长度（有些固件要求预定义长度，或者特定格式，具体需参考设备手册；部分新型号支持直接字符串路径，但上述标准格式兼容性最好）。

4.3 进阶命令：音量与音色控制

车间环境嘈杂，可能需要远程调整音量；或者通过不同音色区分信息等级。

调节音量（范围0-9，9为最大）："order": {"volume":"7"} （将音量设为70%左右）
更换音色（0女声，1男声）："order": {"voice":"1"} （切换为男声，通常男声中低频穿透力更强，适合车间）

5. 项目集成实战：如何融合到车间系统

假设您的车间有一套MES（制造执行系统），当某工位发生故障时，系统自动调用语音音柱通知维修工。

5.1 业务流程设计

触发：PLC/传感器检测到故障 -> 写入MES数据库。
逻辑判断：MES服务端判断故障等级。
HTTP调用：MES后端服务（Java/Python/PHP/Go等）调用芯步API。
语音输出：音柱播报：“维修班组请注意，A03工位发生传送带停转，请即刻前往”。

5.2 后端代码示例（Python FastAPI风格）

以下代码展示了如何在您的后端服务中封装一个“播报函数”：

import hashlib
import time
import requests

class YoYoVoiceBroadcaster:
    def __init__(self, app_id, app_secret, device_id):
        self.app_id = app_id
        self.app_secret = app_secret
        self.device_id = device_id
        self.api_url = f"https://api.thingboot.com/{app_id}/device/control/"

def _generate_sign(self):
        # 1. md5(AppSecret)
        md5_secret = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 2. 获取时间戳
        ts = str(int(time.time()))
        # 3. md5(md5_secret + ts)
        sign_str = md5_secret + ts
        sign = hashlib.md5(sign_str.encode()).hexdigest()
        return sign, ts

def broadcast(self, text):
        sign, ts = self._generate_sign()
        params = {
            "sign": sign,
            "ts": ts
        }
        payload = {
            "device": self.device_id,
            "order": {
                "play:gbk:16": text  # 注意:实际开发中若文字长度不定，请查阅官方关于动态长度的文档
            }
        }
        response = requests.post(self.api_url, params=params, json=payload)
        return response.json()

# 调用示例
if __name__ == "__main__":
    # 使用你在控制台拿到的凭证
    voice = YoYoVoiceBroadcaster("你的AppID", "你的AppSecret", "你的DeviceID")
    result = voice.broadcast("欢迎进入智能车间，请注意安全")
    print(result)

6. 最佳实践和需要注意的点

关于播放优先级：如果是紧急疏散指令，先发送 {"stop":"1"} 命令强制清空当前播放队列，再发送紧急播报，确保指令立即执行。
网络稳定性：车间环境可能存在信号屏蔽，优先选用 有线网口版本 的60W音柱，或将AP热点部署在音柱附近，避免WiFi干扰导致的延迟或掉线。
文字预处理：TTS引擎对于数字和英文的识别可能不准确。例如“1024”，预处理为“一千零二十四”；“IO板卡”处理为“I O板卡”，以提高播报准确率。
私有化部署：如果车间是纯内网环境（无公网IP），您可以向芯步申请私有化部署包，将整个服务端部署在车间内的本地服务器上，API调用地址改为本地IP即可。

7. 总结

芯步60W智能语音音柱的HTTP接口极为简洁，开发人员无需了解复杂的物联网协议，仅通过标准的HTTP POST请求即可完成功能集成。对于车间场景而言，这相当于给您的生产系统装上了“嘴巴”，无论是自动化流程提醒、安灯（Andon）系统呼叫，还是环境超标告警，都能瞬间转化为清晰的语音指令，有效提升车间数字化管理水平。