# 媒体播放
# 获取播放列表
HTTP Method:GET
请求地址:https://uvs-biz.hivoice.cn/rest/v1/media_player/play_list
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| appkey | String | Y | 产品KEY |
| deviceId | String | Y | 设备标识 |
| deviceToken | String | Y | 设备令牌 |
| userId | String | Y | 用户ID |
| type | String | Y | 资源类型, 音频: audio / 视频: video |
| pageNo | Integer | N | 页码 |
| pageSize | Integer | N | 数量 |
返回值
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| errorCode | String | Y | 响应code,成功为0,具体见错误码定义 |
| errorMsg | String | Y | 响应描述 |
| result | Object | Y | 返回的结果数据 |
| └subTitle | String | Y | 子标题 |
| └author | String | Y | 作者 |
| └imageUrl | String | Y | 图片链接 |
| └bgImageUrl | String | Y | 背景图片链接 |
| └title | String | Y | 标题 |
| └token | String | Y | 资源标识 |
| └stream | Object | Y | 云端媒体流信息 |
| └└linkFlag | String | Y | 选链标识 |
| └└url | String | Y | 资源播放链接 |
| └└totalContentPlayTime | String | Y | 资源播放时间 |
| └lyric | Object | Y | 资源文本内容 |
| └└format | String | Y | 文本格式 |
| └└url | String | Y | 内容链接 |
| └provider | Object | Y | 提供商信息 |
| └└name | String | Y | 提供商名称 |
| └└logoUrl | String | Y | 提供商logo地址 |
返回结果示例:
{
"errorCode": "0",
"errorMsg": "请求成功",
"result": [{
"subTitle": "",
"stream": {
"linkFlag": "1",
"expiryTime": "",
"offsetInMilliseconds": "",
"totalContentPlayTime": "",
"url": "http://10.20.222.143:8068/unios-data-uslink/rest/v1/link/get_data_link?dataSourceCode=child&dataType=child&resourceType=2"
},
"lyric": {
"format": "",
"url": ""
},
"provider": {
"name": "爱音乐",
"logoUrl": ""
},
"author": "",
"imageUrl": "http://resources.hivoice.cn/audio/pic/7ea8d3fe-2998-4f5f-958f-1957c5489f8d.jpg",
"bgImageUrl": "",
"title": "忘情水(央视2016全球中文音乐榜上榜)",
"token": "1000122459"
},{
"subTitle": "",
"stream": {
"linkFlag": "1",
"expiryTime": "",
"offsetInMilliseconds": "",
"totalContentPlayTime": "",
"url": "http://10.20.222.143:8068/unios-data-uslink/rest/v1/link/get_data_link?dataSourceCode=child&dataType=child&resourceType=2"
},
"lyric": {
"format": "",
"url": ""
},
"provider": {
"name": "爱音乐",
"logoUrl": ""
},
"author": "",
"imageUrl": "http://resources.hivoice.cn/audio/pic/151f3d6b-ed42-4907-bb73-634780e31c32.jpg",
"bgImageUrl": "",
"title": "忘情水(最美和声)",
"token": "1000122457"
}]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
# 获取播放详情
HTTP Method:GET
请求地址:https://uvs-biz.hivoice.cn/rest/v1/media_player/play_detail
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| appkey | String | Y | 产品KEY |
| deviceId | String | Y | 设备标识 |
| deviceToken | String | Y | 设备令牌 |
| userId | String | Y | 用户ID |
| token | String | Y | 资源唯一标识(列表中的token) |
返回值
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| errorCode | String | Y | 响应code,成功为0,具体见错误码定义 |
| errorMsg | String | Y | 响应描述 |
| result | Object | Y | 返回的结果数据 |
| └subTitle | String | Y | 子标题 |
| └author | String | Y | 作者 |
| └imageUrl | String | Y | 图片链接 |
| └bgImageUrl | String | Y | 背景图片链接 |
| └title | String | Y | 标题 |
| └token | String | Y | 资源标识 |
| └stream | Object | Y | 云端媒体流信息 |
| └└linkFlag | String | Y | 选链标识 |
| └└url | String | Y | 资源播放链接 |
| └└totalContentPlayTime | String | Y | 资源播放时间 |
| └lyric | Object | Y | 资源文本内容 |
| └└format | String | Y | 文本格式 |
| └└url | String | Y | 内容链接 |
| └provider | Object | Y | 提供商信息 |
| └└name | String | Y | 提供商名称 |
| └└logoUrl | String | Y | 提供商logo地址 |
返回结果示例:
{
"result": [
{
"subTitle": "",
"stream": {
"linkFlag": "1",
"expiryTime": "",
"offsetInMilliseconds": "",
"totalContentPlayTime": "",
"url": "http://10.20.222.143:8068/unios-data-uslink/rest/v1/link/get_data_link?dataSourceCode=child&dataType=child&resourceType=2"
},
"lyric": {
"format": "",
"url": ""
},
"provider": {
"name": "爱音乐",
"logoUrl": ""
},
"author": "",
"imageUrl": "http://resources.hivoice.cn/audio/pic/151f3d6b-ed42-4907-bb73-634780e31c32.jpg",
"bgImageUrl": "",
"title": "忘情水(最美和声)",
"token": "1000122457"
}
],
"errorCode": "0",
"errorMsg": "请求成功"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
# 播放内容
HTTP Method:POST
请求地址:https://uvs-biz.hivoice.cn/rest/v1/media_player/play
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| appkey | String | Y | 产品KEY |
| deviceId | String | Y | 设备标识 |
| deviceToken | String | Y | 设备令牌 |
| userId | String | Y | 用户ID |
| offsetInMilliseconds | Long | N | 播放位置 |
| token | String | N | 资源唯一标识 |
| type | String | Y | 资源类型, 音频: audio / 视频: video |
| url | String | Y | 播放链接 |
| linkFlag | Integer | Y | 是否需要选链(1.是 0.否) |
| providerName | String | Y | 内容提供商名称 |
返回值
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| errorCode | String | Y | 响应code,成功为0,具体见错误码定义 |
| errorMsg | String | Y | 响应描述 |
返回结果示例:
{
"errorCode": "0",
"errorMsg": "请求成功"
}
1
2
3
4
2
3
4
# 错误码定义及描述
| errorCode | errorMsg | 描述 |
|---|---|---|
| 0 | 请求成功 | 成功 |
| 8400001 | 必填参数不能为空 | 必填参数不能为空 |
| 8400002 | 请求参数不合法 | 请求参数格式不正确,或者参数不满足需要的条件 |
| 8400003 | 设备token无效 | 设备token无效 |
| 8400005 | 未发现需要更新的唤醒词 | 上传的唤醒词都在使用中 |
| 8400006 | 未发现设备sdk版本 | |
| 8401001 | 唤醒词打分异常 | 唤醒词打分异常 |
| 8401002 | 唤醒词正在制作中 | 唤醒词正在制作中 |
| 8404444 | 调用第三方服务异常 | 调用第三方服务异常 |
| 8409999 | 系统异常 | 联系管理员 |