酒店客房语音提示场景：怎么把智能86型远程控制语音喇叭对接到软件项目中_解决方案

CATALOG

芯步的86型智能语音喇叭采用HTTP接口设计，无需复杂协议适配，只需调用API即可实现文本转语音播报。以下方案从接口对接、代码示例到酒店场景应用，给出完整的落地路径。

一、解决概述

在酒店客房场景中，语音提示是实现“服务找人”的关键环节。传统的灯光提示或电话通知往往无法第一时间引起服务人员注意，而通过将 智能86型远程控制语音喇叭 集成到酒店的 PMS（物业管理系统）或客房服务软件中，可以实现工单、呼叫、警报的实时语音落地。

本方案基于芯步的 UNI-YY-LB-86 型号智能语音喇叭（标准86型底盒，支持WiFi/HTTP接口）进行开发对接。

核心价值：

即插即用：直接替换标准86型墙壁面板，无需复杂布线。
文本即语音：无需预先录音，软件后端直接推送文本，设备瞬间发声。
多场景覆盖：支持客房服务呼叫、退房提醒、安防警报、清扫通知等。

二、硬件与接口准备

在开始对接前，需完成以下物理与账号准备工作：

硬件部署：在酒店走廊、保洁工作间、前台或特定客房内安装智能86喇叭。因其采用标准86底盒，需接入 100-250V 交流电，并确保安装位置覆盖 2.4GHz WiFi 信号。
平台账号：注册芯步开发者账号，登录控制台创建工作区，获取 AppID 和 AppSecret（开发者密码）。
设备ID：在控制台添加设备，获取每个喇叭的唯一标识 Device ID（设备ID）。命名规则如：Floor2_Room_Service 或 Reception_Desk，方便后期管理。

三、接口对接技术方案

该产品的核心优势在于接口透明，只要软件项目能发起 HTTPS/HTTP 请求（无论后端是 Java、Python、PHP 还是前端 JS），均可轻松集成。

1. 核心接口

使用 设备控制接口 向指定设备下发命令。

请求地址： https://api.thingboot.com/{AppID}/device/control/
鉴权方式：动态签名（Sign）验证，防止接口被恶意调用。

2. 鉴权计算规则

为了避免硬编码密码泄露风险，签名计算在服务端完成。公式：sign = md5( md5(AppSecret) + ts )

AppSecret：开发者密码。
ts：当前 Unix 时间戳（秒）。

3. 核心命令下发——语音播报

这是酒店场景中最常用的功能。你只需要向设备发送一个包含 play:gbk:16 字段的 JSON 指令。

命令示例（让喇叭播报“欢迎入住”）：

注：gbk:16 代表文本编码及音量强度，支持中文数字混合播报。

4. 高级控制指令

为了让体验更符合酒店场景，还需要配置音量、音色及特定的提示音。

常用命令集

功能描述	命令字段	示例值
设置音量	`volume`	`{"volume":"7"}` (范围0-9)
切换男/女声	`voice`	`{"voice":"1"}` (0女声,1男声)
播放门铃/提示音	`message`	`{"message":"3"}` (内置5种提示音)
播放警示音	`alert`	`{"alert":"2"}` (内置5种警示音)
停止播报	`stop`	`{"stop":"0"}` (0停止当前)

四、酒店场景实战代码案例

以下提供一个 Python 后端的核心代码逻辑，演示如何封装一个“酒店语音通知函数”。你可以在你的 Web 后端或桌面端软件中调用此函数。

import hashlib
import time
import requests
import json

# 配置信息 (从芯步物控台获取)
APP_ID = "你的AppID"
APP_SECRET = "你的AppSecret"

def send_hotel_voice(device_id, text_message, volume=7):
    """
    向指定客房喇叭发送语音通知
    :param device_id: 喇叭的设备ID
    :param text_message: 要播报的文本 (例如: "请打扫302房间")
    :param volume: 音量大小 0-9
    """
    
    # 1. 生成时间戳和签名
    ts = int(time.time())
    # 计算规则: md5( md5(密钥) + 时间戳 )
    sign = hashlib.md5( 
        (hashlib.md5(APP_SECRET.encode()).hexdigest() + str(ts)).encode() 
    ).hexdigest()
    
    # 2. 构建请求URL
    url = f"https://api.thingboot.com/{APP_ID}/device/control/"
    params = {
        "sign": sign,
        "ts": ts
    }
    
    # 3. 构建指令 (先调音量，再播报)
    # 注意:order 是一个 JSON 字符串
    order_data = {
        "volume": str(volume),          # 调节音量
        "play:gbk:16": text_message    # 播报文本
    }
    
    payload = {
        "device": device_id,
        "order": json.dumps(order_data)
    }
    
    # 4. 发起请求
    try:
        response = requests.post(url, params=params, data=payload, timeout=5)
        result = response.json()
        
        if result.get("code") == 200:
            print(f"通知发送成功: {text_message}")
            return True
        else:
            print(f"发送失败: {result}")
            return False
    except Exception as e:
        print(f"接口异常: {e}")
        return False

# --- 业务调用示例 ---
if __name__ == "__main__":
    # 假设走廊的喇叭设备ID为 1132001
    # 当PMS系统收到退房通知时，自动调用此方法提醒保洁
    send_hotel_voice("1132001", "[注意] 2308房间客人已退房，请尽快打扫。", volume=8)

五、对接PMS及业务流程集成

要真正实现“智能化”，不能仅停留在发送文字，需要将语音喇叭与你的软件业务逻辑深度绑定。以下是三个典型的集成场景：

1. “一键清洁”或“送物”呼叫

触发点：客人按下客房内的智能开关或通过小程序提交需求。
软件逻辑：你的后端接收到请求后，解析出房间号（如 “1808”）和服务类型（如 “需要毛巾”）。
语音动作：系统调用上述接口，向保洁中心或走廊的喇叭推送指令：
播报内容：“客房服务呼叫，1808房间需要毛巾，请及时处理。”
效果：保洁人员无需看手机或对讲机，通过广播即可获取任务。

2. 退房联动与打扫调度

触发点：前台收银系统操作“退房结账”。
软件逻辑：触发数据库事件。
语音动作：系统自动向对应楼层的卫生工作间喇叭发送指令：
播报内容：“请打扫 1206 房间。”

3. 异常警告（防破坏/吸烟）

触发点：客房内的烟感传感器或震动传感器告警。
软件逻辑：判定为高风险事件。
语音动作：通过喇叭发送警示音及警告
播报内容：“警示：房间内烟雾浓度过高，请立即处理！”

六、接口调试与排错

根据官方文档及开发经验，对接过程中应注意以下常见问题

HTTP 200 但喇叭不响？
- 原因：设备可能离线。检查设备电源及 WiFi 信号。
- 原因：order 中的命令参数格式错误。请严格参考产品说明书中的 play:gbk:16 字段。
签名错误（501/502错误）
- 检查 AppID 和 AppSecret 是否正确。
- 检查服务器时间是否与标准时间同步（误差可能导致签名失效）。
播报乱码或无声
- play:gbk:16 中的 gbk 指定了编码格式。在大部分编程语言中，确保发送的中文字符串为 UTF-8 格式，库会自动转换，一般无需额外处理，若乱码可尝试强制转码。

七、总结

通过将芯步86型智能语音喇叭的 HTTP接口 接入软件项目，酒店可以以极低的开发成本实现全区域、高并发的语音调度能力。该方案无需昂贵的 IP 广播系统，利用现有网络和标准的 86 面板安装，即可将客房服务响应效率提升至秒级，有效解决“服务滞后”、“响应不及时”的痛点。