媒体库相关

日期: 2021-03-02

创盛视联数码科技(北京)有限公司

[TOC]

一.流程

1.通过调用 申请视频ID接口 获取系统分配的视频ID 2.前端JS拿到视频ID相关参数,执行上传操作 3.将视频关联到房间

二.相关接口

1.申请视频ID

地址:

https://ccapi.csslcloud.net/api/v1/video/createuploadinfo

方法:

POST/GET

请求参数:

参数名称 参数类型 参数说明 备注
account_id 字符串 开发者账号ID 必须
title 字符串 视频标题 必须
filename 字符串 视频文件名 必须
filesize 字符串 视频大小 可选
categoryid 字符串 视频分类ID 可选

返回示例:

{
  "success": "true", # 失败: false,成功:true
  "videoUploadInfo": {
    "videoid": "F7B8DA319DE99681FC9558351D509E7C", # 系统分配的视频id
    "userid": "1725A8A9604EAE30", # 用户ID
    "servicetype": "DF0236B91AECD81C", # 服务类型
    "metaurl": "http://1-15-vacombiner.bokecc.com/servlet/uploadmeta/v2",  # 系统分配的文件状态及断点位置查询接口
    "chunkurl": "http://1-15-vacombiner.bokecc.com/servlet/uploadchunk/v2" # 系统分配的上传文件内容块的接口
  }
}

2.上传视频

由前端js封装实际上传操作

3.关联视频

地址:

https://ccapi.csslcloud.net/api/v1/video/relate

方法:

POST/GET

请求参数:

参数名称 参数类型 参数说明 备注
account_id 字符串 开发者账号ID 必须
room_id 字符串 房间ID 必须
video_id 字符串 视频ID 必须
media_type 整型 媒体类型 可选 1:视频 2:音频, 默认为视频

返回示例:

{
"result": "OK", # 失败: FAIL,成功:OK
}

4.取消关联视频

地址:

https://ccapi.csslcloud.net/api/v1/video/unrelate

备注:

video_id支持批量操作,以|分隔

方法:

POST/GET

请求参数:

参数名称 参数类型 参数说明 备注
account_id 字符串 开发者账号ID 必须
room_id 字符串 房间ID 必须
video_id 字符串 视频ID 必须

返回示例:

{
    "result": "OK", # 失败: FAIL,成功:OK
}

5.标记删除关联视频

地址:

https://ccapi.csslcloud.net/api/v1/video/delete

方法:

POST/GET

请求参数:

参数名称 参数类型 参数说明 备注
account_id 字符串 开发者账号ID 必须
room_id 字符串 房间ID 必须
video_id 字符串 视频ID 必须

返回示例:

{
    "result": "OK", # 失败: FAIL,成功:OK
}

6.设为暖场视频

地址:

https://ccapi.csslcloud.net/api/v1/video/warm/set

方法:

POST/GET

请求参数:

参数名称 参数类型 参数说明 备注
account_id 字符串 开发者账号ID 必须
room_id 字符串 房间ID 必须
video_id 字符串 视频ID 必须

返回示例:

{
    "result": "OK", # 失败: FAIL,成功:OK
}

7.取消设为暖场视频

地址:

https://ccapi.csslcloud.net/api/v1/video/warm/unset

方法:

POST/GET

请求参数:

参数名称 参数类型 参数说明 备注
account_id 字符串 开发者账号ID 必须
room_id 字符串 房间ID 必须
video_id 字符串 视频ID 必须

返回示例:

{
    "result": "OK", # 失败: FAIL,成功:OK
}

8.查询某房间下已关联的媒体

地址:

https://ccapi.csslcloud.net/api/v1/video/onrelated

备注:

video_id支持批量操作,以|分隔

方法:

POST/GET

请求参数:

参数名称 参数类型 参数说明 备注
account_id 字符串 开发者账号ID 必须
room_id 字符串 房间ID 必须
video_id 字符串 视频ID 可选
page 整型 获取指定页 可选 默认为1
lines 整型 分页每页数据量 可选 默认为50
sort 整型 排序方式 'CREATION_DATE:ASC': 日期升序,'CREATION_DATE:DESC': 日期降序,'FILE_SIZE:ASC': 大小升序, 'FILE_SIZE:DESC':大小降序,'VIDEO_TITLE:ASC': 标题升序,'VIDEO_TITLE:DESC': 标题降序 可选 默认日期升序
status 字符串 视频状态,支持多选,以,分割 正常:0 处理中:2或者10 标记删除:6 转码失败:7 彻底删除:11 可选
isvaild 整型 审核状态 1:已审核 0:未审核 可选
categoryid 字符串 视频分类ID 可选
start_time 日期 date 创建时间 可选
end_time 日期 date 结束时间 可选
onlydata 整型 1:只查记录数据 可选
onlycount 整型 1:只查视频总数 可选
isactive 整型 只查询可用的视频(排除 标记删除/转码失败/删除), 1:是 0:否 可选

返回示例:


{
  "result": 'OK', # 失败: FAIL,成功:OK
  "videos": {
    "total": 3, # 视频总数
    "video": [
      {
        "id": "A4DE83629B02A0617E6C9CEE8B422289", # 视频ID
        "userid": "1725A8A9604EAE30", # 账号ID
        "title": "测试视频",  # 视频标题
        "desp": "这是第二条测试用的信息", # 视频描述
        "tags": " ",  # 视频标签
        "duration": 30, # 视频时长(s)
        "status": 0, # 视频状态 0:正常 处理中:2或者10 标记删除:6 转码失败:7 彻底删除:11
        "isvalid": 0, # 是否已经审核(0未审核,1已审核)
        "filesize": 489848, # 视频大小
        "type": 80, # 视频类型(清晰度大小)
        "creation-time": "2017-11-14 19:18:58", # 创建时间
        "uploaduserid": "1725A8A9604EAE30", #  上传用户ID
        "category": "8395FBC2E22C76D2", # 视频分类ID
        "hasvideofile": 0, # 视频文件是否存在(0存在,1删除)
        "playurl": "", # 播放地址
        "mediaType": 2 # 视频类型是否是音频(1视频,2音频)
      }

    ]
  }
}}

results matching ""

    No results matching ""