Versi Graph API

Video Siaran Langsung Grup

Untuk informasi selengkapnya tentang Live Video API, kunjungi Dokumen Video Siaran Langsung kami.

Membuat

Anda dapat membuat permintaan POST ke edge live_videos dari jalur berikut:

/{group-id}/live_videos

Saat memposting ke edge ini, Video Siaran Langsung akan dibuat.

Parameter

Nama	Deskripsi
`app_attribution_tag` string numerik atau bilangan bulat	Tanda atribusi untuk video siaran langsung yang akan tampil di kabar.
`attribution_app_id` string numerik atau bilangan bulat	ID aplikasi atribusi.
`content_tags` list<string numerik>	Tanda yang mendeskripsikan konten video. Gunakan endpoint pencarian dengan `type=adinterest` untuk mendapatkan ID yang mungkin. Contoh kueri: /search?type=adinterest&q=sunsets
`description` string UTF-8	Deskripsi video siaran langsung. Mendukung Emoji.
`encoding_settings` string	Pengidentifikasi grup pengaturan enkode yang digunakan oleh pembuat siaran untuk aliran ini. Parameter ini sekarang hanya digunakan untuk siaran langsung 360. Nilai yang akan diteruskan ke parameter ini adalah nilai kode `identifier` dari preset pengaturan enkode. Preset enkode dapat ditemukan dengan meng-kueri endpoint Graph API `/broadcaster_encoding_settings` (kueri `GET`).
`event_params` bilangan bulat	Cap waktu Unix saat pembuat siaran berencana untuk melakukan siaran langsung.
`fisheye_video_cropped` boolean	Apakah video fisheye tunggal dipotong atau tidak.
`front_z_rotation` float	Rotasi z depan dalam derajat pada video fisheye tunggal.
`game_id` string numerik atau bilangan bulat	Mengatur video ini tentang game mana. Gunakan endpoint pencarian dengan `type=game` untuk mendapatkan ID yang mungkin. Contoh kueri: /search?type=game&=pubg
`game_specs` Parameter Spesifikasi Game	Mengatur metadata yang mewakili game mana yang harus diatribusikan.
`is_spherical` boolean	Bendera yang menunjukkan bahwa siaran adalah siaran langsung 360.
`live_encoders` list<numberic string or integer>	Enkoder langsung yang akan disiarkan ke video siaran langsung ini.
`original_fov` int64	Bidang pandang asli kamera.
`post_surfaces_blacklist` list<enum{1, 2, 3, 4, 5}>	Daftar hitam tempat postingan tidak akan muncul, untuk pengalaman kabar saja.
`privacy` Parameter Privasi	Privasi untuk video siaran langsung ini.
`projection` enum{EQUIRECTANGULAR, CUBEMAP}	Bendera yang menunjukkan proyeksi yang diharapkan untuk siaran langsung 360. Nilai default-nya adalah EQUIRECTANGULAR.
`save_vod` boolean	Apakah data video harus disimpan dalam format VOD atau tidak untuk digunakan nanti. Default-nya adalah true. (Catatan: Hanya dapat diatur pada saat dibuat)
`schedule_custom_profile_image` gambar	Gambar khusus yang akan muncul di cerita siaran langsung terjadwal dan lobi.
`spatial_audio_format` enum{ambiX_4}	Menunjukkan format aliran audio spasial. Ketika audio tidak ditentukan, audio dianggap mono atau stereo.
`status` enum {UNPUBLISHED, LIVE_NOW, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_CANCELED}	Status siaran. Siaran `LIVE_NOW` saat ini sedang berlangsung dan dapat dilihat oleh Pengguna. Siaran `UNPUBLISHED` sedang dalam persiapan dan tidak terlihat oleh pengguna lain. Siaran yang batal diterbitkan dapat dihapus secara otomatis setelah beberapa jam berada dalam status ini. Pertimbangkan untuk menggunakan status terjadwal untuk membuat siaran terencana di masa depan.
`stereoscopic_mode` enum {MONO, LEFT_RIGHT, TOP_BOTTOM}	Atur bendera ini ke mode stereoskopik untuk video ini.
`stop_on_delete_stream`	Atur ini ke `true` jika aliran harus dihentikan ketika perintah RTMP `deleteStream` diterima.
`title` string UTF-8	Judul video siaran langsung. Mendukung Emoji.

Jenis Hasil

Endpoint ini mendukung read-after-write (RAW) dan akan membaca node yang diwakili oleh id dalam jenis hasil.

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, }

Aturan Validasi

Kesalahan	Deskripsi
100	Parameter tidak valid
200	Kesalahan izin

Membaca

Fitur

Nama	Deskripsi
Groups API	Ini adalah fitur yang membutuhkan Tinjauan Aplikasi.

Contoh

/* 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 */

Pelajari selengkapnya tentang Graph API dalam Menggunakan Panduan Menggunakan Graph API.

Parameter

Nama Deskripsi

Nama	Deskripsi
`broadcast_status` list<enum {UNPUBLISHED, LIVE, LIVE_STOPPED, PROCESSING, VOD, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_EXPIRED, SCHEDULED_CANCELED}>	Memungkinkan Anda untuk menentukan jenis video siaran langsung yang diberikan. Tidak ada nilai yang akan menampilkan semua jenis status.
`source` enum{target, owner}	Nilai default-nya: `target` Sumber tempat video harus di-kueri. Misalnya: `target` mendapatkan video disiarkan ke grup. Video Siaran Langsung Grup HANYA mendukung `target`.

broadcast_status

list<enum {UNPUBLISHED, LIVE, LIVE_STOPPED, PROCESSING, VOD, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_EXPIRED, SCHEDULED_CANCELED}>

Memungkinkan Anda untuk menentukan jenis video siaran langsung yang diberikan. Tidak ada nilai yang akan menampilkan semua jenis status.

source

enum{target, owner}

Nilai default-nya: target

Sumber tempat video harus di-kueri. Misalnya: target mendapatkan video disiarkan ke grup. Video Siaran Langsung Grup HANYA mendukung target.

Kolom

Membaca dari edge ini akan memberikan hasil berformat JSON:

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

data

Daftar kolom Siaran Video Langsung.

paging

Untuk detail selengkapnya tentang paginasi, lihat panduan Graph API.

Aturan Validasi

Kesalahan	Deskripsi
200	Kesalahan izin

Memperbarui

Anda tidak dapat melakukan operasi ini di endpoint ini.

Menghapus

Anda tidak dapat melakukan operasi ini di endpoint ini.