Phiên bản API Đồ thị

Video trực tiếp trong nhóm

Để biết thêm thông tin về API Video trực tiếp, hãy truy cập vào Tài liệu về video trực tiếp của chúng tôi.

Tạo

Bạn có thể gửi yêu cầu POST đến cạnh live_videos từ các đường dẫn sau đây:

/{group-id}/live_videos

Khi đăng lên cạnh này, Video trực tiếp sẽ được tạo.

Thông số

Tên	Mô tả
`app_attribution_tag` chuỗi số hoặc số nguyên	Thẻ phân bổ dành cho video trực tiếp sẽ hiển thị trên bảng feed.
`attribution_app_id` chuỗi số hoặc số nguyên	ID của ứng dụng phân bổ.
`content_tags` danh sách<chuỗi số>	Thẻ mô tả nội dung video. Sử dụng điểm cuối tìm kiếm có `type=adinterest` để lấy các ID có thể có. Truy vấn mẫu: /search?type=adinterest&q=sunsets
`description` chuỗi UTF-8	Nội dung mô tả video trực tiếp. Hỗ trợ biểu tượng cảm xúc.
`encoding_settings` chuỗi	Thông tin nhận dạng của nhóm cài đặt mã hóa mà người phát đang dùng cho buổi phát này. Thông số này hiện chỉ dùng cho buổi phát trực tiếp 360. Giá trị cần chuyển vào thông số này là giá trị của khóa `identifier` trong giá trị cài đặt mã hóa đặt sẵn. Bạn có thể tìm giá trị mã hóa đặt sẵn bằng cách truy vấn điểm cuối API Đồ thị `/broadcaster_encoding_settings` (truy vấn `GET`).
`event_params` số nguyên	Nhãn thời gian Unix khi người phát dự định phát trực tiếp.
`fisheye_video_cropped` boolean	Liệu có cắt một video mắt cá hay không.
`front_z_rotation` float	Giá trị xoay quanh trục z trước (tính theo độ) trên một video mắt cá.
`game_id` chuỗi số hoặc số nguyên	Đặt game mà video này giới thiệu. Sử dụng điểm cuối tìm kiếm có `type=game` để lấy các ID có thể có. Truy vấn mẫu: /search?type=game&=pubg
`game_specs` Thông số kỹ thuật của game	Đặt siêu dữ liệu biểu thị game sẽ được phân bổ.
`is_spherical` boolean	Cờ cho biết nội dung phát là buổi phát trực tiếp 360.
`live_encoders` danh sách<chuỗi số hoặc số nguyên>	Bộ mã hóa trực tiếp sẽ phát đến video trực tiếp này.
`original_fov` int64	Trường nhìn ban đầu của camera.
`post_surfaces_blacklist` danh sách<enum{1, 2, 3, 4, 5}>	Danh sách cấm liệt kê những vị trí mà bài viết sẽ không hiển thị, dành riêng cho trải nghiệm bảng feed.
`privacy` Thông số quyền riêng tư	Quyền riêng tư dành cho video trực tiếp này.
`projection` enum{EQUIRECTANGULAR, CUBEMAP}	Cờ cho biết phép chiếu dự kiến dành cho buổi phát trực tiếp 360. Giá trị mặc định là EQUIRECTANGULAR.
`save_vod` boolean	Liệu có cần lưu dữ liệu video ở định dạng VOD để dùng sau này hay không. Giá trị mặc định là true. (Lưu ý: Chỉ có thể đặt vào lúc tạo)
`schedule_custom_profile_image` hình ảnh	Hình ảnh tùy chỉnh sẽ xuất hiện trong tin trực tiếp theo lịch và sảnh chờ.
`spatial_audio_format` enum{ambiX_4}	Cho biết định dạng của video đang phát âm thanh đa chiều. Khi âm thanh không xác định được xem là âm thanh mono hoặc stereo.
`status` enum {UNPUBLISHED, LIVE_NOW, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_CANCELED}	Trạng thái của nội dung phát. Nội dung phát `LIVE_NOW` hiện đang phát trực tiếp và hiển thị với Người dùng. Nội dung phát `UNPUBLISHED` đang trong quá trình chuẩn bị và không hiển thị với những người dùng khác. Nội dung phát chưa đăng có thể tự động bị xóa sau khi ở trạng thái này vài giờ. Hãy cân nhắc dùng các trạng thái đã lên lịch để tạo nội dung phát dự kiến sau này.
`stereoscopic_mode` enum {MONO, LEFT_RIGHT, TOP_BOTTOM}	Đặt cờ này ở chế độ lập thể cho video này.
`stop_on_delete_stream`	Đặt thông số này thành `true` nếu phải dừng video đang phát khi nhận được lệnh RTMP `deleteStream`.
`title` chuỗi UTF-8	Tiêu đề của video trực tiếp. Hỗ trợ biểu tượng cảm xúc.

