Tài liệu tham khảo

Cài đặt đề xuất

Để đảm bảo phát trực tiếp thành công, video trực tiếp phải:

Bao gồm cả dữ liệu âm thanh và dữ liệu video
Không vượt quá 8 giờ
Sử dụng các cài đặt đề xuất nêu bên dưới (ví dụ: phải là H264/AAC)
Không thay đổi cài đặt khi đang phát trực tiếp

Việc không đáp ứng những giới hạn này có thể dẫn đến:

Video đang phát bị dừng đột ngột
Chất lượng thấp hơn cho người xem
Hành vi không mong muốn

Cài đặt video

Kích thước khung hình chính - Khuyên dùng 2 giây. Không vượt quá 4 giây.
Độ phân giải và tốc độ bit -
1080p @ 60 khung hình/giây
Độ phân giải: 1920x1080
Khoảng tốc độ bit của video: 4.500-9.000 Kb/giây
1080p @ 30 khung hình/giây
Độ phân giải: 1920x1080
Khoảng tốc độ bit của video: 3.000-6.000 Kb/giây
720p @ 60 khung hình/giây
Độ phân giải: 1280x720
Khoảng tốc độ bit của video: 2.250-6.000 Kb/giây
720p @ 30 khung hình/giây
Độ phân giải: 1280x720
Khoảng tốc độ bit của video: 1.500-4.000 Kb/giây
480p @ 30 khung hình/giây
Độ phân giải: 854x480
Khoảng tốc độ bit của video: 600-2.000 Kb/giây
360p
Độ phân giải: 640x360
Khoảng tốc độ bit của video: 400-1.000 Kb/giây
Giao thức - Phát trực tiếp RTMPS
Tỷ lệ khung hình pixel – Hướng đến tỷ lệ 16:9; nếu tỷ lệ của bạn quá khác so với tỷ lệ này, chúng tôi có thể không hỗ trợ buổi phát trực tiếp của bạn
Codec video -
- H.264, Cấp độ 4.1 cho tối đa 1080p 30 khung hình/giây
- H.264, Cấp độ 4.2 cho 1080p 60 khung hình/giây

Cài đặt âm thanh

Codec âm thanh - Độ phức tạp thấp AAC
Tốc độ mẫu - 44,1 kHz hoặc 48 kHz
Tốc độ bit của âm thanh - 128 kb/giây (ưu tiên) đến 256 kb/giây (không vượt quá)
Bố cục kênh - Stereo

Điểm cuối

LiveVideo

Điểm cuối	Mô tả
`DELETE /{live_video_id}`	Xóa LiveVideo.
`GET /{event-id}/live_videos`	Lấy tập hợp LiveVideo trên một Sự kiện.
`GET /{group-id}/live_videos`	Lấy tập hợp LiveVideo trên một Nhóm.
`GET /{live-video-id}`	Lấy trường và cạnh trên một LiveVideo.
`GET /{live-video-id}/comments`	Lấy tập hợp Bình luận trên một LiveVideo.
`GET /{live-video-id}/crosspost_shared_pages`	Lấy tập hợp Trang có thể chia sẻ một LiveVideo.
`GET /{live-video-id}/likes`	Lấy tập hợp Trang cá nhân đã thích một LiveVideo.
`GET /{live-video-id}/polls`	Lấy tập hợp VideoPoll trên một LiveVideo.
`GET /{live-video-id}/reactions`	Lấy tập hợp Trang cá nhân đã bày tỏ cảm xúc về một LiveVideo.
`GET /{page-id}/live_videos`	Lấy tập hợp LiveVideo trên một Trang.
`GET /{user-id}/live_videos`	Lấy tập hợp LiveVideo trên một Người dùng.
`POST /{event-id}/live_videos`	Tạo LiveVideo trên một Sự kiện.
`POST /{group-id}/live_videos`	Tạo LiveVideo trên một Nhóm.
`POST /{live_video_id}`	Cập nhật các trường trên một LiveVideo.
`POST /{live_video_id}/input_streams`	Tạo LiveVideoInputStream trên một LiveVideo.
`POST /{live_video_id}/polls`	Tạo VideoPoll trên một LiveVideo.
`POST /{page-id}/live_videos`	Tạo LiveVideo trên một Trang.
`POST /{user-id}/live_videos`	Tạo LiveVideo trên một Người dùng.

LiveVideoInputStream

Điểm cuối	Mô tả
`GET /{live-video-input-stream-id}`	Lấy trường và cạnh trên một LiveVideoInputStream.
`POST /{live_video_id}/input_streams`	Tạo LiveVideoInputStream trên một LiveVideo.

Cuộc thăm dò ý kiến

Điểm cuối	Mô tả
`GET /{live-video-id}/polls`	Lấy tập hợp VideoPoll trên một LiveVideo.
`GET /{video-poll-id}`	Lấy trường và cạnh trên một VideoPoll.
`POST /{live_video_id}/polls`	Tạo VideoPoll trên một LiveVideo.
`POST /{video_poll_id}`	Cập nhật các trường trên một VideoPoll.

Mã lỗi

Thông báo lỗi sẽ được gửi qua RTMP, sau đó được gửi đến API Đồ thị. Bạn có thể sử dụng ID video/nội dung phát và truy vấn lỗi trong công cụ Trình khám phá đồ thị thông qua yêu cầu GET. Lỗi được trả về sẽ chứa mã lỗi, mô tả và nhãn thời gian.

error_subcode	Tóm tắt lỗi	Mô tả
`COPYRIGHT__LIVE_COPYRIGHT_VIOLATION`	Vi phạm bản quyền trực tiếp	Video trực tiếp của bạn đã bị ngừng do có thể chứa nội dung âm thanh hoặc hình ảnh thuộc sở hữu của một Trang khác.
`VIDEO__CREATE_FAILED`	Sự cố tải lên	Đã xảy ra sự cố và video của bạn không tải lên được. Vui lòng thử lại.
`LIVE_VIDEO__DELETE_FAILED`	Không xóa được video trực tiếp	Đã xảy ra sự cố và chúng tôi không thể xóa video trực tiếp của bạn. Vui lòng thử lại.
`LIVE_VIDEO__EDIT_API_NOT_ALLOWED`	Không được phép chỉnh sửa qua API Video trong khi phát trực tiếp	Không được phép chỉnh sửa video trực tiếp bằng API Chỉnh sửa video. Hãy sử dụng ID video trực tiếp.
`LIVE_VIDEO__LIVE_STREAM_ERROR`	Luồng chung	Đã xảy ra lỗi trong luồng
`LIVE_VIDEO__NOT_EXIST`	Video trực tiếp không tồn tại	Video trực tiếp mà bạn đang cố truy cập không tồn tại trong hệ thống nữa.
`LIVE_VIDEO__PRIVACY_REQUIRED`	Cần cài đặt quyền riêng tư	Bạn cần phải đặt quyền riêng tư trước khi phát trực tiếp.