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:
Nếu có ứng dụng, bạn sẽ cần:
publish_video
Nếu không có ứng dụng, bạn cũng sẽ cần:
Để 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.
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, hãy gửi yêu cầu POST
đến điểm cuối /<LIVE_VIDEO_ID>?end_live_video=true
.
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>
.
Code | Subcode | Message | Type | Mitigation 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 |