酒店客房语音提示场景：怎么把智能语音壁挂音箱款式2对接到自己的项目中_解决方案

CATALOG

芯步智能语音壁挂音箱款式2基于HTTP接口，支持TTS文本播报、音量/音色调节等能力，可以低代码集成到酒店PMS或入住系统中。以下是完整的对接方案：

1. 场景概述与需求分析

在酒店数字化升级中，客房语音提示系统能有效提升服务效率和住客体验。典型需求包括：

入住/退房提示：保洁人员或前台实时获知客房状态变更。
服务请求播报：住客通过客房电话或APP呼叫服务（如“需要毛巾”），音箱在指定区域（如服务间）播报。
安防与紧急广播：发生火警或紧急情况时，语音提醒工作人员或住客。
个性化欢迎：住客进入客房，播报个性化欢迎语及天气信息。

智能语音壁挂音箱款式2（型号：UNI-YY-YX-BG）具以下特性，适合该场景：

HTTP/TTS远程播报：无需预先录音，直接推送文本转语音。
音质与音量调节：适合酒店客房走廊等半开放环境。
即插即用/简易安装：DC 12V供电，壁挂安装，降低施工难度。

2. 智能语音壁挂音箱款式2 技术规格

（基于芯步公开数据）

项目	参数/说明
产品型号	`UNI-YY-YX-BG`
网络连接	Wi-Fi 2.4GHz 802.11 b/g/n
控制协议	HTTP API (芯步云平台)
核心功能	TTS文本播报（支持GBK编码）、音量/语速/语调调节、铃声/提示音播放
支持命令	`volume` (音量0-9), `voice` (音色0女/1男), `speed` (语速0-9), `play:gbk:16` (播报文本), `ring` / `message` / `alert` (内置音效)
供电	DC 12V 2A
安装方式	壁挂（防火V0级PC外壳，尺寸约175x175x90mm）

3. 对接设计

为了实现稳定、低延迟的控制，推荐采用 “PMS/业务系统 -> 芯步云API -> 音箱设备” 的标准云对云架构。

核心流程

设备激活与配网：音箱通电后，通过配网模式连接酒店Wi-Fi。
业务触发：前台在PMS（物业管理系统）办理入住/退房，或住客通过客房平板提交服务请求。
调用接口：业务后端服务器携带AppID、AppSecret和音箱DeviceID，计算签名并调用芯步API。
执行播报：芯步云将指令推送到指定音箱，音箱实时TTS播报。

sequenceDiagram
    participant PMS as 酒店PMS/后端服务
    participant TB as 芯步云API
    participant Device as 智能语音壁挂音箱

    Note over Device: 设备上电并联网
    PMS->>TB: POST /device/control (文本指令+签名)
    TB-->>PMS: 返回指令接收状态
    TB->>Device: 长连接下发播报任务
    Device-->>TB: 上报执行结果
    TB-->>PMS: 回调或可查询状态
    Device->>Device: TTS播报:"3210房间请速打扫"

4. 详细对接步骤

4.1 前期准备

注册与认证：访问芯步开发者平台，注册企业账号。
获取密钥：在控制台获取 AppID 和 AppSecret（API调用密钥）。
设备配网：长按音箱按钮6秒进入配网模式，使用“芯步”APP或SDK配置Wi-Fi（确保网络能访问api.thingboot.com）。

4.2 API 调用机制

所有控制命令基于HTTP POST请求，需携带签名 sign 和时间戳 ts 防止重放攻击。

请求地址https://api.thingboot.com/{AppID}/device/control/?sign={sign}&ts={ts}
签名算法sign = md5( md5(AppSecret) + ts )注：此处 + 为字符串拼接。需先将 AppSecret 进行第一次MD5加密得到字符串S，再将 S 与时间戳 ts （字符串形式）拼接后进行第二次MD5加密。

4.3 下发播报指令（核心TTS）

请求方式POSTContent-Typeapplication/jsonBody

高级播报示例

带数字/金额优化{"play:gbk:16":"您本次消费[n2]288元"}
带提示音{"play:gbk:16":"[message_3]前台呼叫，请速回电话"}

4.4 设备状态与音量预设

在初始化或入住办理时设置音量，避免声音过大或过小。

设置音量{"order": {"volume": 7}}
设置音色{"order": {"voice": 0}}（0女声，1男声）

