播放文字转语音(TTS)
统一指令:controller-event-play
voice支持:
Cherry、Serena、Ethan、Chelsie、Momo、Vivian、Moon、Maia、Kai、Nofish、Bella、Jennifer、
Ryan、Katerina、Aiden、Mia、Mochi、Bellona、Vincent、Bunny、Neil、Elias、Arthur、Nini、
Ebona、Seren、Pip、Stella、Bodega、Sonrisa、Alek、Dolce、Sohee、Ono_Anna、Lenn、Emilien、
Andre、Radio_Gol、Jada、Dylan、Li、Marcus、Roy、Peter、Sunny、Eric、Rocky、Kiki
TTS调用次数说明:
1.每台设备默认享有 1000次 免费TTS调用额度,该额度由我方统一付费调用千问接口提供。
2.超出额度后,如需继续使用,请自行开通千问(通义千问)服务,获取专属AppID和密钥,后续我们将提供接口,用户可配置替换对应参数,恢复TTS调用。
3.设置次数限制旨在合理分配资源,避免因个别滥用影响整体服务稳定性,感谢您的理解与配合。
向设备发送指令 服务端向设备订阅topic发送消息
{
"action" : "tts-play",
"messageId" : "202201241610366046",
"text" : "好好学习,天天向上",
"type" : "event",
"voice" : "Cherry"
}
设备返回信息 设备向服务端订阅topic上报消息
{
"commandName" : "controller-event-play",
"mac" : "4CEBD60BFD62",
"message" : "https://smart-bird-oss.smart-bird.cn/geek-open/2026/01/19/1942138687270720.wav",
"messageId" : "202201241610366046",
"source" : "command",
"success" : true
}
播放在线音频(http)
统一指令:player-http-play
播放云端指定的音频
向设备发送指令 服务端向设备订阅topic发送消息
{
"action" : "player-http-play",
"messageId" : "202201241610366046",
"type" : "event",
"url" : "https://megface.x1.smart-bird.cn/sunday.mp3"
}
设备返回信息 设备向服务端订阅topic上报消息
{
"commandName" : "controller-event-play",
"mac" : "4CEBD60BFD62",
"message" : "https://megface.x1.smart-bird.cn/sunday.mp3",
"messageId" : "202201241610366046",
"source" : "command",
"success" : true
}
播放SD卡音频
统一指令:player-play
开始播放SD卡音频
向设备发送指令 服务端向设备订阅topic发送消息
{
"action" : "player-play",
"messageId" : "202201241610366046",
"type" : "event"
}
设备返回信息 设备向服务端订阅topic上报消息
{
"commandName" : "controller-event-player-play",
"mac" : "4CEBD60BFD62",
"message" : "resume",
"messageId" : "202201241610366046",
"source" : "command",
"success" : true
}