如何在广场语音通知中中对接智能设备以实现内置铃声提示音播放_解决方案

CATALOG

广场、园区、社区等场景中，语音通知常需配合特定铃声来区分消息紧急程度或类型。芯步的智能语音设备（如智能语音喇叭3、智能语音音柱）已内置了多种提示音和铃声，通过其开放的HTTP接口即可远程调用，无需上传音频文件。以下方案以“广场语音通知”场景为例，详细说明实现流程。

1. 背景与需求

在现代商业广场、工业园区或智慧社区中，公共广播系统通常需要播放各类语音通知，如“开门大吉”、“消防疏散”、“寻人启启事”或“温馨提醒”。单纯的语音播报缺乏辨识度，若能结合特定的内置铃声（如紧急警报、短促提示音、迎宾音乐），可以更快地吸引人员注意，提升通知的有效性。

芯步的智能语音硬件（如智能语音喇叭3、智能语音音柱Pro）具备“即插即用、HTTP接口开放、内置多种铃声”的特点，支持远程调用。本解决方案的目标是利用其开放API，在广场现有软件系统（如SaaS平台、APP或中控台）中，实现“先播铃声、后播语音”或“纯铃声提示”的双重播报模式。

2. 技术选型与设备能力

基于芯步开放平台的特性，本方案采用如下技术架构：

通信协议：HTTPS / HTTP（支持公网与局域网私有化部署）。
接口类型：设备控制命令（POST请求，JSON数据格式）。
核心设备：智能语音喇叭3、智能语音音柱Pro60W。
关键能力
- 内置资源：设备内置5种提示音、5种铃声、5种警示音（无需上传文件）。
- TTS播报：支持直接推送文本进行语音合成（男女声、语速语调可调）。
- 可视化提醒：部分设备支持同步控制LED灯光（如红色闪烁配合警报）。

3. 接口对接方案设计

要实现“先响铃、后说话”或“只响铃”，核心在于利用 order 命令字段中的 ring（响铃）和 speak（播报）参数。

3.1 接口认证与请求构建

芯步的API采用动态签名验证机制，所有请求需携带 AppID、sign（签名）、ts（时间戳）。

请求地址示例：

https://api.thingboot.com/{Your_AppID}/device/control/？sign={计算所得签名}&ts={当前时间戳}

签名算法（MD5）：

graph LR
    A[AppSecret密钥] --> B(MD5加密)
    B --> C[拼接时间戳ts]
    C --> D(MD5加密)
    D --> E[最终签名sign]

注：具体为 sign = md5( md5(AppSecret) + ts )。

3.2 核心命令设计

针对“广场语音通知”场景，我们定义以下三种核心指令，封装在 order 的JSON结构中：

功能类型	命令示例（JSON）	场景应用描述
紧急警示	`{“ring”：0， “speak”：“消防演练，请有序撤离”}`	`ring`对应内置警报类型，通常循环播放
业务提示	`{“ring”：2， “speak”：“请XX号顾客到服务台”}`	短促提示音后接语音，避免前台直接喊话的尴尬
迎宾播报	`{“ring”：1， “speak”：“欢迎光临”， “loop”：1}`	有人经过雷达触发，播放轻松铃声后播报

3.3 编程实现逻辑

以下使用 Javascript (Node.js) 示例，展示如何在后端服务中编排这两个动作。

