共享自习室语音提示：怎么把智能语音感应壁挂音箱对接到自己的项目中_解决方案

CATALOG

共享自习室的痛点是“静”与“提醒”之间的平衡——管理员既不能大声喊叫打扰他人，又要确保重要信息触达用户。芯步的智能语音感应壁挂音箱通过HTTP接口实现了远程TTS语音推送，同时支持红外感应联动，可以很好地解决这一场景需求。以下是完整的对接方案。

1. 场景需求与解决概述

在共享自习室的运营中，管理者常常面临“静音环境”与“必要通知”之间的矛盾。传统的敲门或大声喊叫会严重打扰用户学习，而手机APP推送易被忽视。如何优雅地实现“入座欢迎”、“超时提醒”、“占座催离”和“安全播报”？

本方案基于芯步的智能语音感应壁挂音箱（型号：UNI-YY-YX-BG-HW）及其开放API，为自习室管理系统（SaaS/小程序/APP）提供一套完整的语音对接方案。

该设备的优势在于：

HTTP接口远程TTS播报：无需录制语音，系统直接推送文本，音箱即时合成语音。
多端接入：支持Web、小程序、后端服务直接调用，适合现有自习室管理系统集成。
感应联动：设备自带红外感应（探测距离4m/角度120°），可实现“人来播报、人走停播”或“无人时静默”的智能模式。

2. 准备工作：API凭证与设备配网

在编写代码前，你需要完成以下基础配置：

2.1 获取API密钥

登录芯步开放平台（ThingBoot Open），进入控制台。

AppID：应用的唯一标识（如：qtyVWcgeMq）。
AppSecret：开发者密码，用于计算签名（请妥善保管）。

2.2 获取设备ID

将智能语音感应壁挂音箱通电并联网。

联网方式：支持2.4G WiFi或以太网。
设备ID：在芯步控制台的“设备列表”中查看，通常是一串数字（如：820720或1878）。

3. 接口鉴权机制

芯步的API采用动态签名鉴权，所有请求必须携带sign(签名)和ts(时间戳)。

签名算法（核心逻辑）：

注意：所有请求必须包含 ts（当前秒级时间戳）和根据上述规则计算的 sign。

4. 核心技术对接：API命令调用

该音箱支持多种控制指令。在自习室场景中，最常用的是文本播报、音量调节和红外感应配置。

4.1 发送TTS语音播报（最核心功能）

场景：用户预定时间结束前5分钟，系统自动提醒续费或离开现场时。

接口地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
请求方法：POST
Content-Type：application/json
请求Body

参数详解
- play:gbk:16：这是播报命令字，gbk表示文本编码，16是朗读速度/参数标识。
- 数字读法增强：系统支持智能识别数字，例如支付金额会自动读作“一百二十三元”。

4.2 环境音量控制

场景：夜间模式自动降低音量，白天恢复正常。

命令示例

辅助设置
- voice：音色（0女声/1男声）
- speed：语速（0-9）
- tone：语调（0-9）

4.3 红外感应与提示音联动

场景：用户进入感应范围（4米内），音箱自动播报“欢迎光临”并配合提示音，无需按下任何按钮。

使能感应播报

设置感应提示语

[message_x]是内置的提示音效（如短促“叮咚”声），可增加提示感。

4.4 强制停止与循环控制

场景：用户离开后，如果设备还在循环播放占座提醒，管理员可远程一键静音。

5. 自习室业务逻辑实战代码示例

以下是一个基于 Python + Flask 的管理后端伪代码逻辑，展示了如何将API融入自习室业务。

import hashlib
import time
import requests
import json

class SelfStudyRoom:
    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 _generate_sign(self, ts):
        # 1. MD5加密AppSecret
        step1 = hashlib.md5(self.app_secret.encode()).hexdigest()
        # 2. 拼接时间戳并再次MD5
        step2 = step1 + str(ts)
        sign = hashlib.md5(step2.encode()).hexdigest()
        return sign

def send_command(self, order_dict):
        ts = int(time.time())
        sign = self._generate_sign(ts)
        
        params = {
            "sign": sign,
            "ts": ts
        }
        payload = {
            "device": self.device_id,
            "order": order_dict
        }
        
        response = requests.post(self.api_url, params=params, json=payload)
        return response.json()

# 业务场景1:座位超时提醒
    def seat_timeout_alert(self, seat_number, minutes_left):
        text = f"{seat_number}号座位的同学，您的剩余时间仅有{minutes_left}分钟，请及时续费或收拾物品。"
        return self.send_command({"play:gbk:16": text})

# 业务场景2:不文明行为驱逐（无需喊话）
    def noisy_alert(self, seat_number):
        return self.send_command({"play:gbk:16": f"[alert_3]请注意，{seat_number}号座位区域请保持安静"})
        
    # 业务场景3:闭馆提醒
    def closing_reminder(self):
        return self.send_command({"play:gbk:16": "各位同学，本自习室将于10分钟后关闭，请带好随身物品，欢迎明天再来。"})

# 初始化设备（设备ID可以在控制台找到）
speaker = SelfStudyRoom("你的AppID", "你的AppSecret", "智能语音音箱的设备ID")

# 调用示例:触发3号座位的提醒
speaker.seat_timeout_alert(3, 5)

6. 高级架构：联动“人体传感器”实现静默通知

大多数共享自习室会希望“有人才播报，无人就静默”，以此避免设备在空场时自说自话干扰仅剩的用户。

方案升级：

购买芯步的智能人体存在雷达传感器（探测精度更高）。
联动逻辑
- 传感器探测到指定座位“有人” -> 推送指令给音箱 -> 音量调至“低”（如2级）。
- 传感器探测到“无人”且该座位订单显示“空闲” -> 推送指令给音箱 -> 播放一次“欢迎入座”语音后待机。
数据上报：传感器支持实时状态上报（HTTP Push），你的服务器需接收radar_enable状态，触发音箱指令。

7. 常见问题与排障

7.1 签名错误（401 Unauthorized）

检查时间戳：确保服务器的系统时间是准确的，与标准时间误差过大会导致鉴权失败。
MD5格式：生成的MD5需为32位小写十六进制字符串。

7.2 播报乱码或无声

编码：确保推送的文本使用 GBK 编码格式（命令中的gbk已指定）。虽然一般UTF-8也能解析，但生僻字转码。
音量：检查是否通过volume命令将音量设置为0了。

7.3 红外感应过于灵敏/迟钝

音箱参数中探测距离为4米，角度120度。安装时安装在座位走道上方，避免背对风扇等移动物体产生误报。

通过以上对接方案，你可以将普通的壁挂音箱升级为“会说话的AI管理员”，不仅降低了人工管理成本，还通过科技感提升了自习室的用户满意度。