Hướng dẫn livestream trên Facebook nâng cao

Thông số khuyến nghị

Điều quan trọng là cần lưu ý các thông số sau cho API và sản phẩm phát video trực tiếp của Facebook. Tài liệu này sẽ được cập nhật tích cực để phản ánh sự phát triển của sản phẩm.

Tạo video đang phát

Sau khi có quyền truy cập vào API Live qua Xét duyệt ứng dụng và thiết lập các quyền thích hợp, đối tượng video trực tiếp có thể được tạo từ một người dùng, trang, nhóm hoặc sự kiện. Hãy gửi yêu cầu POST đến các điểm cuối sau để tạo video trực tiếp.

• /{user_id}/live_videos
• /{page_id}/live_videos
• /{event_id}/live_videos

Vui lòng tham khảo phần Tạo video trực tiếp của hướng dẫn Bắt đầu nhanh để biết thêm thông tin về cách tạo đối tượng video trực tiếp.

Xem trước video đang phát

Facebook Live API cho phép người phát xem trước nội dung trực tiếp của mình trước khi Phát trực tiếp.

Đầu tiên, đưa ra yêu cầu POST để tạo video trực tiếp với thông số status được đặt thành UNPUBLISHED. Đối tượng video trực tiếp sẽ được tạo nhưng không đăng lên trang hoặc dòng thời gian của bạn trên Facebook.

Sử dụng Trình khám phá API Đồ thị:

Hoặc sử dụng curl:

curl -k -X POST https://graph.facebook.com/$your_userid_or_pageid/live_videos 
-F "access_token=$your_user_or_page_token" 
-F "status=UNPUBLISHED"

Máy chủ sẽ trả về phản hồi sau:

{
"id":"10159725222100347",
"stream_url":"rtmp://rtmp-api-dev.facebook.com:80/rtmp/10159725222100347?ds=1&s_efg=eyJxZV9ncm91cHMiOnsiZmJsaXZlX3NlcnZlcl9leHBlcmltZW50Ijp7InNlcnZpY2VfcG9ydCI6IjE3MDAwIn19fQ\u00253D\u00253D&s_l=1&s_vt=dev&a=ATgBKpITJwJNJLhMBpo",
"secure_stream_url":"rtmps://rtmp-api-dev.facebook.com:443/rtmp/10159725222100347?ds=1&s_efg=eyJxZV9ncm91cHMiOnsiZmJsaXZlX3NlcnZlcl9leHBlcmltZW50Ijp7InNlcnZpY2VfcG9ydCI6IjE3MDAwIn19fQ\u00253D\u00253D&s_l=1&s_vt=dev&a=ATgBKpITJwJNJLhMBpo",
"stream_secondary_urls":[],
"secure_stream_secondary_urls":[]
}

Sau khi tạo video trực tiếp để xem trước, bạn có thể truy vấn nút video trực tiếp cho dash_preview_url. Url này có thể được dùng trong trình phát DASH của bên thứ ba để xác minh nội dung video và âm thanh của người phát. Các ví dụ về trình phát DASH của bên thứ ba bao gồm trình phát tham chiếu DASH hoặc trình phát Shaka.

Sử dụng Trình khám phá API Đồ thị:

Hoặc sử dụng curl:

curl -k -X POST https://graph.facebook.com/$video_id 
-F "access_token=$access_token" 
-F "fields=dash_preview_url"

trong đó $live_video_id là trường id từ truy vấn POST tới me/live_videos để tạo nội dung phát.

Yêu cầu curl ở trên sẽ trả về phản hồi máy chủ sau:

{
"dash_preview_url":"https://video.xx.fbcdn.net/hvideo-prn1/v/rBeBxrcPzotQcbdREgZ2b/live-dash/dash-md/10159725222100347.mpd?lvp=1&_nc_log=1&_nc_rl=AfAuSO1ApY1JC5ff&oh=6e33dc60dcd618afbda9e5675ba89d25&oe=59B25609",
"id":"10159725222100347"
}

Sau khi lấy URL xem trước, hãy truy cập trình phát DASH thử nghiệm để xem trước.

Sau khi điền giá trị đúng vào cài đặt trình phát, bạn sẽ nhìn thấy video đang phát như sau:

Sau khi bạn xác minh video/âm thanh, hãy tạo yêu cầu POST khác đến API Đồ thị và thay đổi thông số status thành LIVE_NOW để đăng video trực tiếp của bạn lên Facebook.

curl -k -X POST https://graph.facebook.com/$your_live_video_id 
-F "access_token=$your_user_or_page_token" 
-F "status=LIVE_NOW"

Thử nghiệm video đang phát bổ sung