const crypto = require(‘crypto’）；
const axios = require(‘axios’）；

// 配置参数
const config = {
    appId: ‘YOUR_APP_ID’，       // 芯步控制台获取
    appSecret: ‘YOUR_SECRET’，   // 开发者密码
    deviceId: ‘YOUR_DEVICE_ID’，  // 音柱设备ID
    apiUrl: ‘https://api.thingboot.com’
}；

// 生成签名
function generateSign（ts） {
    const md5Secret = crypto.createHash(‘md5’）.update(config.appSecret）.digest(‘hex’）；
    const signRaw = md5Secret + ts；
    return crypto.createHash(‘md5’）.update(signRaw）.digest(‘hex’）；
}

// 核心:播报含铃声的通知
async function playNotificationWithRing（ringType， message） {
    const ts = Math.floor(Date.now() / 1000）；
    const sign = generateSign(ts）；

// 关键点:order 组合了 ring 和 speak
    // 假设 ringType: 0-警报， 1-提示， 2-铃声
    const orderCommand = {
        "ring": ringType，   // 先触发内置铃声
        "speak": message，   // 紧接着TTS语音播报
        "volume": 80        // 设置音量为80%
    }；

const requestData = {
        "device": config.deviceId,
        "order": JSON.stringify(orderCommand)
    }；

try {
        const response = await axios.post(
            `${config.apiUrl}/${config.appId}/device/control/？sign=${sign}&ts=${ts}`,
            requestData,
            { headers: { ‘Content-Type’: ‘application/json’ } }
        ）；
        console.log(‘指令下发成功:’， response.data）；
    } catch （error） {
        console.error(‘播报失败:’， error）；
    }
}

// 场景调用示例
// 1. 紧急情况:播放警报铃声（假设type 0是警报） + 疏散语音
playNotificationWithRing(0， "紧急通知:发生火警，请从东侧楼梯撤离"）；

// 2. 寻人启事:播放柔和提示音（假设type 2是提示音） + 寻人语音
playNotificationWithRing(2， "温馨提示:请张小明小朋友到服务台，您的家人正在等候"）；

命令执行逻辑说明由于该系列设备固件支持多命令排队，当服务器同时下发包含 ring 和 speak 的指令时，设备通常会立即执行铃声播放，铃声结束后自动执行语音播报，符合“提示+内容”的听觉逻辑。

4. 场景部署与触发流程

4.1 广场中控台集成

将上述API集成到广场现有的物业管理平台或Web端控制台中。操作界面可设计为：

紧急模板：绑定“消防警报铃声” + 固定疏散文本。
商业模板：绑定“叮咚提示音” + 自定义输入文本（如“XX店铺优惠活动”）。

4.2 自动化联动场景（高级）

结合芯步的传感器类产品（如人体存在雷达），可实现全自动化触发：

感知：雷达传感器检测到有人进入音柱感应范围（上报 {“radar_enable”：1}）。
触发：服务器接收到传感器数据，通过规则引擎调用上述 playNotificationWithRing 接口。
执行：音柱播放内置迎宾铃声 + “欢迎光临，请佩戴口罩”的语音提醒。

4.3 时序控制（防冲突机制）

若广场同时有多条通知下发，需在软件层做简单的队列管理。

策略：当设备正在播放时，新的请求可设置 {“wait”： true} 或由服务器缓存排队，待收到设备空闲状态的回调后再下发，避免语音重叠。

5. 关键参数配置调优

参数名称	值	作用描述
`volume`	60-100	广场环境嘈杂，设置较高音量；夜间模式可动态调低至40
`ring` 类型	0-4	查阅设备手册确定不同Index对应的具体音效（如doorbell、alert）
`speak` 编码	GBK/UTF-8	中文播报需注意编码格式，避免乱码（部分老固件GBK）
`retry` 机制	3次	网络波动时，失败重试机制保证播报必达

6. 总结

通过芯步标准化的HTTP开放接口，广场管理系统可无需改造原有硬件线路，仅通过软件层面的接口调用，即可实现内置铃声 + TTS语音的双重播报能力。

效率提升：无需录制MP3文件，通过文字转语音和API调用，可实现秒级响应。
体验优化：利用内置的5种差异化铃声，帮助工作人员和顾客在听觉上迅速区分“紧急事件”与“普通商业广播”。
扩展性：未来可进一步集成门禁、烟雾传感器等，实现“检测到烟雾 -> 触发警报铃声 -> 播报疏散指令”的全自动安防闭环。