直播视频 API

返回中文(简体)

文档已更新。
中文(简体) 译文尚未完成。

英语更新时间：2022年1月8日

参考文档

推荐设置

为确保成功开展直播，直播视频必须：

同时包含音频和视频数据
不超过 8 小时
利用下方指定的推荐设置（例如，必为 H264/AAC）
不要在直播中更改设置

如果不能满足这些限制条件，可能会导致：

直播意外终止
向观众呈现的直播质量较差
意外行为

视频设置

关键帧时长 — 推荐设置为 2 秒。不得超过 4 秒。
分辨率和比特率 —
1080p @ 60 FPS
分辨率：1920x1080
视频比特率范围：4,500-9,000 Kbps
1080p @ 30 FPS
分辨率：1920x1080
视频比特率范围：3,000-6,000 Kbps
720p @ 60 FPS
分辨率：1280x720
视频比特率范围：2,250-6,000 Kbps
720p @ 30 FPS
分辨率：1280x720
视频比特率范围：1,500-4,000 Kbps
480p @ 30 FPS
分辨率：854x480
视频比特率范围：600-2,000 Kbps
360p
分辨率：640x360
视频比特率范围：400-1,000 Kbps
协议 — RTMPS 流式传输协议
像素宽高比 — 理想比为 16:9；若与该比率差距过大，则可能无法支持直播
视频编解码器 —
- H.264，Level 4.1，最高可支持 1080p 30 FPS
- H.264，Level 4.2，最高可支持 1080p 60 FPS

音频设置

音频编解码器 — AAC 低复杂度规格
取样率 — 44.1kHz 或 48kHz
音频比特率 — 128 kbps（首选）至 256 kbps（不得超过）
声道布局 — 立体声

端点

LiveVideo

端点	说明
`DELETE /{live_video_id}`	删除 LiveVideo。
`GET /{event-id}/live_videos`	获取活动中的 LiveVideo 集合。
`GET /{group-id}/live_videos`	获取小组中的 LiveVideo 集合。
`GET /{live-video-id}`	获取 LiveVideo 的字段和连线。
`GET /{live-video-id}/comments`	获取 LiveVideo 中的评论集合。
`GET /{live-video-id}/crosspost_shared_pages`	获取可以分享 LiveVideo 的公共主页集合。
`GET /{live-video-id}/likes`	获取为 LiveVideo 点赞的个人主页集合。
`GET /{live-video-id}/polls`	获取 LiveVideo 中的 VideoPoll 集合。
`GET /{live-video-id}/reactions`	获取为 LiveVideo 留下心情的个人主页集合。
`GET /{page-id}/live_videos`	获取公共主页中的 LiveVideo 集合。
`GET /{user-id}/live_videos`	获取用户的 LiveVideo 集合。
`POST /{event-id}/live_videos`	在活动中创建 LiveVideo。
`POST /{group-id}/live_videos`	在群组中创建 LiveVideo。
`POST /{live_video_id}`	更新 LiveVideo 的字段。
`POST /{live_video_id}/input_streams`	在 LiveVideo 中创建 LiveVideoInputStream。
`POST /{live_video_id}/polls`	在 LiveVideo 中创建 VideoPoll。
`POST /{page-id}/live_videos`	在公共主页中创建 LiveVideo。
`POST /{user-id}/live_videos`	针对用户创建 LiveVideo。

LiveVideoInputStream

端点	说明
`GET /{live-video-input-stream-id}`	获取 LiveVideoInputStream 的字段和连线。
`POST /{live_video_id}/input_streams`	在 LiveVideo 中创建 LiveVideoInputStream。

投票

端点	说明
`GET /{live-video-id}/polls`	获取 LiveVideo 中的 VideoPoll 集合。
`GET /{video-poll-id}`	获取 VideoPoll 的字段和连线。
`POST /{live_video_id}/polls`	在 LiveVideo 中创建 VideoPoll。
`POST /{video_poll_id}`	更新 VideoPoll 的字段。

错误代码

系统会通过 RTMP 发送错误信息，并将之继续发送至图谱 API。您可以通过 GET 请求，在图谱浏览工具中使用直播/视频编号查询错误。返回的错误将包含错误代码、描述和时间戳。

error_subcode	错误摘要	说明
`COPYRIGHT__LIVE_COPYRIGHT_VIOLATION`	违反直播版权	由于您的视频直播可能包含属于其他公共主页的音频或影视作品内容，因此已将其停止。
`VIDEO__CREATE_FAILED`	上传问题	由于存在问题，因此未上传您的视频。请重试。
`LIVE_VIDEO__DELETE_FAILED`	未删除直播视频	由于存在问题，因此我们未能删除您的直播视频。请重试。
`LIVE_VIDEO__EDIT_API_NOT_ALLOWED`	不得在直播时通过视频 API 进行编辑	不得使用视频编辑 API 编辑直播视频。使用直播视频编号。
`LIVE_VIDEO__LIVE_STREAM_ERROR`	一般直播	直播期间出现问题
`LIVE_VIDEO__NOT_EXIST`	直播视频不存在	您尝试访问的直播视频已不再存在于系统中。
`LIVE_VIDEO__PRIVACY_REQUIRED`	必需设置隐私	您需在开始直播前设置隐私。