# 媒体播放

# 获取播放列表

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

# 获取播放详情

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

# 播放内容

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

# 错误码定义及描述

errorCode errorMsg 描述
0 请求成功 成功
8400001 必填参数不能为空 必填参数不能为空
8400002 请求参数不合法 请求参数格式不正确,或者参数不满足需要的条件
8400003 设备token无效 设备token无效
8400005 未发现需要更新的唤醒词 上传的唤醒词都在使用中
8400006 未发现设备sdk版本
8401001 唤醒词打分异常 唤醒词打分异常
8401002 唤醒词正在制作中 唤醒词正在制作中
8404444 调用第三方服务异常 调用第三方服务异常
8409999 系统异常 联系管理员