API Video

Bản trình chiếu

Với API Video, bạn có thể đăng Video bản trình chiếu lên Trang và Nhóm. Không hỗ trợ đăng lên trang Người dùng. Các ví dụ trong tài liệu này dùng nút Trang nhưng cũng áp dụng tương tự như cho nút Nhóm.

Tạo bản trình chiếu

Gửi yêu cầu POST đến cạnh Video trên Trang và thêm đối tượng chứa một mảng URL hình ảnh sẽ dùng để tạo video. Hình ảnh phải được lưu trữ trên máy chủ có thể truy cập công khai. Đối tượng phải mô tả thời gian hiển thị từng hình ảnh và khoảng thời gian chuyển tiếp giữa các hình ảnh.

Định dạng hình ảnh

JPG, JPEG, PNG, BMP, ICO

Kích thước hình ảnh

Nếu hình ảnh có kích thước khác nhau, API này sẽ cắt và đổi thành kích thước 600x600 pixel rồi tạo video vuông. Nếu tất cả hình ảnh có kích thước giống nhau, video sẽ khớp với kích thước đó.

Yêu cầu

  • Yêu cầu phải có tối thiểu 3 hình ảnh và tối đa 7 hình ảnh.
  • Mỗi hình ảnh phải có dung lượng 10 MB trở xuống.

Cú pháp yêu cầu

POST /v19.0/{page-id}/videos ?access_token={access-token} &slideshow_spec={slideshow-spec}

Thông số bắt buộc

Thông số Mô tả

access_token

Mã truy cập Trang nếu đăng lên Trang hoặc mã truy cập Người dùng nếu đăng lên Nhóm.

slideshow_spec

Đối tượng chứa một mảng URL hình ảnh và thuộc tính mô tả video. Hãy xem phần Thuộc tính đối tượng bản trình chiếu ở bên dưới.

Thuộc tính đối tượng bản trình chiếu

Thuộc tính Mô tả

images_urls
Bắt buộc

Mảng chứa 3 - 7 URL hình ảnh sẽ dùng để tạo video.

duration_ms

Số nguyên cho biết khoảng thời gian tính bằng mili giây mà mỗi hình ảnh sẽ hiển thị trong video. Giá trị mặc định là 1750. Giá trị phải lớn hơn 0.

transition_ms

Số nguyên cho biết khoảng thời gian tính bằng mili giây khi chuyển tiếp nhiễu xuyên kênh giữa các hình ảnh. Giá trị mặc định là 250. Giá trị phải lớn hơn 0.

Ví dụ về yêu cầu

curl -X POST \ "https://graph-video.facebook.com/v19.0/1755847768034402/videos" \ -F "access_token=EAADd..." \ -F "slideshow_spec={ \ "images_urls":[ \ 'https://socialsizz...1.png', \ 'https://socialsizz...2.png', \ 'https://socialsizz...3.png' \ ], \ "duration_ms": 5000, \ "transition_ms": 200 \ }"

Khi thành công, API này sẽ phản hồi kèm theo ID của Video mới tạo.

Ví dụ về phản hồi ở định dạng JSON

{ "id":"277487313407856" }