# 媒体播放
# 获取播放列表
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 | 系统异常 | 联系管理员 |