直播素材与上传
视频素材先申请上传地址,再调用 uploadFile 直传文件,最后调用 create 保存 objectKey 和素材信息。视频上传的 contentType 默认为 video/mp4。list 的视频数组字段为 videos。
创建文件直播课堂时,将素材的 liveVideoId 与 liveSourceKind=file 传入课堂创建参数。classrooms.setLiveSource 使用字段 kind。推流模式通过 classrooms.issueLivePushCredential 获取推流地址和有效期。
应用后端使用应用业务接口和应用凭证。本页描述独立的租户管理调用。
liveVideos.list
直播素材列表。
GET /v1/live-videos
鉴权:租户 Bearer Token 与 x-app-id。
| 语言 | 调用 |
|---|---|
| Node.js | c.liveVideos.list(appId, input) |
| Python | c.live_videos.list(app_id, **input) |
| Java | c.liveVideos.list(appId, input) |
| Go | c.LiveVideos.List(ctx, appID, input, &result) |
| PHP | $c->liveVideos->list($appId, $input) |
输入:PaginationInput。 字段放在 URL 查询参数中。
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
page | 否 | number | undefined | 页码,从 1 开始 |
pageSize | 否 | number | undefined | 单页数量 |
返回:ListLiveVideosResult。嵌套字段见共享类型。
liveVideos.createUploadUrl
直播视频上传地址。
POST /v1/live-videos/upload-url
鉴权:租户 Bearer Token 与 x-app-id。
| 语言 | 调用 |
|---|---|
| Node.js | c.liveVideos.createUploadUrl(appId, input) |
| Python | c.live_videos.create_upload_url(app_id, **input) |
| Java | c.liveVideos.createUploadUrl(appId, input) |
| Go | c.LiveVideos.CreateUploadUrl(ctx, appID, input, &result) |
| PHP | $c->liveVideos->createUploadUrl($appId, $input) |
输入:LiveVideoUploadInput。 字段放在 JSON Body 中。
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
fileName | 是 | string | 文件名,含扩展名 |
contentType | 否 | string | undefined | 文件 MIME 类型 |
返回:LiveVideoUploadResult。嵌套字段见共享类型。
liveVideos.create
创建直播素材。
POST /v1/live-videos
鉴权:租户 Bearer Token 与 x-app-id。
| 语言 | 调用 |
|---|---|
| Node.js | c.liveVideos.create(appId, input) |
| Python | c.live_videos.create(app_id, **input) |
| Java | c.liveVideos.create(appId, input) |
| Go | c.LiveVideos.Create(ctx, appID, input, &result) |
| PHP | $c->liveVideos->create($appId, $input) |
输入:CreateLiveVideoInput。 字段放在 JSON Body 中。
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
title | 是 | string | 视频素材标题 |
objectKey | 是 | string | 上传接口返回的对象键 |
contentHash | 否 | string | undefined | 文件内容 SHA-256,小写十六进制;课件要求 64 字符 |
sizeBytes | 否 | number | undefined | 文件字节数 |
返回:LiveVideoRecord。嵌套字段见共享类型。
liveVideos.remove
删除直播素材。
DELETE /v1/live-videos/remove
鉴权:租户 Bearer Token 与 x-app-id。
| 语言 | 调用 |
|---|---|
| Node.js | c.liveVideos.remove(appId, input) |
| Python | c.live_videos.remove(app_id, **input) |
| Java | c.liveVideos.remove(appId, input) |
| Go | c.LiveVideos.Remove(ctx, appID, input, &result) |
| PHP | $c->liveVideos->remove($appId, $input) |
输入:LiveVideoIdInput。 字段放在 URL 查询参数中。
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
liveVideoId | 是 | string | 直播视频素材 ID |
返回:DeleteResult。嵌套字段见共享类型。