怎样接入8路HTTP接口包间控制器来实现语音播报TTS远程通知_解决方案

CATALOG

这是一篇关于利用芯步智能硬件实现包间语音通知的解决方案。

1 背景与需求

在共享棋牌室、茶室、足浴店、剧本杀店等无人值守服务型门店中，经营者常常面临一个痛点：当顾客需要服务（如加水、点餐、续时）或订单即将到期时，如何高效、准确地通知店内人员或顾客？传统的灯光闪烁或蜂鸣器报警往往信息量不足，而人工喊话又显得不够智能。

本方案基于芯步智能包间控制器（Max版） 及其配套的TTS语音播报生态产品，通过标准的HTTP接口，实现“远程触发-精准播报”的自动化闭环。方案的目标是解决以下三个核心需求：

远程通知：当包间内顾客按下呼叫按钮（通过控制器IO接口接入）或消费时长即将用尽时，系统自动向指定区域（前台或包间内）发送语音通知。
定时提醒：在包间预定结束前10分钟，自动通过语音播报提醒顾客续时，避免超时纠纷。
无人化服务：结合订单系统，当新订单生成时，自动播报“X号包间有客人已下单，请准备”，引导工作人员服务。

2 系统架构与硬件选型

为实现上述功能，系统采用“云-管-端”架构，由业务系统（SaaS/本地服务器）通过互联网调用芯步开放API，控制店内的终端硬件。

硬件清单

设备名称	型号/规格	数量	核心作用
智能包间控制器	Max	1台/包间	控制包间内8路电路通断（门锁、空调、麻将机等），并接入物理传感器（如呼叫按钮）。
TTS语音播报设备	智能语音喇叭3 / 音柱	1-2台/门店	接收HTTP推送的文本，通过硬件级TTS芯片合成语音，进行现场或远程播报。
网络环境	WiFi / 有线网络	-	确保设备与芯步云平台保持长连接，实现毫秒级指令响应。

选型说明：方案的核心在于“控制”与“通知”的联动。控制器负责物理世界的感知（开关量）与执行（通断），而语音设备则负责信息的显性化输出。两者虽为独立硬件，但均通过统一的芯步云平台进行管理，逻辑上可视为一个联动系统。

3 接口对接与签名机制

所有对设备的控制（无论是控制继电器通断还是TTS播报）均需通过芯步提供的统一开放接口完成。为了保证安全性，每一次请求都需要携带动态生成的签名（Sign）。

3.1 签名生成算法

在开始编程前，开发者需先在芯步控制台获取 AppID 和 AppSecret。

参数说明
- AppSecret：开发者密码（用于加密）。
- ts：当前Unix时间戳（秒），防止重放攻击。
生成步骤
1. 将 AppSecret 进行第一次MD5加密，得到 Secret_MD5。
2. 将上一步得到的 Secret_MD5 与时间戳 ts 拼接（直接连接字符串）。
3. 将拼接后的字符串再进行一次MD5加密，得到最终的 sign。
公式sign = md5( md5(AppSecret) + ts )
代码示例（Python） ：
import hashlib import time def generate_sign(app_secret, ts): # 第一步:md5(app_secret) secret_md5 = hashlib.md5(app_secret.encode()).hexdigest() # 第二步:拼接 combined = secret_md5 + str(ts) # 第三步:再次md5 sign = hashlib.md5(combined.encode()).hexdigest() return sign # 使用示例 app_id = "YOUR_APP_ID" app_secret = "YOUR_APP_SECRET" ts = int(time.time()) sign = generate_sign(app_secret, ts) # 最终请求地址 url = f"https://api.thingboot.com/{app_id}/device/control/?sign={sign}&ts={ts}"

3.2 公共请求参数

每次HTTP POST请求需包含以下参数：

参数名	位置	类型	说明
`AppID`	URL Path	String	控制台获取的应用ID
`sign`	URL Query	String	按上述算法生成的签名
`ts`	URL Query	Int	生成签名时使用的Unix时间戳
`device`	Body (JSON)	String	目标设备ID（如控制器ID或喇叭ID）
`order`	Body (JSON)	Object	具体的控制指令（JSON对象）

4 核心功能实现：电路控制与TTS播报

本部分演示如何通过具体的HTTP请求，实现“检测到呼叫 -> 播报语音”的逻辑。

4.1 第一种场景：控制包间设备通断

