获取背景音乐列表
1.接口描述
接口说明:获取背景音乐列表。
请求方式:
- 固件版本 V2.6.0 及以上:POST [ip]/mwapi/V2.0/bgm/get-bgm-list
- 固件版本 V2.5.0 及以下:POST [ip]/mwapi/get-bgm-list
管理员权限 | 登录认证 |
---|---|
否 | 是 |
2.输入参数
无
3.输出参数
参数名称 | 类型 | 描述 |
---|---|---|
result | Int | 状态码 |
message | String | 状态描述 |
info | InfoData | 背景音乐信息 |
InfoData
参数名称 | 类型 | 描述 |
---|---|---|
totalCount | 背景音乐总数 | |
musicList | Array of MusicListData | 背景音乐列表 |
MusicListData
参数名称 | 类型 | 描述 |
---|---|---|
title | String | 歌曲名称 |
id | Int | 当前背景音乐的资源ID,音频文件在设备中的唯一身份标识。 |
duration | Int | 时长 (单位:毫秒) |
artist | String | 演唱者/演奏者 |
4.示例
获取背景音乐列表
输入示例
None
输出示例
{
"info": {
"musicList": [
{
"artist": "Magewell",
"duration": 31000,
"id": 2098,
"title": "Music 01"
},
{
"artist": "Magewell",
"duration": 41000,
"id": 2100,
"title": "Music 03"
},
{
"artist": "Magewell",
"duration": 71000,
"id": 2099,
"title": "Music 02"
}
],
"totalCount": 3
},
"message": "success",
"result": 0
}
5.错误码
无接口业务逻辑相关的错误码,其他错误码详见 公共错误码。