跳到主要内容

直播素材与上传

控制台客户端配置 · 返回值与共享类型

视频素材先申请上传地址,再调用 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.jsc.liveVideos.list(appId, input)
Pythonc.live_videos.list(app_id, **input)
Javac.liveVideos.list(appId, input)
Goc.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.jsc.liveVideos.createUploadUrl(appId, input)
Pythonc.live_videos.create_upload_url(app_id, **input)
Javac.liveVideos.createUploadUrl(appId, input)
Goc.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.jsc.liveVideos.create(appId, input)
Pythonc.live_videos.create(app_id, **input)
Javac.liveVideos.create(appId, input)
Goc.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.jsc.liveVideos.remove(appId, input)
Pythonc.live_videos.remove(app_id, **input)
Javac.liveVideos.remove(appId, input)
Goc.LiveVideos.Remove(ctx, appID, input, &result)
PHP$c->liveVideos->remove($appId, $input)

输入:LiveVideoIdInput。 字段放在 URL 查询参数中。

字段必填类型说明
liveVideoId是string直播视频素材 ID

返回:DeleteResult。嵌套字段见共享类型。