场景描述：当客人扫码支付成功后，系统自动开启包间门禁和总电源。

接口地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}

请求方式POST

请求Body（JSON） ：

指令详解order 字段中的 power 后跟数字代表端口号（1-8），1 代表开启，0 代表关闭。

4.2 第二种场景：TTS文本转语音播报

场景描述：当系统接收到呼叫信号或订单即将到期时，向前台喇叭或包间内喇叭发送语音指令。

请求Body（JSON） ：

指令详解

play:gbk:16：这是播报命令的关键字。其中 16 通常代表音量或编码格式，标准文本播报可直接使用此格式。
高级播报：若需调整音色、语速，可发送多个命令组合。

高级播报示例（静音模式切换或优先级播报） ：

此方案支持0-9级语速、语调调节，内置5种提示音（如“叮咚”），适合在播报正文前增加警示音以吸引注意。

4.3 第三种场景：逻辑联动实现（关键步骤）

单纯的指令调用是不够的，需要业务后端编写逻辑。以下是典型的服务呼叫处理流程

触发：客人按下包间内的物理按钮，该按钮接入 8路控制器 的某一路（例如第3路信号线）。
感知：业务系统通过轮询或设备回调机制，检测到该路状态由 0 变为 1。
解析：系统判定该包间（例如Room_3）产生了“服务请求”事件。
执行
- 动作A：调用API复位该呼叫按钮（{"power3": 0}），避免重复触发。
- 动作B：调用API向前台播报设备发送TTS指令：“3号包间呼叫服务，请前往”。
- 动作C：（可选）同时向3号包间内喇叭发送：“服务员已收到请求，请稍等”，安抚顾客情绪。

5 代码实战示例

以下提供 Python 和 Shell 两种常见环境的实战代码片段，演示如何向设备发送播报命令。

5.1 Python 脚本示例（适合后端集成）

import requests
import hashlib
import time
import json

# 配置信息
APP_ID = "YOUR_APP_ID"       # 替换为你的AppID
APP_SECRET = "YOUR_SECRET"   # 替换为你的AppSecret
DEVICE_ID = "820720"         # 替换为你的语音喇叭ID

def tts_notify(text):
    # 1. 生成时间戳和签名
    ts = int(time.time())
    secret_md5 = hashlib.md5(APP_SECRET.encode()).hexdigest()
    sign_str = secret_md5 + str(ts)
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    
    # 2. 构造URL和Header
    url = f"https://api.thingboot.com/{APP_ID}/device/control/"
    params = {
        "sign": sign,
        "ts": ts
    }
    headers = {
        "Content-Type": "application/json"
    }
    
    # 3. 构造Body
    payload = {
        "device": DEVICE_ID,
        "order": {
            "play:gbk:16": text
        }
    }
    
    # 4. 发起请求
    try:
        response = requests.post(url, params=params, headers=headers, json=payload, timeout=5)
        print(f"状态码: {response.status_code}")
        print(f"响应内容: {response.text}")
    except Exception as e:
        print(f"请求失败: {e}")

# 调用示例
if __name__ == "__main__":
    tts_notify("欢迎光临，请扫码开门。")

5.2 Shell + cURL 示例（适合快速调试）

对于运维人员或快速测试，可以直接使用 Shell 脚本。

6 方案优势与实施

6.1 技术优势

毫秒级响应：从接口调用到语音播报，端到端延迟约80-300ms，几乎无感知。
高可听性：硬件级TTS芯片合成的语音自然、柔和，在嘈杂环境中仍能清晰辨识。
极低成本：相比短信通知（每条几分钱），WiFi语音播报除了硬件成本外，流量几乎免费，尤其适合高频重复提醒场景。

6.2 实施

设备分组：在芯步管理后台，将同一包间的控制器和喇叭绑定在同一个虚拟“房间”下，便于管理设备ID。
日志记录：在实际业务系统中，应记录每一次API调用的返回结果。若返回非200状态码或错误信息，可通过重试机制保障指令送达。
内容审核：TTS播报直接面向顾客，需确保推送的文本内容礼貌、得体。在关键播报前加入提示音（如 {"alert":"1"}），避免突然发声惊吓顾客。

通过上述方案，门店仅需利用芯步的开放接口，即可将传统的包间控制器升级为会“说话”的智能管家，实现全流程的无人化、智能化管理。