Memulai

Dokumen ini menjelaskan cara menggunakan Live Video API untuk membuat pengalaman siaran langsung di profil Pengguna Anda sendiri menggunakan aplikasi. Jika Anda tidak memiliki aplikasi, Anda dapat menggunakan Graph API Explorer dan perangkat lunak streaming video gratis, seperti OBS atau Player.me.

Sebelum Memulai

Anda akan memerlukan akses ke beberapa hal berikut:

Akun Developer Meta
Aplikasi Facebook terdaftar dengan Pengaturan Dasar yang telah dikonfigurasi

Jika Anda tidak memiliki aplikasi, Anda juga akan memerlukan:

Perangkat lunak streaming video
Pengetahuan dasar tentang Graph API Explorer

1. Mengonfigurasi Facebook Login

Tambahkan produk Facebook Login ke aplikasi Anda di Dasbor Aplikasi.

Anda dapat membiarkan semua pengaturan pada default-nya. Jika Anda menerapkan Facebook Login secara manual (yang tidak kami rekomendasikan), masukkan redirect_uri di kolom URI pengarahan ulang OAuth Valid. Jika Anda akan menggunakan salah satu SDK kami, Anda dapat mengosongkannya.

2. Menerapkan Facebook Login

Ikuti dokumentasi Facebook Login kami untuk platform Anda dan terapkan Facebook Login ke aplikasi Anda. Jika aplikasi ada di perangkat yang tidak menggunakan antarmuka yang memungkinkan pengguna masuk ke Facebook, terapkan Facebook Login untuk Perangkat.

Aplikasi akan memerlukan izin berikut:

publish_video

Jika aplikasi Anda belum siap dan Anda menggunakan Graph API Explorer dan perangkat lunak streaming video, Anda dapat melewati langkah ini.

3. Mendapatkan Token Akses

Setelah menerapkan Facebook Login, pastikan Anda masuk ke akun Developer Meta, lalu akses aplikasi dan mulai modal Facebook Login. Jika Anda menggunakan Graph API Explorer, pilih aplikasi Anda dari menu pilihan Aplikasi Facebook dan klik tombol Buat Token Akses.

Setelah Anda memulai modal tersebut, klik menu pilihan dan pilih Hanya saya sehingga hanya Anda yang dapat melihat siaran tersebut. Klik OK, dan pada modal berikutnya, klik OK lagi untuk memberikan izin publish_video pada aplikasi. API akan memberikan token akses Pengguna. Ambil gambar token sehingga aplikasi Anda dapat menggunakannya pada beberapa kueri berikutnya.

Jika Anda menggunakan Graph API Explorer, gambarnya akan diambil secara otomatis dan ditampilkan di kolom Token Akses sebagai referensi:

4. Membuat Objek Siaran Langsung

Setelah Anda memiliki token akses dengan izin publish_video, Anda dapat menggunakannya untuk membuat objek Siaran Langsung di profil Pengguna.

Kirimkan permintaan ke endpoint POST /me/live_videos?status=LIVE_NOW. Contoh:

curl -i -X POST \
 "https://graph.facebook.com/v3.3/me/live_videos?status=LIVE_NOW&access_token={access-token}"

Tindakan ini akan mengembalikan tanggapan yang terlihat seperti ini:

{ 
  "id": "10214937378883406",  //The LiveVideo object ID
  "stream_url": "rtmp://rtmp-api.faceboo...",
  "secure_stream_url": "rtmps://rtmp-api.faceboo...", //The stream URL
  "stream_secondary_urls": [],
  "secure_stream_secondary_urls": []
}

Ambil gambar nilai id dan secure_stream_url yang ditampilkan kepada Anda. id adalah ID objek Siaran Langsung, yang dapat Anda gunakan untuk memanipulasi siaran Anda. secure_stream_url adalah URL penyerapan yang akan Anda gunakan untuk menyalurkan data siaran langsung dari pengenkode ke objek Siaran Langsung.

5. Salurkan ke URL Aliran Aman

Teruskan nilai secure_stream_url yang Anda ambil gambarnya pada langkah terakhir ke perangkat enkode dan salurkan data siaran langsung ke perangkat tersebut. Setelah objek Siaran Langsung mendeteksi aliran data, siaran tersebut akan disiarkan langsung di profil Pengguna Anda.

Lihat profil dan verifikasikan postingan siaran langsung baru telah dibuat dan sedang menyiarkan data aliran.

Jika Anda menggunakan perangkat lunak streaming video daripada mengembangkan aplikasi sendiri, tambahkan nilai secure_stream_url secara manual ke perangkat lunak Anda. Tergantung perangkat lunak streaming video yang Anda gunakan, Anda mungkin harus memecah URL aliran ke server (rtmps://rtmp-api.facebook.com/rtmp/) dan komponen utamanya (semuanya setelah /rtmp/).

Contoh: di OBS, pilih OBS > Preferences. Tindakan ini membuka layar Pengaturan. Atur Layanan ke Siaran Langsung Facebook, tambahkan URL aliran di Pengaturan > Aliran > Kode Streaming, lalu mulai aliran Anda.

6. Mengakhiri Siaran

Setelah Anda memastikan Anda menyiarkan siaran langsung di profil, akhiri siaran tersebut dengan mengirimkan permintaan ke endpoint POST /{live-video-id}?end_live_video=true. Contoh:

curl -i -X POST \
  "https://graph.facebook.com/v3.3/{live-video-id}?end_live_video=true&access_token={access-token}"

Langkah ini mengakhiri siaran Anda dan menyimpannya sebagai video sesuai permintaan (VOD). Jika Anda ingin menghapus VOD, kirim permintaan ke endpoint DELETE /{live-video-id}.

Langkah Berikutnya

Temukan contoh lain penggunaan Live Video API untuk menjadwalkan siaran langsung, memposting ke Halaman atau Grup, dan mendapatkan tanggapan dan komentar Pengguna di Penggunaan Umum.