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