车间语音提醒：如何把15W语音播报壁挂音箱对接到自己的项目中_解决方案

CATALOG

芯步的15W语音播报壁挂音箱通过标准HTTP接口开放控制能力，这意味着你可以在不依赖任何专用中间件的情况下，用自己熟悉的编程语言把它集成到MES、ERP或自定义看板系统中。下面从硬件准备到代码实现，整理一套完整的对接方案。

一、背景与选型

在车间生产环境中，传统的声光报警器往往只能发出简单的铃声或警报，无法告知具体是哪个工位出现了什么问题（例如：“数控机床A区，物料短缺，请及时补料”）。

产品选型： 芯步 智能语音壁挂音箱|15W。核心优势：

接口开放：提供标准的HTTP API，只要设备有WiFi或网线，就能被你的系统调用。
部署灵活：支持纯局域网私有化部署。考虑到许多工厂的MES系统运行在内网，不允许连接外网，该设备支持搭建本地服务器进行控制，数据不外流，安全性高。
维护简便：无需复杂的中间件或网关，音箱直接连接路由器的2.4G WiFi，通电即可上线。

二、对接架构原理

整个对接过程遵循极简的“请求-响应”模式，无需复杂的MQTT协议流转。

设备层：15W壁挂音箱（终端执行者）。
网络层：工厂局域网（WiFi/有线）。
应用层：你的项目系统（MES、ERP、Web/APP/客户端）。
交互流程
- 系统检测到某个事件（如：质检不合格）。
- 后端代码构建一条HTTP请求，包含音箱ID和要说的文本。
- 请求发送至芯步云平台（或本地私有化服务器）。
- 服务器转发指令，音箱即时播报。

三、详细对接步骤

1. 硬件准备与配网

注册与添加：在芯步开发者后台添加设备，获取唯一的设备ID（Device ID）。
网络配置：使用配置工具将音箱接入车间WiFi。
- 注意：该设备支持配置5组WiFi，可确保在信号波动时自动切换，这对工业环境非常重要。
获取凭证：在后台获取你的AppID和AppSecret，这是调用接口的钥匙。

2. 鉴权与签名机制

芯步的接口安全机制采用动态签名，防止接口被恶意调用。规则如下（参考官方文档）：

Sign算法Sign = md5( md5(AppSecret) + Ts )
参数说明
- AppSecret：开发者密码。
- Ts：当前Unix时间戳（秒级）。
逻辑：先将AppSecret进行一次MD5，然后将结果字符串拼接上时间戳，再对整个字符串做一次MD5。

3. 核心功能开发：文本转语音 (TTS)

这是最常用的功能，只需向音箱推送文本即可，无需预录音。

接口地址POST https://api.thingboot.com/{AppID}/device/control/
Query参数?sign={计算出的签名}&ts={时间戳}
HeaderContent-Type: application/json
Body 示例
{ "device": "这里填写你的设备ID", "order": { "play:gbk:16": "【警告】三号生产线，温度过高，请立即检查。" } }
参数解析
- play:gbk:16play代表播报动作，gbk代表文本编码，16代表音量（范围0-100，可调）。
- 高级玩法：你可以在文本中插入数字，接口会自动识别金额（带单位）、手机号（连读）等，非常智能化。

4. 进阶控制：音量、音色与铃声

除了播报文本，你还需要控制系统参数以适应车间嘈杂环境。

音量控制：下发 {"vol":80}（将音量设置为80%）。
音色切换：下发 {"voice":"man"} 或 {"voice":"woman"} 切换男女声。
优先级控制：若是紧急事故，可以先下发内置警报音，再播报文本。例如下发 {"play":11}（触发内置第11号警报音）.

四、代码实现

以下代码展示了如何在你的后端项目中实现对接（以Python和Java为例），这适用于车间管理系统。

Python 实现示例

适用场景：如果你们的MES系统是基于Python（如Odoo或自研Flask/Django），可直接复制此逻辑。

import hashlib
import time
import requests
import json

class YoYoSpeaker:
    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 _gen_sign(self):
        # 1. 将AppSecret进行MD5加密
        secret_md5 = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 2. 获取当前时间戳
        ts = int(time.time())
        # 3. 拼接并再次MD5
        sign_str = secret_md5 + str(ts)
        sign = hashlib.md5(sign_str.encode()).hexdigest()
        return sign, ts

def send_command(self, order):
        sign, ts = self._gen_sign()
        params = {
            'sign': sign,
            'ts': ts
        }
        body = {
            'device': self.device_id,
            'order': order
        }
        # 添加超时设置，防止堵塞
        response = requests.post(self.api_url, params=params, json=body, timeout=5)
        return response.json()

# 实际调用示例
if __name__ == "__main__":
    # 这些参数去芯步控制台获取
    speaker = YoYoSpeaker("你的AppID", "你的AppSecret", "你的设备ID")
    
    # 场景1:设备启动时提示
    speaker.send_command({"play:gbk:16": "系统已上线，开始监测"})
    
    # 场景2:安灯系统触发缺料
    speaker.send_command({"play:gbk:50": "注意，A线工位物料即将耗尽，请配送"}) # 音量调到50

Java 实现示例

适用场景：传统制造业的Java Spring Boot后端。

五、车间场景应用方案

设备故障联动
- 逻辑：PLC通过OPC采集到“主轴过载”信号 -> 系统判断为故障 -> 调用接口。
- 播报内容：“紧急情况：五号数控中心主轴过载，请维修工立即前往。”
- 优势：维修工不需要一直盯着看板，无论在哪都能听到具体故障点，响应速度提升。
安灯系统 (Andon) 物料呼叫
- 逻辑：操作工按下工位呼叫按钮 -> 系统记录 -> 调用接口推送给仓库区域音箱。
- 播报内容：“物料请求：总装车间三号线，需要标准件A100个。”
- 优势：相比对讲机嘈杂不清，TTS语音精准传达需求。
定时排产播报
- 逻辑：每到整点或班次交接，系统自动读取当天的生产计划。
- 播报内容：“生产提示：今日计划剩余500件，当前进度80%，请保持节奏。”

六、注意事项与优化

关于网络环境
- 若生产环境涉及强干扰或对数据隐私要求比较高，采用该设备的以太网版本或私有化部署方案。你可以搭建本地服务器，设备流量完全走局域网，不经过外网，极低延迟且绝对安全。
关于声音覆盖
- 15W的功率在开阔的车间环境（会有机械噪音）中，覆盖范围有限。
- ：如果车间较长，不要只装一个。可以在不同区域部署多个，通过device参数单独控制对应区域的音箱，实现分区广播。
错误处理
- 代码中请一定要捕获HTTP请求的异常（超时、断开）。音箱不存在时，接口会返回错误码，代码需做日志记录，以便运维排查是哪台音箱离线了。