准备工作

本文档介绍如何在您的应用中使用直播视频 API 来直播视频。如果您还没有应用，可改用图谱 API 探索工具和您选择的直播软件。

前期准备

如果没有应用，需准备以下项目或实现以下要求：

• 将 Facebook 登录用作用例的 Meta 应用编号
• 在您应用中实现了 Facebook 登录

  • 如果应用所在设备没有允许用户登录 Facebook 的界面，请改为实现使用 Facebook 登录设备 。
• 以下权限：publish_video
• 访问口令

如果没有应用，还需做如下准备：

• 图谱 API 探索工具
• 直播视频软件

开始直播

如要创建 LiveVideo 对象，请向 /me/live_videos?status=LIVE_NOW 端点发送 POST 请求，其中 me 是用户或公共主页的编号。

curl -i -X POST \
 "https://graph.facebook.com/v21.0/me/live_videos?status=LIVE_NOW"

这样，系统将返回如下响应内容：

{ 
  "id": "10214937378883406",  //The LiveVideo object ID
  "stream_url": "rtmp://rtmp-api.faceboo...",
  "secure_stream_url": "rtmps://rtmp-api.faceboo...", //The stream URL
  "stream_secondary_urls": [],
  "secure_stream_secondary_urls": []
}

获取系统返回的 id 和 secure_stream_url 值。id 是 LiveVideo 对象编号，可用于处理您的直播。secure_stream_url 是提取网址，可用于将直播视频数据从您的编码器流式传输至 LiveVideo 对象。

流式传输直播

将上一步中获取的 secure_stream_url 值传递至编码设备，并将直播视频数据流式传输至该设备。当 LiveVideo 对象检测到直播数据后，用户个人主页上的直播便会开始。

查看您的个人主页，确认系统已创建新的直播视频帖子，并且正在播放您的直播数据。

如果使用直播软件而非开发自己的应用，则需为您的软件手动添加 secure_stream_url 值。根据使用的直播软件，可能需要将直播网址分解为其服务器 (rtmps://rtmp-api.facebook.com/rtmp/) 和关键组件（/rtmp/ 之后的所有内容）。

结束直播

如要结束直播，请向 /<LIVE_VIDEO_ID>?end_live_video=true 端点发送 POST 请求。

结束直播请求示例

curl -i -X POST \
  "https://graph.facebook.com/v21.0/<LIVE_VIDEO_ID>?end_live_video=true"

此操作将结束您的直播，并将其保存为点播视频 (VOD)。如需删除该 VOD，请向 DELETE /<LIVE_VIDEO_ID> 端点发送请求。

权限遭拒错误代码

后续步骤

• 使用直播视频 API 为直播视频预设未来直播的时间。