怎样对接智能 5W 壁挂远程控制语音音箱来实现定时语音通知触发_解决方案

CATALOG

芯步的智能硬件全部通过统一的HTTP接口开放控制能力，这意味着“定时语音通知”本质上是一个调度问题——你可以用任何后端语言（Python、Java、Go等）写一个定时任务，到点向音箱接口发一条播报指令即可。以下方案涵盖设备准备、接口鉴权、定时任务实现三个核心环节。

解决方案：基于芯步开放接口对接智能5W壁挂音箱实现定时语音通知

1. 概述

本方案的目标是指导开发者或系统集成商，利用芯步智能语音壁挂音箱（5W型号）所提供的开放式HTTP API接口，将其集成到现有的软件系统（如OA、ERP、或自研的调度系统）中，从而实现在预设时间点自动触发语音通知播报的功能。

该方案特别适用于工厂定时播报作息铃、学校打铃、商场定时促销广播、办公室定时会议提醒等场景。

核心逻辑： 业务系统通过定时任务（Scheduler），在指定时间向芯步云平台发起HTTP请求，云平台将指令推送至目标音箱，音箱接收指令后即时进行TTS（文字转语音）播报。

2. 对接硬件与准备

目标硬件： 芯步智能语音壁挂音箱 (5W/Pro版)。
- 注意：该型号支持Wi-Fi或以太网联网，无需额外网关。
前置条件：
1. 设备激活： 确保音箱通电并已通过“芯步”控制台配置好Wi-Fi网络（仅支持2.4G），设备状态显示为“在线”。
2. 获取凭证： 登录芯步官方工作台，在“开发设置”中获取 AppID 和 AppSecret（开发者密码）。
3. 获取设备ID： 在控制台设备列表中，获取目标音箱的唯一标识 Device ID（如：820720）。

3. 接口对接技术细节

芯步的开放接口采用标准的HTTP POST请求，鉴权方式为双重MD5签名，简单且安全。

3.1 鉴权签名规则

所有的接口调用必须在URL参数中携带 sign（签名）和 ts（时间戳）。

签名生成公式（伪代码）：YourSign = md5( md5(AppSecret) + ts )

ts： 当前Unix时间戳（秒级，如 1715328000）。
md5： 32位小写MD5加密算法。
注意：AppSecret 需先进行一次MD5加密，得到32位字符串，然后拼接上时间戳，再进行第二次MD5加密。

举例演算：假设你的 AppSecret = “123456”，当前 ts = 1715328000。

第一步：md5(AppSecret) = e10adc3949ba59abbe56e057f20f883e
第二步：拼接并加密：md5("e10adc3949ba59abbe56e057f20f883e" + "1715328000") = 最终的sign。

3.2 API 请求地址

请求URL：https://api.thingboot.com/{AppID}/device/control/?sign={YourSign}&ts={ts}

请求方法：POST

请求头（Header）：Content-Type: application/json

请求体（Body）参数：

参数名	类型	说明
device	String	目标音箱的设备ID（支持多个，用逗号隔开）。
order	JSON String	控制命令，核心指令即为 `play:gbk:16`。

4. 实现“定时语音通知触发”的具体实施步骤

要实现“定时”，主要是通过你后端代码的逻辑控制。以下是几个主流环境的实现方案。

4.1 核心播报命令

要让音箱说话，order 字段必须包含播报指令。

普通播报：{"play:gbk:16":"您的定时任务已执行成功，请处理。"}
带提示音播报：{"play:gbk:16":"[message_3] 员工们，下班时间到了，请关闭电源。"}
- 提示：[message_1] 至 [message_5] 为系统内置提示音。

4.2 Python 实现方案 (使用Schedule库)

适合在Linux服务器或Windows任务计划程序中运行。

import requests
import hashlib
import time
import schedule

# --- 配置参数 (请替换为实际值) ---
APP_ID = "你的AppID"
APP_SECRET = "你的AppSecret"
DEVICE_ID = "你的设备ID" 
# --------------------------------

def calculate_sign(secret, ts):
    # 计算签名的核心逻辑:md5(md5(secret) + ts)
    md5_first = hashlib.md5(secret.encode()).hexdigest()
    sign_str = md5_first + str(ts)
    return hashlib.md5(sign_str.encode()).hexdigest()

