媒体库相关API
优质
小牛编辑
133浏览
2023-12-01
媒体库相关
一.流程
1.通过调用 申请视频ID接口 获取系统分配的视频ID 2.前端JS拿到视频ID相关参数，执行上传操作 3.将视频关联到房间
二.相关接口
1.申请视频ID
- 地址：
https://ccapi.csslcloud.net/api/v1/video/createuploadinfo
- 备注:
需要THQS加密请求
- 方法：
POST/GET
- 请求参数
| 参数名称 | 参数类型 | 参数说明 | 备注 |
|---|---|---|---|
| account_id | 字符串 | 开发者账号ID | 必须 |
| title | 字符串 | 视频标题 | 必须 |
| filename | 字符串 | 视频文件名 | 必须 |
| filesize | 字符串 | 视频大小 | 可选 |
| categoryid | 字符串 | 视频分类ID | 可选 |
- 返回数据格式:
{
"result": 'OK', # 失败： FAIL，成功：OK
"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
- 备注:
需要THQS加密请求，video_id支持批量操作，以|分隔
- 方法：
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
- 备注:
需要THQS加密请求，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
- 备注:
需要THQS加密请求，video_id支持批量操作，以|分隔
- 方法：
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
- 备注:
需要THQS加密请求
- 方法：
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
- 备注:
需要THQS加密请求
- 方法：
POST/GET
- 请求参数
| 参数名称 | 参数类型 | 参数说明 | 备注 |
|---|---|---|---|
| account_id | 字符串 | 开发者账号ID | 必须 |
| room_id | 字符串 | 房间ID | 必须 |
| video_id | 字符串 | 视频ID | 必须 |
- 返回数据格式:
{
result: 'OK', # 失败： FAIL，成功：OK
}
8.查询某房间下已关联的媒体
- 地址：
https://ccapi.csslcloud.net/api/v1/video/onrelated
- 备注:
需要THQS加密请求，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音频)
}
……
]
}
}}