Bắt đầu

Tài liệu này giải thích cách sử dụng API Video trực tiếp để phát video phát trực tiếp bằng ứng dụng của bạn. Nếu chưa có ứng dụng, bạn có thể dùng Trình khám phá API Đồ thị và phần mềm phát trực tiếp mà mình chọn.

Vào ngày 10/06/2024, Meta sẽ đưa ra các yêu cầu mới mà tài khoản phải đáp ứng thì mới có thể phát trực tiếp trên Facebook. Yêu cầu mới như sau:

Trước khi bạn bắt đầu

Nếu có ứng dụng, bạn sẽ cần:

Nếu không có ứng dụng, bạn cũng sẽ cần:

Bắt đầu nội dung phát

Để tạo đối tượng LiveVideo, hãy gửi yêu cầu POST đến điểm cuối /me/live_videos?status=LIVE_NOW, trong đó me là ID dành cho Người dùng hoặc Trang.

Khi thử nghiệm một lệnh gọi API, bạn có thể thêm thông số access_token và đặt thông số này là mã truy cập của mình. Tuy nhiên, khi thực hiện lệnh gọi bảo mật từ ứng dụng của bạn, hãy sử dụng lớp mã truy cập.

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

Thao tác này sẽ trả về phản hồi có dạng như sau:

{ 
  "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": []
}

Hãy chụp id và các giá trị secure_stream_url mà bạn nhận được. id là ID của đối tượng LiveVideo mà bạn có thể dùng để điều chỉnh nội dung phát của mình. secure_stream_url là URL thu thập dữ liệu mà bạn sẽ dùng để truyền dữ liệu video trực tiếp từ bộ mã hóa sang đối tượng LiveVideo.

Phát trực tiếp nội dung phát

Hãy chuyển giá trị secure_stream_url mà bạn đã chụp ở bước trước cho thiết bị mã hóa rồi truyền dữ liệu video trực tiếp sang thiết bị đó. Sau khi đối tượng LiveVideo phát hiện thấy dữ liệu phát trực tiếp, nội dung phát sẽ phát trực tiếp trên trang cá nhân Người dùng của bạn.

Sau đó, hãy xem trang cá nhân của bạn và xác minh rằng bài viết mới có video trực tiếp đã được tạo và đang phát trực tiếp dữ liệu bạn truyền.

Nếu bạn đang dùng phần mềm phát trực tiếp thay vì phát triển ứng dụng của riêng mình, hãy thêm giá trị secure_stream_url vào phần mềm đó theo cách thủ công. Tùy vào phần mềm phát trực tiếp mà bạn đang sử dụng, bạn có thể phải chia URL luồng thành thành phần máy chủ (rtmps://rtmp-api.facebook.com/rtmp/) và thành phần chính (mọi nội dung sau /rtmp/).

Kết thúc nội dung phát

Để kết thúc nội dung phát, hãy gửi yêu cầu POST đến điểm cuối /<LIVE_VIDEO_ID>?end_live_video=true.

Ví dụ về yêu cầu kết thúc nội dung phát

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

Thao tác này sẽ kết thúc và lưu nội dung phát của bạn dưới dạng video theo yêu cầu (VOD). Nếu bạn muốn xóa VOD này, hãy gửi yêu cầu đến điểm cuối DELETE /<LIVE_VIDEO_ID>.

Mã lỗi quyền bị từ chối

CodeSubcodeMessageTypeMitigation messaging

200

1363120

Permissions error

OAuthException

You’re not eligible to go live

Your profile needs to be at least 60 days old before you can go live on Facebook. Learn more at https://www.facebook.com/business/help/167417030499767?id=1123223941353904

200

1363144

Permissions error

OAuthException

You’re not eligible to go live

You need at least 100 followers before you can go live from your profile. Learn more at https://www.facebook.com/business/help/167417030499767?id=1123223941353904

Bước tiếp theo