Mặc dù xem trước video phát trực tiếp là một trong những cách tốt nhất để thử nghiệm thiết lập âm thanh/video trước khi phát trực tiếp, có rất nhiều phương pháp khác mà bạn có thể sử dụng để thử nghiệm độ ổn định của video phát trực tiếp.

Chúng tôi khuyên bạn nên thiết lập một trang thử nghiệm không đăng và phát nội dung video trực tiếp lên đó. Bạn phải là quản trị viên hoặc biên tập viên của trang để tạo nội dung video trực tiếp. Ngoài ra, bạn có thể đặt thông số quyền riêng tư để tạo video đang phát hiển thị với mình. Các giá trị sau khả dụng khi thiết lập quyền riêng tư:

• EVERYONE
• ALL_FRIENDS
• FRIENDS_OF_FRIENDS
• CUSTOM
• SELF

POST /{page_id}/live_videos?privacy={"value":"SELF"}

Cập nhật video phát trực tiếp

Bạn có thể cập nhật các thuộc tính của video trực tiếp bằng cách tạo yêu cầu POST. Điều này bao gồm một số thuộc tính có thể đã được đặt khi tạo như description.

Xóa video phát trực tiếp

Bạn có thể xóa video trực tiếp bằng cách tạo yêu cầu DELETE. Hành động này sẽ xóa toàn bộ đối tượng live_video, bao gồm video đã quay theo yêu cầu và liên kết với tin.

Lên lịch cho video trực tiếp

Giờ đây, người phát có thể lên lịch trước cho video trực tiếp thông qua API Đồ thị, đưa ra tùy chọn để mọi người chọn nhận thông báo, Nhận lời nhắc, khi phiên phát trực tiếp bắt đầu. Điều này cho phép đối tượng chọn nhận thông báo nhắc nhở khi phiên phát trực tiếp bắt đầu nhằm đảm bảo rằng họ sẽ không bỏ lỡ giây nào của phiên phát trực tiếp! Video trực tiếp đã lên lịch sẽ giúp người phát:

• Tạo sự mong đợi và cảm giác phấn chấn trước khi phát
• Bắt đầu phát nhiệt tình mà không có thời gian chết
• Thử nghiệm nội dung được lập trình định kỳ

Bạn có thể đọc thêm về phát theo lịch thông qua bài viết trên blog phương tiện của chúng tôi và luồng công việc chi tiết:

• Lên lịch phát trực tiếp bằng Công cụ dành cho nhà phát hành của Trang
• Hướng dẫn lên lịch cho video trực tiếp

Phiên trực tiếp theo lịch giới thiệu một vài trường mới cho API Live hiện tại. Trước khi đọc hướng dẫn này, hãy đảm bảo bạn quen thuộc với thông tin cơ bản về làm việc với API Live.

Tạo phiên trực tiếp theo lịch

Bạn có thể tạo video trực tiếp đã lên lịch bằng cách tạo yêu cầu POST đến cạnh live_videos bằng các đường dẫn sau:

• /{user_id}/live_videos
• /{page_id}/live_videos
• /{group_id}/live_videos
• /{event_id}/live_videos

với dữ liệu bài viết bắt buộc planned_start_time và dữ liệu bài viết tùy chọn scheduled_custom_profile_image.

curl -X POST 
-F "access_token={access_token}"
-F "planned_start_time={unix_timestamp}" 
-F "schedule_custom_profile_image=@//Users/name/image.png" 
https://graph.facebook.com/v2.8/me/live_videos

Hãy nhớ lưu id và stream_url được trả về khi tạo. Trường id sẽ cho phép bạn đọc, cập nhật và xóa trên nút video live_video. stream_url sẽ được đưa vào bộ mã hóa mà bạn chọn và sử dụng cho video phát trực tiếp vào planned_start_time.

Đọc video trực tiếp đã lên lịch

Đưa ra yêu cầu GET để lấy thông tin về video trực tiếp đã lên lịch.

curl https://graph.facebook.com/v2.8/{live_video_id}?access_token={access_token}&fields=planned_start_time,status,is_manual_mode,stream_url

Nếu bạn đã lên lịch video trực tiếp vài ngày trước và quên khóa luồng, bạn có thể chỉ định stream_url làm một trường.

Cập nhật video trực tiếp đã lên lịch

Bạn có thể cập nhật các thuộc tính của video trực tiếp đã lên lịch bằng cách tạo yêu cầu POST đến API Live. Bạn có thể thay đổi hình ảnh tùy chỉnh, lên lịch lại thời gian mới, chuyển sang chế độ thủ công hoặc chuyển tiếp luồng xem trước sang trực tiếp theo cách thủ công.

