概览

在图谱 API 中，直播视频由 LiveVideo 对象表示。如要进行视频直播，您首先需使用 API 在用户、公共主页、小组或活动页面上创建 LiveVideo 对象。创建完成后，API 将返回 LiveVideo 对象编号和提取直播网址。然后，您可以使用该直播网址将直播视频数据从编码器流式传输至 LiveVideo 对象，并使用该对象操控直播的可见性。

组件

直播

LiveVideo 直播由 LiveVideo 对象表示。您可以操控 LiveVideo 对象的属性，从而控制视频直播。例如，您可以更改视频直播的可见性、更新其描述或标题、添加标签、定义受众、添加投票活动或执行许多其他操作。

LiveVideo 对象与 LiveVideoInputStream 对象相关，后者表示直播的提取直播数据。LiveVideoInputStream 对象由系统自动为您创建和管理。

您可以使用用户、公共主页、小组或活动对象的 /live_videos 连线，为这些对象创建直播。

直播网址

直播网址是提取网址，可用于将直播视频数据从编码器流式传输至 LiveVideo 对象。当您使用 API 创建 LiveVideo 对象时，API 的响应将包含 LiveVideo 对象编号和唯一的直播网址。该直播网址将在 24 小时后过期。一经使用，直播网址将持续直播长达 8 小时。

提取协议

直播视频 API 支持 RTMPS 协议。

RTMPS

若是流式传输至提取直播网址的数据，您必须使用 RTMPS 数据传输协议对其进行加密。当您创建 LiveVideo 对象时，API 将返回 RTMPS 安全直播网址，以便您在流式传输至我们的服务器时使用。

以下是支持 RTMPS 的软件和硬件提供方示例：

投票

您可以使用 API 为视频直播创建投票活动，以获得观众的实时反应。在图谱 API 中，投票活动由 VideoPoll 对象表示，并可由 POST /{live-video-id}/polls 端点基于 LiveVideo 对象创建。创建完成后，API 将返回 VideoPoll 对象编号，以便您用来操控投票活动和查询观众互动情况。

工具

直播视频编辑器

如果您使用的直播软件没有与直播视频 API 集成，则可使用我们的直播视频编辑器工具获取直播网址，并将其手动插入您喜欢的直播软件（例如 OBS、XSplit 等）。借助直播视频编辑器，您可以在自己的用户个人主页，或者您管理的公共主页、小组或活动上创建直播。

直播提取

视频直播的质量取决于与我们服务器的连接是否可靠。网络连接不良可能会造成视频质量欠佳、播放中断和直播失败。借助直播提取工具，您可以测试直播提取质量，从而诊断连接问题、确定直播的最佳视频提取服务器，并提供播放问题较少的优质直播。

视频要求

请参阅我们的参考文档，以查看音频和视频要求的完整列表。