Dokumen ini sudah diperbarui.
Terjemahan ke Bahasa Indonesia belum selesai.
Bahasa Inggris diperbarui: 21 Mei
Bahasa Indonesia diperbarui: 20 Des 2021

Support for Live Video API for Facebook

FAQ

Perangkat lunak streaming, atau perangkat lunak encoding RTMP, membawa URL dan kunci stream RTMP dan mengirimnya ke Facebook. Kami tidak menyediakan perangkat lunak untuk streaming. Banyak streaming siaran langsung dapat menggunakan OBS (Open Broadcasting Software) atau Player.me, keduanya menawarkan versi gratis.

Anda dapat mulai menggunakan Live API segera. Namun, jika Anda ingin membuat stream kualitas produksi penuh dengan beberapa kamera dan grafis, perlu waktu 1-2 minggu atau lebih lama, tergantung Tinjauan Aplikasi.

Ada jeda sekitar 4-5 detik mulai Anda siaran langsung hingga video muncul di Facebook. Anda akan tahu streaming ini selesai ketika melihat video diputar di halaman uji coba (atau publik).

If you are having issues with your live streams, please refer to our guides to make sure that you are using our API correctly. We also recommend reviewing our video specifications to ensure that your settings are best suited for a quality live stream. If you believe you have run into a bug, you can send it directly to our Bug Tool and an engineer will get back to you.

Yes you can! The second stream will likely get fewer inferred notifications than the first. Please refer to our Best Practices documentation for more information on how notifications work.

Belum tentu. Jika Anda ingin streaming ke dua halaman (atau lebih) berbeda, tersedia encoder dan API yang memungkinkan hal ini, seperti Wowza dan Streamshark. Meskipun streaming dapat dilakukan ke halaman berbeda dari satu encoder, sebaiknya streaming ke satu halaman dan bagikan ke halaman lain sehingga komentar, tanggapan, dan jumlah tayangan digabungkan.

Our default aspect ratio is 16x9, though we infer the aspect ratio from the stream. For complete specifications, see our reference.

Anda dapat menyematkan video siaran langsung menggunakan parameter embeddable melalui API Video Siaran Langsung.

Kirimkan permintaan POST /{live_video_id}, dan atur parameter embeddable ke true. Gunakan token akses Halaman atau Pengguna dengan izin yang sama dengan yang diperlukan saat membuat video siaran langsung.

curl -i -X POST \
 "https://graph.facebook.com/{your-live-video-id}
   ?embeddable=true&access_token={your-access-token}"
GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/{your-live-video-id}",
  new JSONObject("{}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{your-live-video-id}"
           parameters:@{ @"embeddable": @"true",}
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];
FB.api(
  '/{your-live-video-id}',
  'POST',
  {"embeddable":"true"},
  function(response) {
      // Insert your code here
  }
);
try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->post(
    '/{your-live-video-id}',
    array (
      'embeddable' => 'true'
    ),
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Untuk mendapatkan HTML yang disematkan, kirimkan permintaan GET /{live_video_id}?fields=embed_html. Gunakan token akses Halaman atau Pengguna dengan izin yang sama dengan yang diperlukan saat membuat video siaran langsung.

curl -i -X GET \
 "https://graph.facebook.com/{your-live_video_id}
   ?fields=embed_html
   &access_token={your-access-token}"
GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/{your-live_video_id}",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "embed_html");
request.setParameters(parameters);
request.executeAsync();
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{your-live_video_id}"
           parameters:@{ @"fields": @"embed_html",}
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];
FB.api(
  '/{your-live_video_id}',
  'GET',
  {"fields":"embed_html"},
  function(response) {
      // Insert your code here
  }
);
try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/{your-live_video_id}',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Contoh Tanggapan

{ "embed_html": "<iframe src=\"https://www.facebook.com/plugins/video.php?href=https%3A%2F%2Fwww.facebook.com%2Fyourpage%2Fvideos%2F{your-page-id}%2F&width=0\" width=\"0\" height=\"0\" style=\"border:none;overflow:hidden\" scrolling=\"no\" frameborder=\"0\" allowTransparency=\"true\" allowFullScreen=\"true\"></iframe>", "id": "{your-live-video-id}" } 

Tidak, ini perilaku yang ditunggu. Saat ini kami tidak mendukung menonton siaran langsung di web seluler hingga menjadi VOD (Video Sesuai Permintaan). Namun, jika Anda ingin menonton siaran langsung di web seluler yang telah disematkan ke situs lain, Anda akan dialihkan ke aplikasi Facebook untuk menonton.

