云课回放相关

日期: 2019-01-22 创盛视联数码科技(北京)有限公司

[TOC]

一、合流回放

1.1 查询回放列表

  • 描述
    通过该接口可以分页获取回放列表的信息
  • 地址
 http://api.csslcloud.net/api/v2/record/info
  • 方法
POST/GET
  • 请求参数
参数名称 参数类型 参数说明 备注
roomid 字符串 直播间id 必须
userid 字符串 CC账户ID 必须
pagenum 整型 每页显示的个数 可选,系统默认值为50
pageindex 整型 页码 可选,系统默认值为1
starttime 字符串 查询起始时间,如需按时间范围查询可添加该参数和下面的endtime参数,该查询是按直播的开始时间作为查询条件的 可选,如果填写该参数则endtime参数必填;精确到分钟,例:"2015-01-01 12:30"
endtime 字符串 查询截止时间 可选,如果填写该参数则starttime必填;精确到分钟,例:"2015-01-02 12:30"
liveid 字符串 直播id 可选,将只查询该直播下的回放信息
  • 返回数据格式
{
   "result" : "OK",    # 请求是否成功。OK:成功;FAIL:失败
   "count" : "100",    # 回放总数
   "pageIndex" : "1",  # 页码
   "records" : [       # 回放列表信息
       {
           "id" : "753C612EB38A8D5A",            # 回放id
           "liveId" : "853C612EB38A8D5A",        # 直播id
           "startTime" : "2015-01-01 00:00:00",  # 开始时间
           "stopTime" : "2015-01-01 23:00:00",   # 结束时间
           "recordStatus": 1,                    # 录制状态,0表示录制未结束,1表示录制完成
           "recordVideoId" : "953C612EB38A8D5A", # 录制视频id,如果recordStatus为0则返回-1
           "replayUrl" : "http://xxx",           # 回放地址,当recordStatus为0时返回""
           "offlinePackageUrl" : "http://yyy",   # 离线包下载地址,注:只有开通离线播放权限才会返回该参数
           "offlinePackageMd5" : "xxxxxdddddddddddddddddddddddddddd" # 离线包md5,注:只有开通离线播放权限才会返回该参数
       },
       ...
   ]
}

1.2 查询回放信息

  • 描述
   通过该接口获取单个回放信息
  • 地址
 http://api.csslcloud.net/api/v2/record/search
  • 方法
POST/GET
  • 请求参数
参数名称 参数类型 参数说明 备注
userid 字符串 CC账户ID 必须
recordid 字符串 回放id 必须
  • 返回数据格式
{
  "result" : "OK", # 请求是否成功。OK:成功;FAIL:失败
  "record" : {     # 回放信息
          "id" : "753C612EB38A8D5A",       # 回放Id
          "liveId" : "853C612EB38A8D5A",   # 直播Id
          "startTime" : "2015-01-01 00:00:00", # 开始时间, 格式为"yyyy-MM-dd HH:mm:ss"
          "stopTime" : "2015-01-01 23:00:00",  # 结束时间, 格式为"yyyy-MM-dd HH:mm:ss", 如果直播未结束,该值则为""
          "recordStatus": 1, # 录制状态,0表示录制未结束,1表示录制完成
          "recordVideoId" : "953C612EB38A8D5A", # 录制视频id,如果recordStatus为0则返回-1
          "replayUrl" : "http://xxx", # 回放地址,当recordStatus为0时返回""
          "offlinePackageUrl" : "http://yyy", # 离线包下载地址,注:只有开通离线播放权限才会返回该参数
          "offlinePackageMd5" : "xxxxxdddddddddddddddddddddddddddd", # 离线包md5,注:只有开通离线播放权限才会返回该参数
          "downloadUrl" : "http://zzz" # 回放视频下载地址,该下载地址具有时效性,有效时间为2小时
      }
 }

二、分流回放

2.1 分流录制记录查询

  • 描述
获得一场直播的分流录制记录
  • 地址

https://ccapi.csslcloud.net/api/v1/serve/record/stream/query?roomid=myroomid&accountid=myaccounid&liveid=myliveid
  • 方法
GET
  • 请求参数
参数名称 参数类型 参数说明 备注
accountid 字符串 账户ID 必须
roomid 字符串 房间ID 必须
liveid 字符串 直播ID 必须
  • 返回格式
{
  "data": [
    {
      "down_path": "http://12.9.9.16/mkv/902213200.mp4",  # 没用
      "duration": 613.0,     # 视频时长
      "end": "2019-06-13 16:50:47",   # 视频结束时间
      "live_end": "2019-06-13 16:50:44",   # 直播结束时间
      "live_start": "2019-06-13 16:40:34",  # 直播开始时间
      "role": null,   # 角色  老师presenter 学生talker  混流null
      "source_type": 3,   #  0 普通流 1 共享桌面流  3 master合流  master类型合流 视频只包含老师 音频包含所有互动的人 手机端播放专用视频。
      "start": "2019-06-13 16:40:34", #  流开始时间
      "streamid": "5d01c3e945df9d19578e9361-master",  #  流id
      "userid": null,    # 用户id  混流null
      "username": null,   #  用户姓名  混流null
      "video_status": 200,    #  视频状态码  等于200 可以播放  大于200小于299 视频处理中  大于等于400   视频处理失败
      "videoid": "FC7E328BEB1356039C33DC5901307461"  #  视频id
    },
    {
      "down_path": "http://172.19.99.159/mkv/523690844575200.mp4",
      "duration": 1.0,
      "end": "2019-06-13 16:40:47",
      "live_end": "2019-06-13 16:50:44",
      "live_start": "2019-06-13 16:40:34",
      "role": "presenter",
      "source_type": 0,
      "start": "2019-06-13 16:40:46",
      "streamid": "6716799451234700",
      "userid": "h56j1Zt4hx21OOI",
      "username": "1321",
      "video_status": 200,
      "videoid": "237BE7D0B91E30479C33DC1307461"
    },
  ],
  "result": "OK"
}

