点播 API更新时间：2020-01-14 19:17:39

生成点播回放视频文件

API 地址

api.vhallyun.com/api/v1/record/create

描述

直播房间推流结束后，可通过该接口生成对应的回放视频，生成的点播文件会占用微吼云使用空间

入参

关于公共请求参数详细内容，请参考 公共请求参数。

出参

错误码

响应格式

{
    "code": 200,
    "msg": "",
    "data": {
        "record_id": "6e5692bb"
    }
}

删除点播文件

API 地址

api.vhallyun.com/api/v1/record/delete

描述

删除指定的点播文件

入参

关于公共请求参数详细内容，请参考 公共请求参数。

出参

错误码

响应格式

{
    "code": 200,
    "msg": "",
    "data": {
        "delete_record_id": "ead7e8e1"
    }
}

点播列表

API 地址

api.vhallyun.com/api/v1/record/lists

描述

按当前公共参数传入app_id对应的应用，获取点播列表

入参

关于公共请求参数详细内容，请参考 公共请求参数。

出参

错误码

响应格式

{
    "code": 200,
    "msg": "",
    "data": [
        {
            "status": 0,
            "name": "lss_f6d5ce23 2019-06-05 11:38:37",
            "created_at": "2019-06-05 11:38:37",
            "storage": 4391,
            "app_id": "e0871a28",
            "record_status": 1,
            "source": 0,
            "room_id": "lss_f6d5ce23",
            "duration": 32,
            "transcode_status": 0,
            "record_id": "f7bc91e6",
            "download_status": 0,
            "download_url": ""
        },
        {
            "status": 0,
            "name": "点播上传 2019-05-27 11:19:19",
            "created_at": "2019-05-27 11:19:19",
            "storage": 0,
            "app_id": "e0871a28",
            "record_status": 0,
            "source": 1,
            "room_id": "",
            "duration": 0,
            "transcode_status": 0,
            "record_id": "ab0a0023",
            "download_status": 0,
            "download_url": ""
        }
    ]
}

指定点播文件转码

API 地址

api.vhallyun.com/api/v1/record/trans-record

描述

配置或变更点播转码策略后不会对历史上传的视频文件进行转码，如需对历史视频转码可以调用该接口

入参

关于公共请求参数详细内容，请参考 公共请求参数。

出参

错误码

响应格式

{
    "code": 200,
    "msg": "",
    "data": []
}

获取点播文件和不同清晰度属性信息

API 地址

api.vhallyun.com/api/v1/record/get-record-info

描述

获取点播和不同清晰度的时长，空间占用信息

入参

关于公共请求参数详细内容，请参考 公共请求参数。

出参

list参数

错误码

响应格式

{
    "code": 200,
    "msg": "",
    "data": {
        "duration": 159,
        "storage": 51561,
        "created_at": "2018-02-26 14:39:28",
        "list": [
            {
                "quality": "720p",
                "storage": 15852,
                "transcode_status": 1
            },
            {
                "quality": "480p",
                "storage": 11677,
                "transcode_status": 1
            },
            {
                "quality": "360p",
                "storage": 9291,
                "transcode_status": 1
            },
            {
                "quality": "a",
                "storage": 2563,
                "transcode_status": 1
            }
        ]
    }
}

按点播ID生成下载文件

API 地址

api.vhallyun.com/api/v1/download/pre-to-multi-download

描述

按点播ID生成下载，每次都按传递的点播ID生成下载该点播下的所有清晰度文件，文件保存时间为7天。

入参

关于公共请求参数详细内容，请参考 公共请求参数。

出参

错误码

响应格式

{
    "code":200,
    "msg":"",
    "data":[
    ]
}

点播列表（直播回放）

API 地址

api.vhallyun.com/api/v1/record/live-record

描述

按当前传入的直播房间ID (room_id)，获取此房间下的点播列表

入参

关于公共请求参数详细内容，请参考 公共请求参数。

出参

错误码

响应格式

{
    "code":200,
    "msg":"",
    "data":[
        {
            "record_id":"2b8ecbd0",
            "app_id":"971990b7",
            "name":"lss_fee7b3bd 2017-12-27 23:53:54",
            "duration":4838,
            "storage":"136320",
            "created_time":"2017-12-27 23:53:54"
        },
        {
            "record_id":"c2ba7393",
            "app_id":"971990b7",
            "name":"lss_fa225532 2018-07-17 01:18:22",
            "duration":192,
            "storage":"21462",
            "created_time":"2018-07-17 01:18:22"
        }
    ]
}

再裁剪生成回放

API 地址

api.vhallyun.com/api/v1/record/create-more

描述

对已有的回放视频裁剪，并生成新的最终回放视频.

入参

point参数

[
   {
      "timePoint": 12,  #打点时间点
      "msg": "abc"      #打点文字信息
   }, {
      "timePoint": 38,
      "msg": "abc"
   }
]