Berikut beberapa alasan mengapa hal ini terjadi. Berikut beberapa alasan paling umum:

  1. Jika Anda memutar musik di latar belakang siaran langsung, video Anda dapat dihapus karena pelanggaran hak cipta. Hal ini dapat terjadi selama siaran langsung atau setelahnya, dalam pemutaran VOD.
  2. Anda, atau pencipta lain halaman Anda, mungkin telah menghapus siaran langsung tersebut. Jika siaran langsung telah dihapus secara manual, video itu tidak dapat dipulihkan.
  3. Video Anda telah ditandai secara otomatis karena pelanggaran IP. Jika hal ini terjadi, Facebook akan mengirimi Anda email yang berisi tautan agar Anda meninjau penghapusan tersebut dan mengirim lagi video tersebut untuk ditinjau oleh tim Kebijakan kami.

Hal ini terjadi saat siaran tidak mulai menutup atau memproses setelah memberi sinyal berakhirnya siaran langsung. Pastikan Anda mengirim permintaan POST dengan parameter end_live_video. Jika hal ini terjadi lagi, ajukan bug di alat bug kami, dan pastikan untuk mencantumkan ID video Anda.

Distorsi audio dapat terjadi ketika Facebook menerima streaming video dengan audio yang terdistorsi atau setelah menerima frame tetapi sebelum mengkode ulang untuk siaran. Penyebab jenis kesalahan ini adalah jika bitrate yang digunakan lebih tinggi dibandingkan koneksi antara endpoint siaran Anda dengan apa yang dapat didukung oleh server Facebook. Jika hal itu terjadi, atau jika ada paket yang hilang, beberapa trek video atau audio tidak akan diterima dengan benar, dan hal ini akan menyebabkan distorsi audio.

Masalah sinkronisasi Audio/Visual dapat terjadi saat siaran langsung dikirim dengan bandwidth terbatas kepada klien, atau klien tidak memiliki bandwidth untuk menontonnya secara langsung. Selain itu, jika stream yang diterima oleh server Facebook tidak sinkron, siaran langsung itu juga akan tidak sinkron. Pastikan untuk memeriksa perangkat keras rekaman dan encoding untuk mengetahui tempat-tempat yang berpotensial menyebabkan audio tidak selaras dengan video.

API Video Siaran Langsung Jika Anda mencoba streaming video saja, stream tersebut akan berakhir.

Kabar siaran langsung Anda dapat berkurang karena kegagalan encoder atau jeleknya konektivitas jaringan. Jika hal ini terjadi, ada waktu 2-3 menit untuk terhubung kembali ke URL stream asli yang Anda buat untuk postingan siaran langsung Anda. Jika tidak, Anda harus membuat key dan URL stream baru untuk melanjutkan streaming siaran langsung.

Yes, you can geo-gate (restrict who can see your video depending on the viewer's location). See Audience Targeting to learn how.

Yes, videos taken down for copyright violation can be restored. You should receive a notification that gives you the option to restore the video. However, if you do not take this action when you receive the notification, the video can no longer be restored.

Tidak. Sayangnya, saat ini siaran langsung tidak dapat dipromosikan.

Saat ini tidak ada endpoint untuk membuat keterangan tertutup. Namun, Anda dapat menambahkan keterangan tertutup ke Siaran Langsung setelah berakhir, atau Anda dapat menambahkan keterangan tertutup ke streaming siaran langsung saat streaming ke server kami menggunakan standar keterangan tertutup CEA-608.

Untuk menambahkan keterangan ke Siaran Langsung yang telah berakhir (yakni yang berstatus VOD), lihat topik bantuan "Bagaimana cara menambahkan keterangan ke video Halaman?". Untuk menambahkan keterangan dengan standar CEA-608, lihat panduan Keterangan Tertutup.

Memasukkan iklan pihak ketiga ke dalam stream langsung bertentangan dengan kebijakan streaming siaran langsung Facebook. Misalnya, mohon untuk tidak memasukkan bumper, sebelum pemutaran konten, di tengah pemutaran konten, atau setelah pemutaran konten.

We encourage all live broadcasts to exclusively contain live content so as to preserve the integrity of the viewer's experience. However, there are unique cases in which cutting to a pre-recorded clip makes sense, similar to how a news show might show previously recorded content on live TV.

Yes, refer to our Crossposting guide and How do I crosspost another Page's video? Help Center topic to learn how. Comments and reactions are shown only in the original Page.

Agar muncul di Peta Siaran Langsung, Anda harus mengatur lokasi video menggunakan place parameter dalam permintaan POST /{live_video_id}.

Untuk mengatur ulang, kunjungi www.facebook.com/live/create, klik Buat Streaming Siaran Langsung, centang kotak Gunakan stream key persisten, lalu klik tombol Atur Ulang.

Reporting Bugs

If you believe you may have found a bug in the Live API, please file a bug report in our bug tool and an engineer will take a look at it shortly. You can also search for existing bugs by API error codes, SDK methods, and more.

Report a Bug