Loại trả về

Điểm cuối này hỗ trợ tính năng đọc sau khi ghi và sẽ đọc nút được biểu thị bằng id trong loại trả về.

Struct { id: numeric string, stream_url: string, secure_stream_url: string, stream_secondary_urls: List [ string ], secure_stream_secondary_urls: List [ string ], dash_ingest_url: string, }

Quy tắc xác thực

Lỗi	Mô tả
100	Thông số không hợp lệ
200	Lỗi về quyền

Đọc

Tính năng

Tên	Mô tả
API Nhóm	Đây là một tính năng cần phải trải qua quy trình Xét duyệt ứng dụng.

Ví dụ

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{group-id}/live_videos",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

GET /v7.0/{group-id}/live_videos HTTP/1.1
Host: graph.facebook.com

// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{group-id}/live_videos"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

/* make the API call */
FB.api(
    "/{group-id}/live_videos",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{group-id}/live_videos',
    'your-access-token'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

Hãy tìm hiểu thêm về API Đồ thị trong Hướng dẫn sử dụng API Đồ thị của chúng tôi.

Thông số

Tên Mô tả

Tên	Mô tả
`broadcast_status` danh sách<enum {UNPUBLISHED, LIVE, LIVE_STOPPED, PROCESSING, VOD, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_EXPIRED, SCHEDULED_CANCELED}>	Cho phép bạn chỉ định loại trả về video trực tiếp. Hệ thống sẽ trả về mọi loại trạng thái nếu bạn không chỉ định giá trị.
`source` enum{target, owner}	Giá trị mặc định: `target` Nguồn cần truy vấn video. Ví dụ: `target` lấy video phát trực tiếp trên một nhóm. Video trực tiếp trong nhóm CHỈ hỗ trợ `target`.

broadcast_status

danh sách<enum {UNPUBLISHED, LIVE, LIVE_STOPPED, PROCESSING, VOD, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_EXPIRED, SCHEDULED_CANCELED}>

Cho phép bạn chỉ định loại trả về video trực tiếp. Hệ thống sẽ trả về mọi loại trạng thái nếu bạn không chỉ định giá trị.

source

enum{target, owner}

Giá trị mặc định: target

Nguồn cần truy vấn video. Ví dụ: target lấy video phát trực tiếp trên một nhóm. Video trực tiếp trong nhóm CHỈ hỗ trợ target.

Trường

Khi đọc cạnh này, bạn sẽ nhận được kết quả ở định dạng JSON:

{ "data": [], "paging": {} }

data

Danh sách các trường LiveVideo.

paging

Để biết thêm thông tin chi tiết về cách phân trang, hãy xem hướng dẫn về API Đồ thị.

Quy tắc xác thực

Lỗi	Mô tả
200	Lỗi về quyền

Cập nhật

Bạn không thể thực hiện thao tác đó trên điểm cuối này.

Xóa

Bạn không thể thực hiện thao tác đó trên điểm cuối này.