5. 代码示例（服务端集成）

以下示例演示如何在酒店后端中封装API调用。

Python 3.10+ (使用 requests)

import hashlib
import time
import requests
import json

class YoYoSpeaker:
    def __init__(self, app_id, app_secret):
        self.app_id = app_id
        self.app_secret = app_secret
        self.base_url = f"https://api.thingboot.com/{app_id}/device/control/"

def _gen_sign(self, ts):
        # 签名算法: md5(md5(secret) + ts)
        md5_secret = hashlib.md5(self.app_secret.encode()).hexdigest()
        sign_str = md5_secret + str(ts)
        return hashlib.md5(sign_str.encode()).hexdigest()

def send_command(self, device_id, order_dict):
        ts = int(time.time())
        sign = self._gen_sign(ts)
        url = f"{self.base_url}?sign={sign}&ts={ts}"
        
        payload = {
            "device": device_id,
            "order": order_dict
        }
        headers = {'Content-Type': 'application/json'}
        
        response = requests.post(url, headers=headers, data=json.dumps(payload))
        return response.json()

# 业务调用示例
speaker = YoYoSpeaker("Your_AppID", "Your_AppSecret")

# 场景1:客房打扫提醒
speaker.send_command("device_id_001", {"play:gbk:16": "服务提示:3202房间请求打扫"})

# 场景2:调节音量并播报
speaker.send_command("device_id_001", {"volume": 6})
speaker.send_command("device_id_001", {"play:gbk:16": "欢迎光临，请出示您的身份证"})

Java (Spring Boot - RestTemplate)

import org.springframework.web.client.RestTemplate;
import org.springframework.http.*;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;

public class YoyoSpeakerService {
    private String appId = "Your_AppID";
    private String appSecret = "Your_AppSecret";
    
    private String getMd5(String input) {
        try {
            MessageDigest md = MessageDigest.getInstance("MD5");
            byte[] digest = md.digest(input.getBytes());
            StringBuilder sb = new StringBuilder();
            for (byte b : digest) sb.append(String.format("x", b));
            return sb.toString();
        } catch (NoSuchAlgorithmException e) { return null; }
    }
    
    public void speak(String deviceId, String text) {
        long ts = System.currentTimeMillis() / 1000L;
        String md5Secret = getMd5(appSecret);
        String sign = getMd5(md5Secret + ts);
        
        String url = String.format("https://api.thingboot.com/%s/device/control/?sign=%s&ts=%d", appId, sign, ts);
        
        RestTemplate restTemplate = new RestTemplate();
        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_JSON);
        
        // order 结构:{"play:gbk:16": text}
        String body = String.format("{\"device\":\"%s\",\"order\":{\"play:gbk:16\":\"%s\"}}", deviceId, text);
        HttpEntity<String> entity = new HttpEntity<>(body, headers);
        
        ResponseEntity<String> response = restTemplate.exchange(url, HttpMethod.POST, entity, String.class);
        System.out.println("API Response: " + response.getBody());
    }
}

6. 酒店场景部署实施要点

6.1 网络环境兼容

防火墙策略：确保酒店Wi-Fi允许音箱访问外网 api.thingboot.com（通常为443端口）。
MAC地址准入：若酒店采用MAC白名单认证，需提前获取音箱MAC地址（通常贴于设备背面或通过配网日志获取）。

6.2 设备管理策略

命名规范：将 DeviceID 与房号/区域绑定，例如 DeviceID_1201 对应“12楼01号客房门口”，并维护在PMS系统的配置表中。
分组管理：在芯步控制台可对音箱进行分组（如“行政楼层”、“客房服务部”），方便统一调节音量或批量测试。

6.3 错误处理与重试

超时重试：若接口调用超时或返回网络错误，重试3次，间隔500ms。
播报防冲突：酒店PMS需做好状态控制，避免同时下发两条播报导致“打架”。可通过设置 order 中的 stop 命令或维护业务队列来实现。

7. 总结

芯步的智能语音壁挂音箱款式2凭借其标准的 TTS-HTTP接口 和简单的 MD5签名机制，能够非常方便地融入酒店现有PMS系统。开发者无需关注底层音频流处理，只需在对应业务逻辑处（如订单状态变更）插入几行HTTP请求代码，即可实现高效、清晰、可配置的语音提示系统，显著提升酒店运营的数字化水平和响应速度。