2.2 回放画笔信息

  • 描述
回放画笔信息
  • 地址
 http://ccapi.csslcloud.net/api/v1/serve/record/draw/info
  • 方法
POST/GET
  • 请求参数
参数名称 参数类型 参数说明 备注
userid 字符串 账户ID 必须
roomid 字符串 房间ID 必须
liveid 字符串 直播ID 必须
  • 返回数据格式
{
    "result": "OK", # 失败:FAIL,成功:OK
    "data": {
       meta": {
                "draw": [{
                   "time": 24,
                   "data": "{"alpha":1,"color":"14890019"}",
                   "docName": "WhiteBorad",
                   "pageNum": -1
                }]
        }
    }
}}

2.3 回放聊天信息

  • 描述
回放聊天信息
  • 地址
 http://ccapi.csslcloud.net/api/v1/serve/record/chatqa/info
  • 方法
POST/GET
  • 请求参数
参数名称 参数类型 参数说明 备注
userid 字符串 账户ID 必须
roomid 字符串 房间ID 必须
liveid 字符串 直播ID 必须
  • 返回数据格式
{
    "result": "OK", # 失败:FAIL,成功:OK
    "data": {
        "meta": {
            "answer": [],
            "question": [],
            "chatLog": [{
                "content": "1你好  ",
                "time": 43,
                "role": 10,
                "userName": "1321",
                "userId": "f727119a92bd4cbabfd65f571bf9dce5",
                "userAvatar": "",
                "userRole": "unknow",
                "userCustomMark": ""
                }, {
                "content": "2321312   ",
                "time": 336,
                "role": 10,
                "userName": "1321",
                "userId": "f727119a92bd4cbabfd65f571bf9dce5",
                "userAvatar": "",
                "userRole": "unknow",
                "userCustomMark": ""
                }]
            }
    }
}

2.4 回放文档翻页信息

  • 描述
回放文档翻页信息
  • 地址
 http://ccapi.csslcloud.net/api/v1/serve/record/doc/info
  • 方法
POST/GET
  • 请求参数
参数名称 参数类型 参数说明 备注
userid 字符串 账户ID 必须
roomid 字符串 房间ID 必须
liveid 字符串 直播ID 必须
  • 返回数据格式
{
    "result": "OK", # 失败:FAIL,成功:OK
    "data": {
        "meta": {
            "animation": [{
                "time": 167,
                "docId": "F6C4128336B740E4",
                "docTotalPage": 0,
                "pageNum": 0,
                "encryptDocId": "F6C4128336B740E4",
                "step": 0
            }, {
            "time": 171,
            "docId": "F6C4128336B740E4",
            "docTotalPage": 0,
            "pageNum": 0,
            "encryptDocId": "F6C4128336B740E4",
            "step": 1
            }]
        }
    }
}

2.5 视频播放链接

  • 描述
根据视频ID(videoid) 获取播放连接。
  • 地址
https://ccapi.csslcloud.net/api/v1/video/playurl?account_id=myaccound_id&video_id=myvideo_id
  • 方法
GET
  • 请求参数
参数名称 参数类型 参数说明 备注
account_id 字符串 账户ID 必须
video_id 字符串 视频ID 必须
  • 返回格式
{
  "data": {
    "app_playurl": "",
    "pc_playurl": ""
  },
  "result": "OK"
}

2.6 查询直播场次

  • 描述
根据账户id/房间id/时间范围查询直播场次记录
  • 地址

https://ccapi.csslcloud.net/api/room/live/query
  • 方法
GET
  • 请求参数
参数名称 参数类型 参数说明 备注
userid 字符串 账户ID 必须
roomid 字符串 房间ID 必须
liveid 字符串 直播ID 可选
status 整数 1(直播中),0(非直播中) 可选
start_time 字符串 开始时间, 和直播开始时间做筛选 可选 例:"2015-01-01"
end_time 字符串 结束时间,和直播结束时间做筛选 可选 例:"2015-01-01"
order 字符串 排序 ASC(升序) DESC(降序) 可选, 默认是降序
page 整数 获取指定页 默认返回第一页(可选)
lines 整数 每页的数据条数 默认每页50(可选)
  • 返回格式
{
  "result": "OK",
  "lives": [
    {
      "room_type": 2, # 房间类型
      "live_id": "EDDCB752CBF6306C", # 直播id
      "userid": "41E8063FC799ACE5", # 账户id
      "live_roomid": "D90DCF5BF6DA3C8C9C33DC5901307461",# 房间id
      "status": 0, # 直播状态 1直播中 0非直播中
      "start_time": "2020-02-26 14:27:58", # 直播开始时间
      "end_time": "2020-02-26 14:37:00" # 直播结束时间
    },
  ],
  "total": 100, # 总数
  "current": 1  # 当前分页
}

results matching ""

    No results matching ""