GemeOpen 远程音频音乐智能音箱-WiFi版 (型号：GSSM0B) - 开发者指令
# 远程音频音乐智能音箱-WiFi版 (型号：GSSM0B) - 开发者指令
## 产品基本描述
一款支持远程控制的迷你音箱，可存储歌曲500首高品质MP3，最多支持4个音箱组网，定义前置左右声道、环绕左右声道，
Wifi网络连接，MQTT通信协议，支持远程指令下载音频文件以及播放指定的音频。
Wifi网络连接，MQTT通信协议，支持远程指令下载音频文件以及播放指定的音频。
## 产品主要特点
WiFi网络，支持本地云端音频播放
TTS语音转文字，48种拟人音色
20段EQ调节，到点语音插播
5V2A供电
TTS语音转文字，48种拟人音色
20段EQ调节，到点语音插播
5V2A供电
## 官网产品资料
### 产品详细信息
### 淘宝购买网址
https://item.taobao.com/item.htm?id=1006049039837
### 京东购买网址
### 开发者文档
https://www.smart-bird.cn/doc/product/GSSM/device/GSSM0B/command
## 产品电气参数
---
| 参数名 | 参数值 |
|------|------|
|
品牌
| GemeOpen
|
|
上市日期
| 2026年
|
|
产品类型
| 远程音频音乐播放器-WiFi版
|
|
产品型号
| GSSM0B
|
|
外观尺寸
| 87mm*87mm*63mm
|
|
输入电压
| 直流5V
|
|
工作电流
| 200mA
|
|
通讯方式
| 2.4GHz WIFI
|
|
通讯模块
| 乐鑫ESP32-S3
|
|
供电接口
| Type-C
|
|
阻抗功率
| 4Ω/12W
|
|
振动膜规格
| 2寸方形52mm<
|
|
腔体设计
| 自研腔体结构设计，减少失真并提升音质
|
|
外壳材质
| ABS 塑料
|
---
## 全部指令
### null
*controller-event-player-set-eq*
设置20个eq值，第一个表示左声道31hz的 ，第二个表示左声道62hz的.。。。 第十个表示右声道31hz的.。。。
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
| String
| 指令
| player-set-eq
|
|
eq-value
| List
| eq值，范围（-13~13）dB，1-20个值分别对应 左(31/62/125/250/500/1000/2000/4000/8000/16000)，右(31/62/125/250/500/1000/2000/4000/8000/16000)
| [-13, -13, -13, -13, -13, -13, -13, -13, -13, -13, -13, -13, -13, -13, -13, -13, -13, -13, -13, -13]
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
type
| String
| 类型
| event
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
| String
| 指令名称
| controller-event-player-set-eq
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| fc012cd18460
|
|
message
| String
| 执行返回结果
| eq success
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
source
| String
| 指令回复“command"
| command
|
|
success
| boolean
| 执行结果
| true
|
---
### null
*controller-reset*
恢复出厂设置后配网信息和自定义信息都会清空，请谨慎操作！
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
system
| String
| 复位
| reset
|
|
type
| String
| 设置
| setting
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
| String
| 指令名称
| controller-reset
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| fc012cd18460
|
|
message
| String
| 执行返回结果
| ok
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
source
| String
| 指令回复“command"
| command
|
|
success
| boolean
| 执行结果
| true
|
---
### null
*controller-restart*
软重启后，通过指令设置的参数将生效，同时设备将重新连接Wifi/4G网络，注意设备IP地址可能发生变化
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
{
"messageId" : "202201241610366046",
"system" : "restart",
"type" : "setting"
}
"messageId" : "202201241610366046",
"system" : "restart",
"type" : "setting"
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
system
| String
| 重启
| restart
|
|
type
| String
| 设备设置固定传"setting"
| setting
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
{
"commandName" : "controller-restart",
"mac" : "fc012cd18460",
"message" : "ok",
"messageId" : "202201241610366046",
"source" : "command",
"success" : true
}
"commandName" : "controller-restart",
"mac" : "fc012cd18460",
"message" : "ok",
"messageId" : "202201241610366046",
"source" : "command",
"success" : true
}
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
| String
| 指令名称
| controller-restart
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| fc012cd18460
|
|
message
| String
| 执行返回结果
| ok
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
source
| String
| 指令回复“command"
| command
|
|
success
| boolean
| 执行结果
| true
|
---
### null
*info*
获取设备信息一般会包含：设备通断电状态、MAC/IMEI、固件版本、设备内网IP地址、设备WIFI网络名称等信息，不同的产品返回的信息有所差异
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
type
| String
| 指令名称
| info
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
type
| int
| 设备型号
| GSSM0B
|
|
commandName
| String
| 指令名称
| info-all
|
|
ip
| String
| 设备连接WIFI后获取的IP
| 192.168.122.119
|
|
keyLock
| int
| 按键锁，0：关闭，1：开启
| 0
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| fc012cd18460
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
signal
| int
| 信号强度，显示规则为： signal<= 0 && signal>= -50
//信号最好 signal< -50 && signal>= -70
//信号较好 signal< -70 && signal>= -80
//信号一般 signal<-80 && signal>= -100
//信号较差 signal没有在0～（-100)之间，表示无信号
| -75
|
|
source
| String
| 指令回复“command"
| command
|
|
ssid
| String
| 设备当前连接的WIFI名称
| GemeOpen
|
|
version
| String
| 当前固件版本号
| 1.0.4
|
|
wifiLock
| int
| 配网锁，0：关闭，1：开启
| 0
|
---
### null
*info-protocol*
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
type
| String
| 通讯信息
| protocol
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
clientId
| String
| 自定义MQTT客户端ID注意：不可重复
| 8CBFEA87B750
|
|
commandName
| String
| 指令名称
| info-protocol
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| 4CEBD60BFD62
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
port
| String
| 端口号
| 1883
|
|
protocol
| String
| 协议类型，MQTT协议固定传"mqtt"
| mqtt
|
|
publish
| String
| 自定义MQTT发布主题 注意:不可重复
| /topic/qos0
|
|
server
| String
| 自定义MQTT服务器地址
| 192.168.0.66
|
|
source
| String
| 指令回复“command"
| command
|
|
subcribe
| String
| 自定义MQTT订阅主题注意：不可重复
| /topic/qos1
|
|
username
| String
| 自定义MQTT服务器用户名
| admin
|
---
### null
*player-add-vol*
<br/>
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
| String
| 指令
| player-add-vol
|
|
channel
| String
| 通道
| left
|
|
freq
| int
| 频率，单位(Khz)
| 31
|
|
gain
| int
| 增益，单位dB，范围-13到13。
| -13
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
type
| String
| type
| event
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
channel
| String
| 左右
| left
|
|
commandName
| String
| 指令名称
| controller-event-player-add-vol
|
|
freq
| int
| 频率，单位(Khz)
| 31
|
|
gain
| int
| 增益，单位dB，范围-13到13。
| -13
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| fc012cd18460
|
|
message
| String
| 执行返回结果
| vol:70
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
name
| String
| 歌曲名字
| 001.mp3
|
|
size
| int
| 歌曲大小（单位字节）
| 12099546
|
|
source
| String
| 指令回复“command"
| command
|
|
success
| boolean
| 执行结果
| true
|
---
### null
*player-delete*
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
| String
| 指令名称
| player-delete
|
|
messageId
| String
| 消息ID字段
| 1241610366046
|
|
name
| String
| 音频名
| 周杰伦.flac
|
|
type
| String
| 类型
| event
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
| String
| 指令名称
| controller-event-player-delete
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| 4CEBD60BFD62
|
|
message
| String
| 执行返回结果
| delete success
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
source
| String
| 指令回复“command"
| command
|
|
success
| boolean
| 执行结果
| true
|
---
### null
*player-download*
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
| String
| 指令名称
| download
|
|
filepath
| String
| 文件保存的路径和名字
| /sdcard/music/饿狼传说.mp3
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
type
| String
| 类型
| event
|
|
url
| String
| 下载的http地址
| http://smart-bird-oss.smart-bird.cn/music/2025/%E9%A5%BF%E7%8B%BC%E4%BC%A0%E8%AF%B4.mp3
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
| String
| 指令名称
| controller-event-httpDownload
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| 4CEBD60BFD62
|
|
message
| String
| 执行返回结果
| download start
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
source
| String
| 指令回复“command"
| command
|
|
success
| boolean
| 执行结果
| true
|
---
### null
*player-http-play*
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
| String
| 指令名称
| player-http-play
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
type
| String
| 类型
| event
|
|
url
| String
| 播放的音频网址
| https://megface.x1.smart-bird.cn/sunday.mp3
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
| String
| 指令名称
| controller-event-play
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| 4CEBD60BFD62
|
|
message
| String
| 执行返回结果
| https://megface.x1.smart-bird.cn/sunday.mp3
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
source
| String
| 指令回复“command"
| command
|
|
success
| boolean
| 执行结果
| true
|
---
### null
*player-http-play-save*
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
| String
| 指令名称
| player-http-play-save
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
name
| String
| 保存到SD卡上的名字
| test_output.mp3
|
|
type
| String
| 类型
| event
|
|
url
| String
| 播放的音频网址
| https://megface.x1.smart-bird.cn/sunday.mp3
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
| String
| 指令名称
| controller-event-play
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| 4CEBD60BFD62
|
|
message
| String
| 执行返回结果
| start
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
source
| String
| 指令回复“command"
| command
|
|
success
| boolean
| 执行结果
| true
|
---
### null
*player-info*
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
| String
| 指令名称
| player-info
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
type
| String
| 类型
| event
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
001.MP3
| String
| 歌曲名字
| |
|
channel
| String
| 左右通道
| left
|
|
commandName
| String
| 指令名称
| controller-event-player-info
|
|
eq
| Object
| eq值，channel（right）：表示右通道；freq（16000）：表示16Khz；gain（0）：表示增益为0
| |
|
fileCount
| int
| 文件数量
| 1
|
|
freq
| int
| 频率，单位(hz)
| 31
|
|
gain
| int
| 增益，单位dB，范围-13到13。
| -13
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| 4CEBD60BFD62
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
name
| String
| 歌曲名字
| 001.mp3
|
|
player-mode
| String
| 播放器模式："OnePlay","OneLoopPlay","ListPlay","ListLoopPlay",
| ListLoopPlay
|
|
sdCardFreeSpace
| int
| 内存卡剩余空间，单位：MB
| 256
|
|
sdCardTotalSpace
| int
| 内存卡总大小，单位：MB
| 512
|
|
sdCardUsage
| int
| 内存卡使用率，单位：%
| 26
|
|
size
| int
| 歌曲大小（单位字节）
| 12099546
|
|
songs
| Object
| 所有歌曲信息
| |
|
source
| String
| 指令回复“command"
| command
|
|
vol
| int
| 音量大小，单位：0-100
| 60
|
---
### null
*player-next*
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
| String
| 指令名称
| player-next
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
type
| String
| 类型
| event
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
| String
| 指令名称
| controller-event-player-next
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| 4CEBD60BFD62
|
|
message
| String
| 执行返回结果
| file://sdcard/music/014.mp3
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
source
| String
| 指令回复“command"
| command
|
|
success
| boolean
| 执行结果
| true
|
---
### null
*player-pause*
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
| String
| 指令名称
| player-pause
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
type
| String
| 类型
| event
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
| String
| 指令名称
| controller-event-player-pause
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| 4CEBD60BFD62
|
|
message
| String
| 执行返回结果
| pause
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
source
| String
| 指令回复“command"
| command
|
|
success
| boolean
| 执行结果
| true
|
---
### null
*player-play*
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
| String
| 指令名称
| player-play
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
type
| String
| 类型
| event
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
| String
| 指令名称
| controller-event-player-play
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| 4CEBD60BFD62
|
|
message
| String
| 执行返回结果
| resume
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
source
| String
| 指令回复“command"
| command
|
|
success
| boolean
| 执行结果
| true
|
---
### null
*player-prev*
<br/>
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
| String
| 指令名称
| player-prev
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
type
| String
| 类型
| event
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
| String
| 指令名称
| controller-event-player-prev
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| 4CEBD60BFD62
|
|
message
| String
| 执行返回结果，播放的歌曲地址
| file://sdcard/music/test.mp3
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
source
| String
| 指令回复“command"
| command
|
|
success
| boolean
| 执行结果
| true
|
---
### null
*player-sd-play*
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
| String
| 指令名称
| player-sd-play
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
name
| String
| 音频名字
| test2.mp3
|
|
type
| String
| 类型
| event
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
| String
| 指令名称
| controller-event-play
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| 4CEBD60BFD62
|
|
message
| String
| 执行返回结果
| file://sdcard/music/test2.mp3
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
source
| String
| 指令回复“command"
| command
|
|
success
| boolean
| 执行结果
| true
|
---
### null
*player-set-mode*
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
| String
| 指令名称
| player-set-mode
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
player-mode
| String
| 播放器模式："OnePlay","OneLoopPlay","ListPlay","ListLoopPlay",
| ListLoopPlay
|
|
type
| String
| 类型
| event
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
001.MP3
| String
| 歌曲名字
| |
|
channel
| String
| 左右通道
| left
|
|
commandName
| String
| 指令名称
| controller-event-player-set-mode
|
|
freq
| int
| 频率，单位(Khz)
| 31
|
|
gain
| int
| 增益，单位dB，范围-13到13。
| -13
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| fc012cd18460
|
|
message
| String
| 执行返回结果
| ok
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
name
| String
| 歌曲名字
| 013.mp3
|
|
size
| int
| 歌曲大小（单位字节）
| 9828332
|
|
source
| String
| 指令回复“command"
| command
|
|
success
| boolean
| 执行结果
| true
|
---
### null
*player-set-vol*
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
| String
| 指令名称
| player-set-vol
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
type
| String
| 类型
| event
|
|
value
| int
| 音量值
| 40
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
001.MP3
| String
| 歌曲名字
| |
|
channel
| String
| 左右通道
| left
|
|
commandName
| String
| 指令名称
| controller-event-player-set-vol
|
|
freq
| int
| 频率，单位(Khz)
| 31
|
|
gain
| int
| 增益，单位dB，范围-13到13。
| -13
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| fc012cd18460
|
|
message
| String
| 执行返回结果
| vol:60
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
name
| String
| 歌曲名字
| 001.mp3
|
|
size
| int
| 歌曲大小（单位字节）
| 12099546
|
|
source
| String
| 指令回复“command"
| command
|
|
success
| boolean
| 执行结果
| true
|
---
### null
*player-stop*
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
| String
| 指令名称
| player-stop
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
type
| String
| 类型
| event
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
| String
| 指令名称
| controller-event-player-stop
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| 4CEBD60BFD62
|
|
message
| String
| 执行返回结果
| stop success
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
source
| String
| 指令回复“command"
| command
|
|
success
| boolean
| 执行结果
| true
|
---
### null
*player-sub-vol*
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
| String
| 指令名称
| player-sub-vol
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
type
| String
| 类型
| event
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
001.MP3
| String
| 歌曲名字
| |
|
channel
| String
| 左右通道
| left
|
|
commandName
| String
| 指令名称
| controller-event-player-sub-vol
|
|
freq
| int
| 频率，单位(Khz)
| 31
|
|
gain
| int
| 增益，单位dB，范围-13到13。
| -13
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| fc012cd18460
|
|
message
| String
| 执行返回结果
| vol:50
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
source
| String
| 指令回复“command"
| command
|
|
success
| boolean
| 执行结果
| true
|
---
### null
*setting-mqtt*
设备支持自定义MQTT，注意：在通过MQTT自定义MQTT信息后，需要将设备断电重启或者向设备发送重启命令才可生效。
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
clientId
| String
| 自定义MQTT客户端ID注意：不可重复
| admin
|
|
password
| String
| 密码
| 123456
|
|
port
| String
| 端口号
| 1883
|
|
protocol
| String
| 协议类型，MQTT协议固定传"mqtt"
| mqtt
|
|
publish
| String
| 自定义MQTT发布主题 注意:不可重复
| /topic/qos0
|
|
server
| String
| 自定义MQTT服务器地址
| 192.168.0.66
|
|
subcribe
| String
| 自定义MQTT订阅主题注意：不可重复
| /topic/qos1
|
|
type
| String
| 设备设置固定传"setting"
| custom
|
|
username
| String
| 自定义MQTT服务器用户名
| admin
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
clientId
| String
| 自定义MQTT客户端ID注意：不可重复
| admin
|
|
commandName
| String
| 指令名称
| setting-mqtt
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| 4CEBD60BFD62
|
|
port
| String
| 端口号
| 1883
|
|
protocol
| String
| 协议类型，MQTT协议固定传"mqtt"
| mqtt
|
|
publish
| String
| 自定义MQTT发布主题 注意:不可重复
| /topic/qos0
|
|
server
| String
| 自定义MQTT服务器地址
| 192.168.0.66
|
|
source
| String
| 指令回复“command"
| command
|
|
subcribe
| String
| 自定义MQTT订阅主题注意：不可重复
| /topic/qos1
|
|
username
| String
| 自定义MQTT服务器用户名
| admin
|
---
### null
*setting-tcp*
设备支持通过MQTT方式自定义TCP信息，注意：通过MQTT自定义TCP信息后，需要将设备断电重启或者向设备发送重启命令才可生效。
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
port
| String
| 端口号
| 8080
|
|
protocol
| String
| 协议类型，TCP协议固定传"tcp"
| tcp
|
|
server
| String
| 自定义MQTT服务器地址
| 192.168.0.66
|
|
type
| String
| 设备设置固定传"setting"
| custom
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
| String
| 指令名称
| setting-tcp
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| 4CEBD60BFD62
|
|
port
| String
| 端口号
| 8080
|
|
protocol
| String
| 协议类型，MQTT协议固定传"mqtt"
| tcp
|
|
server
| String
| 自定义MQTT服务器地址
| 192.168.0.66
|
|
source
| String
| 指令回复“command"
| command
|
---
### null
*setting-wifi-lock*
wifi配网锁定后，设备无法通过长按配网按钮进入配网操作，仅能通过MQTT/TCP协议解锁配网功能<br/>
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
type
| String
| 类型
| setting
|
|
wifiLock
| int
| 配网锁，0：关闭，1：开启
| 0
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
| String
| 指令名称
| setting-wifi-lock
|
|
connMethod
| String
| 网络连接方式wifi，ethernet，4G
| wifi
|
|
dhcpEnable
| int
| 自动寻址1：开启， 0：关闭，默认开启
| 1
|
|
ip
| String
| 设备连接WIFI后获取的IP
| 192.168.122.119
|
|
keyLock
| int
| 按键锁，0：关闭，1：开启
| 0
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| 4CEBD60BFD62
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
signal
| int
| 信号强度，显示规则为： signal<= 0 && signal>= -50
//信号最好 signal< -50 && signal>= -70
//信号较好 signal< -70 && signal>= -80
//信号一般 signal<-80 && signal>= -100
//信号较差 signal没有在0～（-100)之间，表示无信号
| -75
|
|
source
| String
| 指令回复“command"
| command
|
|
ssid
| String
| 设备当前连接的WIFI名称
| GemeOpen
|
|
type
| String
| 设备类型
| GSSM0B
|
|
version
| String
| 当前固件版本号
| 1.0.4
|
|
wifiLock
| int
| 配网锁，0：关闭，1：开启
| 0
|
---
### null
*tts-play*
voice支持：<br/>Cherry、Serena、Ethan、Chelsie、Momo、Vivian、Moon、Maia、Kai、Nofish、Bella、Jennifer、<br/>Ryan、Katerina、Aiden、Mia、Mochi、Bellona、Vincent、Bunny、Neil、Elias、Arthur、Nini、<br/>Ebona、Seren、Pip、Stella、Bodega、Sonrisa、Alek、Dolce、Sohee、Ono_Anna、Lenn、Emilien、<br/>Andre、Radio_Gol、Jada、Dylan、Li、Marcus、Roy、Peter、Sunny、Eric、Rocky、Kiki<br/><br/>TTS调用次数说明：<br/>1.每台设备默认享有 1000次 免费TTS调用额度，该额度由我方统一付费调用千问接口提供。<br/>2.超出额度后，如需继续使用，请自行开通千问（通义千问）服务，获取专属AppID和密钥，后续我们将提供接口，用户可配置替换对应参数，恢复TTS调用。<br/>3.设置次数限制旨在合理分配资源，避免因个别滥用影响整体服务稳定性，感谢您的理解与配合。
**向设备发送指令（服务端向设备订阅topic发送消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
action
| String
| 指令
| tts-play
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
text
| String
| 文字转语音文本
| 好好学习，天天向上
|
|
type
| String
| 类型
| event
|
|
voice
| String
| 通义大模型，千问TTS 音色选择
| Cherry
|
---
**设备返回信息（设备向服务端订阅topic上报消息）**
```json
```
#### 字段属性
---
| 字段名称 | 字段类型 | 字段说明 | 示例值 |
|------|------|------|------|
|
commandName
| String
| 指令名称
| controller-event-play
|
|
mac
| String
| wifi设备MAC地址或4G设备的IMEI号，唯一标识
| 4CEBD60BFD62
|
|
message
| String
| 执行返回结果
| https://smart-bird-oss.smart-bird.cn/geek-open/2026/01/19/1942138687270720.wav
|
|
messageId
| String
| 消息ID字段
| 202201241610366046
|
|
source
| String
| 指令回复“command"
| command
|
|
success
| boolean
| 执行结果
| true
|
---