def send_voice_notification(text_content):
    """发送语音通知到音箱"""
    ts = int(time.time())
    sign = calculate_sign(APP_SECRET, ts)
    
    url = f"https://api.thingboot.com/{APP_ID}/device/control/?sign={sign}&ts={ts}"
    
    # 构建播放指令
    order = {
        "play:gbk:16": text_content
    }
    
    payload = {
        "device": DEVICE_ID,
        "order": order
    }
    
    headers = {'Content-Type': 'application/json'}
    
    try:
        response = requests.post(url, json=payload, headers=headers, timeout=10)
        print(f"[{time.ctime()}] 发送指令: {text_content}")
        print(f"响应状态: {response.status_code}, 内容: {response.text}")
    except Exception as e:
        print(f"通知发送失败: {e}")

# --- 定时任务配置 ---
# 例如:每天早上 08:00 和 晚上 18:00 触发
schedule.every().day.at("08:00").do(send_voice_notification, "早上好，新的一天开始了，请各部门准备晨会。")
schedule.every().day.at("18:00").do(send_voice_notification, "[ring_1] 下班时间已到，请各位同事整理好工位，注意安全。")

if __name__ == "__main__":
    print("定时语音通知服务已启动...")
    while True:
        schedule.run_pending()
        time.sleep(1)

4.3 Java 实现方案 (使用 Spring Boot + @Scheduled)

适合企业级Java应用集成。

import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
import org.springframework.web.client.RestTemplate;
import org.springframework.http.*;
import org.apache.commons.codec.digest.DigestUtils;

@Component
public class VoiceNotificationTask {

private final String APP_ID = "你的AppID";
    private final String APP_SECRET = "你的AppSecret";
    private final String DEVICE_ID = "你的设备ID";

// 计算签名
    private String getSign(String secret, Long ts) {
        String firstMd5 = DigestUtils.md5Hex(secret);
        String raw = firstMd5 + ts;
        return DigestUtils.md5Hex(raw);
    }

// 执行语音播报
    private void playVoice(String content) {
        Long ts = System.currentTimeMillis() / 1000;
        String sign = getSign(APP_SECRET, ts);
        String url = String.format("https://api.thingboot.com/%s/device/control/?sign=%s&ts=%d", APP_ID, sign, ts);

RestTemplate restTemplate = new RestTemplate();
        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_JSON);

// 构建订单JSON
        String orderJson = String.format("{\"play:gbk:16\":\"%s\"}", content);
        String requestBody = String.format("{\"device\":\"%s\",\"order\":%s}", DEVICE_ID, orderJson);

HttpEntity<String> entity = new HttpEntity<>(requestBody, headers);
        ResponseEntity<String> response = restTemplate.postForEntity(url, entity, String.class);
        
        System.out.println("播报结果: " + response.getBody());
    }

// 定时任务:每天中午12点执行
    @Scheduled(cron = "0 0 12 * * ?")
    public void lunchTimeNotify() {
        playVoice("[message_5] 午餐时间已到，请分批前往食堂就餐。");
    }
}

4.4 “低代码”或“无代码”方案

如果不想编写后端代码，可以利用Home Assistant (HA) 或 Node-RED 这类物联网可视化编排工具。

在Node-RED中安装 node-red-contrib-http-request 节点。
利用 Inject 节点（定时触发器）设置Cron表达式。
利用 Function 节点计算MD5签名。
利用 HTTP Request 节点调用芯步的API。

5. 高级功能与优化配置

为了达到更好的通知效果，可以在定时任务中混合下发以下前置指令：

音量预设（定时调节）：为了避免深夜或特殊时段音量过大，可以在播报前下发音量指令。
- 命令示例：{"volume":"3"} (音量范围0-9)。
- 逻辑： 先发音量包，再发播报包；或者在一个请求中是否可以组合下发（视API版本而定，分开以保证稳定性）。
多音字与数字读法优化：芯步的TTS引擎支持数字读法标记。
- 金额： “消费 [n2]188.00 元” -> 会读作“一百八十八点零零元”。
- 手机号： “来电 [n3]13800138000“ -> 会读作“幺三八零零幺三八零零零”。
多设备同步广播：如果你的场景需要多个区域同时听到通知，可以在 device 参数中传入多个ID，用英文逗号隔开。例如： "device":"820720,820721,820722"。系统会向所有在线的设备并发下发指令。

6. 注意事项

网络稳定性： 音响必须保持Wi-Fi连接稳定。如果部署在仓库或信号死角，选用支持有线（LAN）版本的型号。
私有化部署： 如果你的系统运行在纯内网环境，且对公网依赖性要求极低，芯步支持私有化部署方案，可将API接口部署在本地服务器，实现纯局域网通信。