ossAKey / ossSKey),暂不支持 STS 临时凭证。建议使用仅对目标 Bucket 有写权限的专用密钥,不要使用账号主密钥。taskId 幂等更新任务状态。status=99 是成功终态;-1、-2、-3 分别表示转码、上传、回调失败。taskId 为幂等键;成功终态不能被迟到的处理中状态覆盖,重复成功回调也不能重复触发下载、计费或消息等下游动作。回调未到达时,可调用查询任务接口补偿。0/1/2/3/99/-1/-2/-3,未知状态应保留原状态并告警;成功终态 不得回退到处理中状态。-1、-2 视为转码、上传失败终态,-3 仅表示回调投递失败,应查询任务并核对 OSS 对象后再确定业务最终状态。| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
fileName | string | 是 | 目标文件名称 |
recordId | string | 是 | 历史课堂 ID |
recordUrl | string | 否 | 历史课堂播放地址;含预解析课件时必须提供 |
convertMode | number | 否 | 1 仅头像,2 仅白板,3 仅音频,10 白板+大头像,20 头像+白板 |
resolution | string | 否 | 720P 或 1080P |
videoBitrate | number | 否 | 视频码率,500-8000 kbps |
audioBitrate | number | 否 | 音频码率,64-320 kbps |
frameRate | number | 否 | 视频帧率,15-60 fps |
| 字段 | 说明 |
|---|---|
code | 0 成功,其他为失败 |
obj.taskId | 任务 ID |
| 错误码 | 说明 |
|---|---|
0 | 执行成功 |
22001 | 存在进行中的任务 |
22003 | 课堂不存在 |
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
taskId | string | 是 | 任务 ID |
| 值 | 说明 |
|---|---|
0 | 等待 |
1 | 开始执行 |
2 | 开始上传 |
3 | 开始回调 |
99 | 成功 |
-1 | 转码失败 |
-2 | 上传失败 |
-3 | 回调失败 |
| 参数 | 类型 | 说明 |
|---|---|---|
taskId | string | 转视频任务 ID |
status | number | 99 成功,负数为失败 |
location | string | 成功时的视频路径 |
{
"code": 0,
"message": ""
}ossAKey / ossSKey),暂不支持 STS 临时凭证;建议使用仅对目标 Bucket 有写权限的专用密钥,不要使用账号主密钥。| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
ossAKey | string | 是 | OSS AccessKey,需要对目标 Bucket 有写权限;当前不支持 STS |
ossSKey | string | 是 | OSS SecretKey |
bucket | string | 是 | Bucket 名称 |
region | string | 是 | OSS 区域,如 oss-cn-shanghai |
path | string | 是 | 视频保存目录 |
callbackUrl | string | 是 | 转码事件回调 URL |
{
"ossAKey": "xxx",
"ossSKey": "xxx",
"bucket": "xxx",
"region": "oss-cn-shanghai",
"path": "dir",
"callbackUrl": "https://example.com/callback"
}