cut参数

 [
   {
      "start": 1,    #int类型，裁剪片段开始时间点，秒为单位
      "end": 5       #int类型，裁剪片段结束时间点，秒为单位
   }, {
      "start": 10,
      "end": 20
   }
]

出参

错误码

响应格式

{
    "code": 200,
    "msg": "",
    "data": {
        "record_id": "6e5692bb"
    }
}

配置点播转码清晰度策略

API 地址

api.vhallyun.com/api/v1/record/set-trans-code-info

描述

用户上传视频后会对上传的视频进行转码，可通过接口配置需要转码的清晰度

• 转码配置针对应用配置，如果多个应用都需要，需要分别配置

入参

关于公共请求参数详细内容，请参考 公共请求参数。

清晰度列表

出参

错误码

响应格式

{
    "code": 200,
    "msg": "",
    "data": {
        "rate": "360P,720P"
    }
}

点播水印设置

API 地址

api.vhallyun.com/api/v1/record/set-watermark

描述

添加播放器中的水印信息

入参

关于公共请求参数详细内容，请参考 公共请求参数。

出参

错误码

响应格式

{
    "code": 200,
    "msg": "",
    "data": {
        "watermark_id": 9
    }
}

自动转码设置

API 地址

api.vhallyun.com/api/v1/record/set-auto-trans

描述

设置点播文件自动转码配置

入参

关于公共请求参数详细内容，请参考 公共请求参数。

出参

错误码

响应格式

{
    "code": 200,
    "msg": "",
    "data": {
        "auto_trans": "1"
    }
}

获取点播流量数据

API 地址

api.vhallyun.com/api/v1/record/get-stream-flow

描述

按当前公共参数传入app_id对应的应用，获取点播的流量记录

入参

关于公共请求参数详细内容，请参考 公共请求参数。

出参

错误码

响应格式

{
    "code": 200,
    "msg": "",
    "data": {
        "flow": {
            "2017-12-11": "0",
            "2017-12-12": "20400",
            "2017-12-13": "0",
        }
    }
}

获取点播文件观看信息

API 地址

api.vhallyun.com/api/v1/record/get-record-use-info

描述

获取点播的流量、pv、uv以及观看时长

入参

关于公共请求参数详细内容，请参考 公共请求参数。

出参

错误码

响应格式

{
    "code": 200,
    "msg": "",
    "data": [
        {
            "flow": 15015,
            "pv_num": 3,
            "uv_num": 1,
            "tt": 364,
            "created_time": "2019-06-24 11:00:00"
        },
        {
            "flow": 700,
            "pv_num": 1,
            "uv_num": 1,
            "tt": 29,
            "created_time": "2019-06-24 12:00:00"
        }
    ]
}

获取点播访问记录

API 地址

api.vhallyun.com/api/v1/record/get-record-join-info

描述

获取点播的游客进出记录

入参

关于公共请求参数详细内容，请参考 公共请求参数。

出参

错误码

响应格式

{
    "code": 200,
    "msg": "",
    "data": [
        {
            "uid": "1000204982",
            "start_time": "2018-03-06 11:55:00",
            "end_time": "2018-03-07 11:29:00",
            "tt": 1335,
            "pf": "7",
            "browser": "QQBrowser",
            "viewer_province": "上海"
        },
        {
            "uid": "1000204982",
            "start_time": "2018-03-06 11:57:00",
            "end_time": "2018-03-07 11:29:00",
            "tt": 1268,
            "pf": "7",
            "browser": "Chrome",
            "viewer_province": "加利福尼亚州"
        }
    ]
}

获取点播增量观看信息

API 地址

api.vhallyun.com/api/v1/record/get-records-use-info

描述

获取一段时间内的点播的流量、pv、uv以及观看时长

入参

关于公共请求参数详细内容，请参考 公共请求参数。

出参

错误码

响应格式

{
    "code": 200,
    "msg": "",
    "data": [
        {
            "flow": 11175,
            "pv_num": 1,
            "uv_num": 1,
            "tt": 447,
            "record_id": "inav_42243747",
            "start_time": "2018-08-15 16:00:00",
            "end_time": "2018-08-15 17:00:00"
        },
        {
            "flow": 2225,
            "pv_num": 1,
            "uv_num": 1,
            "tt": 89,
            "record_id": "inav_42243747",
            "start_time": "2018-08-15 17:00:00",
            "end_time": "2018-08-15 18:00:00"
        }
    ]
}

获取点播下载流量

API 地址

api.vhallyun.com/api/v1/download/get-download-flow

描述

按当前公共参数传入app_id对应的应用，获取点播的下载流量

入参

关于公共请求参数详细内容，请参考 公共请求参数。

出参

错误码

响应格式

{
    "code":200,
    "msg":"",
    "data":[
        {
            "flow":14415,
            "download_time":"2018-03-14 16:00:00"
        },
        {
            "flow":14415,
            "download_time":"2018-03-16 10:00:00"
        },
        {
            "flow":28830,
            "download_time":"2018-03-16 11:00:00"
        }
    ]
}