Đây là ví dụ về cách cập nhật thông tin lên lịch lại của video trực tiếp thành thời gian mới và thay đổi ảnh đại diện tùy chỉnh. Bạn có thể muốn lên lịch lại khi không thể bắt đầu trong vòng 10 phút kể từ thời gian bắt đầu theo kế hoạch để ngăn phiên trực tiếp theo lịch hết hạn và bị xóa khỏi dòng thời gian của mình.

Gửi yêu cầu POST với planned_start_time={new_unix_timestamp} và schedule_custom_profile_image={path_to_new_image}.

curl -X POST 
-F access_token={access_token} 
-F planned_start_time={new_unix_timestamp} 
-F "schedule_custom_profile_image=@//Users/name/new_image.png"
https://graph.facebook.com/v2.8/{live_video_id}

Đây là một ví dụ khác về cập nhật hướng dẫn bạn cách chuyển phiên trực tiếp theo lịch để sử dụng chế độ thủ công và chuyển tiếp luồng xem trước sang luồng trực tiếp.

Kích hoạt chế độ thủ công bằng cách gửi POST với is_manual_mode=true.

curl -X POST 
-F access_token={access_token} 
-F is_manual_mode=true 
https://graph.facebook.com/v2.8/{live_video_id}

Đầu tiên, hãy xác minh xem luồng xem trước có hoạt động không. Khi bạn đã sẵn sàng chuyển tiếp luồng xem trước sang luồng trực tiếp, hãy gửi POST với status=scheduled_live.

curl -X POST 
-F access_token={access_token} 
-F status=scheduled_live 
https://graph.facebook.com/v2.8/{live_video_id}

Xóa video trực tiếp đã lên lịch

Bạn có thể xóa video trực tiếp đã lên lịch bằng cách tạo yêu cầu DELETE tương tự như khi bạn xóa một video trực tiếp thông thường. Chúng tôi sẽ thông báo cho người dùng hiện đang xem bài viết thông báo rằng phiên trực tiếp theo lịch đã bị hủy.

curl -X DELETE 
-F access_token={access_token} 
https://graph.facebook.com/v2.8/{live_video_id}

Xác định đối tượng

Hạn chế đối tượng hiện đã khả dụng cho API Live nên người đăng có thể giới hạn người xem nội dung theo vị trí và thông tin nhân khẩu học. Bạn có thể giới hạn người xem nội dung trực tiếp của mình theo vị trí (quốc gia, khu vực, thành phố, mã zip), ngôn ngữ, độ tuổi và giới tính. Những quy tắc nhắm mục tiêu này sẽ áp dụng cho cả VOD và Trực tiếp. Có chung mã nghĩa là sau khi thêm quy tắc kiểm soát truy cập theo vị trí địa lý (chẳng hạn như IP_COUNTRY), VOD và Trực tiếp sẽ được nâng cấp đồng thời.

Vui lòng xem lại thông số nhắm mục tiêu có trong API Tiếp thị để hiểu rõ hơn cách nhắm mục tiêu địa lý đối tượng của video trực tiếp.

Xử lý bản quyền

Công cụ Rights Manager giúp bạn dễ dàng tải lên và duy trì thư viện tham khảo về nội dung video để giám sát và bảo vệ, bao gồm các luồng video trực tiếp. API Quản lý quyền của chúng tôi cho phép các nhà phát hành xác nhận quyền sở hữu bản quyền đối với videos và quản lý quy tắc khớp bản quyền. Bạn có thể đọc và tìm hiểu thêm về Rights Manager tại rightsmanager.fb.com.

Ngoài ra, video trực tiếp của bạn có thể bị dừng nếu bị phát hiện vi phạm bản quyền. Bạn có thể ngăn điều này bằng cách đảm bảo làm rõ mọi quyền cho nội dung sẽ được sử dụng trong video phát trực tiếp. Bên cấp phép cũng phải đưa trang của họ vào danh sách cho phép. Công nghệ quản lý nội dung có sẵn sẽ có khả năng gắn cờ, chặn và xóa nội dung không được làm rõ (chẳng hạn như video có chứa nhạc nền chưa được cấp phép). Trong trường hợp này, chúng tôi cung cấp cho bạn một cách để kiểm tra điều kiện lỗi của video đang phát.

Nội dung có thương hiệu

