怎样对接8 路远程包间电源管理模块来实现语音播报TTS远程通知_解决方案

CATALOG

这是一个面向“共享棋牌室、茶室或足浴店”场景的解决方案。结合芯步产品的开放特性，我们可以将 8路电源控制 与 TTS语音播报 分为两条独立指令链，通过业务服务器进行逻辑编排。

以下是详细的对接方案：

1. 概述

在包间（如棋牌室、影音房、KTV）运营中，常需由前台控制房间电源及进行语音通知（如“时间到”、“欢迎光临”、“有访客”）。

本方案基于芯步两款硬件：

8路智能控制器（AC版本）：用于控制包间内的插座、照明、麻将机等电源。
智能语音播报设备（如智能语音音柱/喇叭）：负责接收文本并合成语音进行广播通知。

通过调用统一的 HTTP API，实现业务系统（SaaS/POS/小程序后端）对硬件的远程双控。

2. 硬件选型与准备

2.1 8路远程包间电源管理模块

产品型号：智能控制器8路（AC 85-265V）。
对接要点
- 支持8路独立控制，对应包间内的空调、麻将机、照明、排气扇等。
- 提供power1至power8命令字，以及batch批量控制命令。
- 注意：总负载限制为4400W（阻性），接感性负载（电机/节能灯）需降额使用。

2.2 TTS语音播报设备

产品型号：智能语音音柱（大音量适合公区）或智能语音喇叭3（桌面/前台）。
对接要点
- 支持HTTP/HTTPS指令推送，无需预录音，直接传输中文字符串即可合成语音。
- 支持音量（0-9）、语速（0-9）、音色（男/女）在线调整。

3. 接口对接架构

flowchart LR
    subgraph A[管理员操作端]
        A1[前台PC软件]
        A2[手机APP/小程序]
    end

    subgraph B[云端/本地服务器]
        B1[芯步开放API
api.thingboot.com]
        B2[你的业务服务器
（规则引擎/逻辑处理）]
    end

    subgraph C[门店现场硬件]
        C1[8路智能控制器
（控制电源通断）]
        C2[智能语音音柱
（TTS播报）]
    end

    A1 -- HTTP请求 --> B2
    A2 -- HTTP请求 --> B2
    B2 -- 1. 鉴权与签名 --> B1
    B1 -- 2. 下发控制指令 --> C1
    B1 -- 2. 下发播报文本 --> C2
    C1 -- 3. 执行断电/通电 --> D[包间电器]
    C2 -- 3. 语音合成 --> E[现场人员听到通知]

4. 关键对接技术实现步骤

4.1 通用鉴权机制（签名计算）

所有硬件指令下发都需经过API网关鉴权。基于用户资料，核心参数生成逻辑如下：

AppId：应用ID，标识你的项目。
AppSecret：开发者密码。
ts：当前Unix时间戳（秒）。
sign：动态签名。
- 算法sign = md5( md5(AppSecret) + ts )。

4.2 第一种场景：远程控制电源（断电/供电）

目标：前台点击“开台”，自动接通第1路（照明）和第4路（麻将机）；点击“结账”，断开所有电源。

接口信息

URLhttps://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}
Method：POST
Content-Type：application/json

请求Body示例（开台/通电）

请求Body示例（结账/断电）

说明order字段即为设备命令字典，powerX对应第X路，1为通，0为断。支持单路或多路组合下发。

4.3 第二种场景：TTS远程语音播报

目标：当包间剩余时间不足15分钟时，自动向对应区域（或公共走廊）的喇叭发送“XX包间时间快到了，是否需要续费？”。

接口信息：同上（统一控制接口）。

请求Body示例（TTS播报）

注意play:gbk:16 是标准的TTS播报命令，设备端硬件合成语音，延迟在80-300ms之间。

4.4 高级联动逻辑（业务代码实现）

你需要在自己的服务器上实现联动触发器，这是解决方案的核心。

伪代码逻辑示例（Python思路）

接收事件：系统检测到订单状态变更为“已支付”（开台）。
执行动作
# 1. 打开该包间的电源（照明+主设备） control_power(device_id_power, {"power1":1, "power4":1}) # 2. 通过大厅广播播报欢迎词（或仅播报给该包间内的独立喇叭） tts_speak(device_id_tts, "欢迎张先生，祝您消费愉快！")
定时巡检
- 监听数据库中的订单剩余时间。
- 当 剩余时间 == 15分钟
  tts_speak(device_id_tts, "您的余额即将不足，请及时续费。")
异常处理：当检测到“强制关机”按钮点击：
control_power(device_id_power, {"batch":0}) # 全断 tts_speak(device_id_tts, "设备已断电，请携带好随身物品。")