语音提醒场景：怎么将10W壁挂TTS语音播放器对接到项目中_解决方案

CATALOG

芯步的10W壁挂TTS语音播放器通过开放的HTTP接口，可以非常方便地集成到各类项目中。接口采用标准的MD5签名认证，只需向设备下发播报命令即可实现语音提醒。以下是完整的解决方案：

1. 产品概述

芯步10W壁挂TTS（Text-to-Speech，文本转语音）语音播放器是一款支持HTTP接口远程控制的智能语音设备，适用于订单提醒、语音通知、警报播报等场景。该设备的语音合成在设备端完成，响应速度快（80-120ms），音质自然柔和。10W功率适合门店、办公室、会议室等室内场景，支持壁挂或摆放安装。

2. 核心技术架构

2.1 接口开放能力

芯步为TTS播放器提供了全开放的HTTP API接口，具有以下特点：

协议简单：标准HTTP POST请求，JSON数据格式
认证安全：MD5双重签名机制
响应快速：毫秒级设备响应
多语言支持：适用于任何支持HTTP请求的编程语言（Java、Python、PHP、C#、Node.js等）
网络灵活：支持公网和纯局域网环境，支持私有化部署

2.2 整体架构图

flowchart LR
    subgraph 业务系统
        A[订单系统] --> B[ERP/OA系统]
        C[监控系统] --> B
    end
    
    B -->|HTTP POST| D[芯步API网关]
    D -->|设备命令下发| E[10W壁挂TTS播放器]
    
    E -.->|语音播报| F[用户/现场人员]
    
    subgraph 认证
        G[AppID + AppSecret] -->|MD5签名| D
    end

3. 接口对接详解

3.1 准备工作

在芯步控制台完成以下配置：

注册开发者账号，获取AppID和AppSecret
添加设备，获取设备唯一ID（Device ID）
确保设备已连接WiFi（2.4GHz）并在线

3.2 接口地址

POST https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

参数	说明
{AppId}	控制台获取的应用ID
{sign}	签名，见下方计算方式
{ts}	当前Unix时间戳（秒）

3.3 签名算法

签名采用双重MD5加密

sign = MD5( MD5(AppSecret) + ts )

计算步骤：

对AppSecret字符串进行一次MD5加密
将加密结果与时间戳ts拼接（直接拼接，无连接符）
对拼接后的字符串再次进行MD5加密

代码示例：

3.4 请求体格式

字段	类型	必填	说明
device	string	是	设备唯一ID，支持多个（用逗号分隔）
order	object	是	命令对象，`play:gbk:16`为TTS播报命令

4. 代码实现示例

4.1 Python实现

import hashlib
import json
import time
import requests

class YoYoTTSSpeaker:
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret
        self.base_url = "https://api.thingboot.com"
    
    def _generate_sign(self, ts):
        """生成MD5双重签名"""
        step1 = hashlib.md5(self.app_secret.encode()).hexdigest()
        step2 = step1 + str(ts)
        return hashlib.md5(step2.encode()).hexdigest()
    
    def speak(self, device_id, text, volume=None, speed=None, tone=None):
        """
        发送TTS播报命令
        
        Args:
            device_id: 设备ID
            text: 播报文本内容
            volume: 音量(0-9，可选)
            speed: 语速(0-9，可选)
            tone: 语调(0-9，可选)
        """
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        url = f"{self.base_url}/{self.app_id}/device/control/"
        params = {"sign": sign, "ts": ts}
        
        # 构建播报命令
        order = {"play:gbk:16": text}
        
        # 可选参数:先设置设备参数再播报
        if volume is not None:
            order["volume"] = volume
        if speed is not None:
            order["speed"] = speed
        if tone is not None:
            order["tone"] = tone
        
        payload = {
            "device": device_id,
            "order": order
        }
        
        response = requests.post(url, params=params, json=payload)
        return response.json()

# 使用示例
speaker = YoYoTTSSpeaker("your_app_id", "your_app_secret")
result = speaker.speak("820720", "您好，欢迎光临", volume=7, speed=5)
print(result)

4.2 Java实现（使用Unirest）

import com.konghq.unirest.http.HttpResponse;
import com.konghq.unirest.http.Unirest;
import org.apache.commons.codec.digest.DigestUtils;

public class YoYoTTSSpeaker {
    private String appId;
    private String appSecret;
    
    public YoYoTTSSpeaker(String appId, String appSecret) {
        this.appId = appId;
        this.appSecret = appSecret;
    }
    
    private String generateSign(long ts) {
        String step1 = DigestUtils.md5Hex(appSecret);
        String step2 = step1 + ts;
        return DigestUtils.md5Hex(step2);
    }
    
    public String speak(String deviceId, String text) throws Exception {
        long ts = System.currentTimeMillis() / 1000;
        String sign = generateSign(ts);
        
        String url = String.format("https://api.thingboot.com/%s/device/control/?sign=%s&ts=%d",
            appId, sign, ts);
        
        // 构建请求体
        String orderJson = String.format("{\"play:gbk:16\":\"%s\"}", text);
        String body = String.format("{\"device\":\"%s\",\"order\":%s}", deviceId, orderJson);
        
        HttpResponse<String> response = Unirest.post(url)
            .header("Content-Type", "application/json")
            .body(body)
            .asString();
        
        return response.getBody();
    }
}

4.3 cURL命令行测试

5. 高级功能配置

5.1 设备参数控制

除基础播报外，支持以下远程配置

命令	格式	说明
音量	`{"volume":7}`	0-9级，数字越大音量越大
音色	`{"voice":1}`	0=女声，1=男声
语速	`{"speed":5}`	0-9级
语调	`{"tone":5}`	0-9级
停止播报	`{"stop":1}`	立即停止当前播报
铃声	`{"ring":1}`	内置5种铃声（1-5）
提示音	`{"message":1}`	内置5种提示音

组合使用示例：

5.2 多设备广播

支持一次性向多个设备发送相同播报内容（设备ID用英文逗号分隔）：

5.3 数字读法优化

接口支持智能识别数字格式：

普通数字：123 → "一百二十三"
金额：123.50元 → "一百二十三点五元"
手机号：13812345678 → "幺三八一二三四五六七八"

6. 典型应用场景

6.1 订单提醒系统

6.2 设备告警通知

6.3 定时语音提醒

7. 注意事项

签名时效性：时间戳ts为秒级Unix时间戳，每次请求重新计算
文本编码：播报文本使用GBK编码（命令中的play:gbk:16），中文需正确编码
网络环境：设备仅支持2.4GHz WiFi，确保信号稳定
多命令顺序：如需先调音量再播报，可分两次请求或按顺序组合
并发控制：设备播报时收到新命令会打断当前播报，请根据业务需求设计重试或队列机制

8. 常见问题

Q：设备响应延迟是多少？A：从命令下发到设备响应约为80-120ms。

Q：是否支持局域网内网调用？A：支持私有化部署，可运行在纯局域网环境。

Q：播报文本有长度限制吗？A：单次播报不超过200字符，过长文本可分段播报。

以上方案涵盖了从接口认证到代码实现的完整对接流程，开发者可根据实际项目需求选择合适的编程语言和集成方式。如需更多技术支持，可参考芯步官方文档。