Trang đã xác minh (trang có dấu kiểm màu lam) hiện có thể chia sẻ nội dung có thương hiệu thông qua video trực tiếp! Nội dung có thương hiệu là bất kỳ nội dung nào hiển thị sản phẩm, thương hiệu hoặc nhà tài trợ bên thứ ba (“nhà tiếp thị”). Để biết thông tin về cách tích hợp nội dung có thương hiệu với video trực tiếp, vui lòng xem tài liệu của chúng tôi về cách tạo nội dung có thương hiệu để phát trực tiếp. Hãy đảm bảo bạn quen thuộc với chính sách nội dung có thương hiệu và chính sách quảng cáo của chúng tôi trước khi bắt đầu.

Tìm hiểu thêm về Nội dung có thương hiệu trong cổng phương tiện của chúng tôi.

Thúc đẩy tương tác

Ngay khi video trực tiếp bắt đầu phát, người theo dõi Trang cá nhân và Trang sẽ nhận được thông báo cho biết rằng trang cá nhân hoặc trang họ đang theo dõi đã phát trực tiếp. Hiện tại, API Live không cung cấp quyền kiểm soát đối với việc gửi thông báo cho người theo dõi cụ thể. Tuy nhiên, dưới đây là một số mẹo để cải thiện việc tiếp cận:

1. Khuyến khích người dùng Thích hoặc Theo dõi trang của bạn
2. Thông báo cho người theo dõi biết để Đăng ký video trực tiếp. Những người đăng ký nhận thông báo về phát trực tiếp từ một trang sẽ nhận được thông báo khi trang đó phát trực tiếp.
3. Chia sẻ video trực tiếp trên các trang liên quan khác. Ví dụ: nếu bạn đang phát trực tiếp cuộc phỏng vấn giữa 2 nhân vật của công chúng, hãy chia sẻ video từ một trang với trang khác để thu hút người theo dõi của trang thứ hai.

Người theo dõi có thể đi tới cài đặt thông báo của họ và chuyển giữa các tùy chọn sau:

• Bài viết trực tiếp mới – Họ sẽ nhận được tất cả thông báo về video trực tiếp
• Đề xuất – Thông báo về video trực tiếp được đề xuất cho trang này. Những thông báo này dựa trên việc người theo dõi đã tương tác với nội dung trên Trang này, cụ thể là video trực tiếp, trước đây hay chưa. Mọi người theo dõi trang đều được đặt mặc định thành tùy chọn này.
• Tắt – Không gửi thông báo về video trực tiếp

Tại sao tôi không nhận được thông báo?

Có vài lý do khiến bạn có thể không nhận được thông báo về phát trực tiếp:

1. Bạn không phải là người hâm mộ của trang.
2. Bạn là người hâm mộ trang nhưng bài viết xuất phát từ một trang thương hiệu.
3. Bạn đã nhận được quá nhiều thông báo về phát trực tiếp trong 24 giờ qua.

Bình luận về video trực tiếp

Tương tác với người phát là một trong những phần hay nhất khi sử dụng video trực tiếp trên Facebook. Với Facebook Live, bạn có thể bình luận trong khi phát trực tiếp hoặc sau đó, tạo ra trải nghiệm hấp dẫn có cảm giác sống động ngay cả sau khi video đã hoàn tất.

Đối với bình luận về VOD (Video theo yêu cầu), mỗi bình luận và cảm xúc được đưa ra trong khi người xem đang xem trực tiếp hoặc trong VOD đều được đánh dấu bằng thời gian hiện tại trong video và tất cả người xem trong tương lai sẽ nhìn thấy các bình luận, cảm xúc được phát lại vào thời điểm đó trong video mà chúng được đưa ra lúc đầu.

Kiểm duyệt bình luận

Hiện tại, thông số live_filter được sử dụng để kiểm duyệt bình luận về video trực tiếp. Giá trị mặc định là filter_low_quality sẽ xác định xem các bình luận chất lượng thấp có bị lọc ra khỏi kết quả không. Trong mọi trường hợp khác, thông số này được bỏ qua. Kiểm duyệt bình luận bổ sung không khả dụng qua API Live.

Đọc bình luận và cảm xúc

Đọc các bình luận về video trực tiếp bằng cách thăm dò cạnh Bình luận về video trực tiếp cũng như xem cảm xúc về video trực tiếp bằng cách thăm dò cạnh Cảm xúc. Sử dụng điểm cuối Sự kiện do máy chủ gửi đến để nhận cập nhật trong thời gian thực cho các cảm xúc và bình luận về video trực tiếp.

Lưu ý: Vui lòng đảm bảo rằng bạn đang kiểm tra cạnh bình luận về Video trực tiếp chứ không phải cạnh Bình luận về video. Ứng dụng của bạn có thể bị giới hạn tốc độ nếu sử dụng cạnh bình luận về Video. Để biết thêm thông tin về giới hạn tốc độ ứng dụng, hãy xem tài liệu về giới hạn tốc độ của chúng tôi.