CATALOG

一、我们为什么需要它?

先说说场景。在教研教室里,我们经常遇到这样的痛点:老师在录课或者开展教研活动时,需要定时提醒“还剩5分钟”、“请开始分组讨论”;或者设备出了故障,需要立刻通知技术人员;又或者有紧急情况(比如火警演练)需要全教室广播。

传统的做法是:让助教在后面举牌子,或者老师自己看表打断讲课节奏。这太原始了。

而芯步这款10W云TTS语音壁挂音箱,刚好能解决这个问题——它可以通过HTTP接口直接推送文字,然后实时合成语音播报,不需要提前录音,也不需要人工操作

二、这玩意儿到底是什么?

简单介绍一下这个硬件:

  • 型号:UNI-YY-YX-BG-PRO-10W(也有有线网版UNI-YY-YX-BG-LAN-10W)

  • 连接方式:WiFi 2.4G(有线网版走网线),不需要网关,直接连路由器就行

  • 核心能力:接收HTTP推送的文本,实时TTS转语音播报,支持调节音量、音色、语速、语调

  • 安装方式:壁挂,直接钉在教室墙上,插电就能用

  • 特色:支持私有化部署,纯局域网也能跑

简单来说,它就是一个长在墙上、连了网、能说话的音箱。你给它发一句话,它就念出来。

三、整体对接思路

我们把整个方案分成三层:

  1. 设备层:就是那台10W壁挂音箱,安装在每间教研教室里

  2. 云平台层:芯步的开放平台,负责设备管理、状态维护、命令转发

  3. 应用层:你们的教学管理系统、教研辅助软件、或者一个简单的定时脚本

对接的核心就是:你们的应用系统 → 调用芯步HTTP接口 → 音箱播报

整个过程不需要关心硬件细节,就像调一个第三方API一样简单。

四、准备工作(一次配置,长期使用)

4.1 注册开发者账号

去芯步官网注册账号,进入控制台,创建一个“工作台”。你会拿到两个关键信息:

  • AppID:你的应用标识

  • AppSecret:你的应用密钥(千万别泄露

4.2 给音箱配网

拿到设备后,需要通过芯步的控制台或者小程序给它连上教室的WiFi:

  1. 在控制台的“网络配置”里,录入教室WiFi的名称和密码(必须是2.4G频段)

  2. 长按音箱上的配网按钮,进入配网模式

  3. 音箱会自动搜索并连接

配网成功后,控制台的设备列表里就会出现这台音箱,并且能看到它的在线状态(online.status = 1代表在线)。

4.3 拿到设备ID

每个设备都有一个唯一的ID(比如1878),这个ID就是后续调用接口时的“收件人地址”。你可以在控制台的设备详情页找到它。

五、核心对接步骤(手把手教你调接口)

5.1 签名计算(这是唯一的坑,填平它)

芯步的接口为了安全,要求每次请求都带签名。规则是这样的:

sign = md5( md5(AppSecret) + ts )

其中ts是当前时间戳(单位秒)。

举个栗子假设你的AppSecret = "abc123",当前ts = 1700000000

  1. 先算md5("abc123"),得到202cb962ac59075b964b07152d234b70

  2. 把这个结果和时间戳拼接:202cb962ac59075b964b07152d234b701700000000

  3. 再对这个字符串做一次MD5,得到最终的sign

代码示例(Java)

代码示例(PHP)

代码示例(Python)

5.2 播报一条消息(核心接口)

请求地址

请求头

请求体(JSON)

这里"play:gbk:16"就是播报命令,其中:

  • play:表示播放语音

  • gbk:文本编码格式

  • 16:音量级别(0-100,数值越大越响)

5.3 完整的调用示例(Java + Unirest)

5.4 更多定制能力

除了基本的