Memulai
Dokumen ini menjelaskan cara menggunakan Live Video API untuk menyiarkan video siaran langsung menggunakan aplikasi Anda. Jika belum memiliki aplikasi, Anda bisa menggunakan Graph API Explorer dan perangkat lunak streaming pilihan Anda.
Pada tanggal 10 Juni 2020, Meta meluncurkan persyaratan baru yang harus dipenuhi sebelum sebuah akun dapat melakukan siaran langsung di Facebook. Persyaratan barunya adalah sebagai berikut:
- Akun Facebook Anda harus berusia minimal 60 hari
- Halaman Facebook atau profil mode profesional harus memiliki minimal 100 pengikut
Sebelum Memulai
Jika sudah memiliki aplikasi, Anda akan memerlukan:
- Facebook Login yang diimplementasikan di aplikasi Anda
- Jika aplikasi ada di perangkat yang tidak mempunyai antarmuka yang bisa digunakan oleh pengguna untuk masuk ke Facebook, terapkan Facebook Login untuk Perangkat.
- Izin berikut:
publish_video
Jika Anda tidak memiliki aplikasi, Anda juga akan memerlukan:
- Perangkat lunak streaming video
Memulai siaran
Untuk membuat objek LiveVideo, kirim permintaan POST ke endpoint /me/live_videos?status=LIVE_NOW di mana me adalah ID untuk Pengguna atau Halaman.
Saat menguji panggilan API, Anda dapat menyertakan parameter access_token ke token akses Anda. Namun, saat melakukan panggilan aman dari aplikasi Anda, gunakan kelas token akses.
curl -i -X POST \
"https://graph.facebook.com/v25.0/me/live_videos?status=LIVE_NOW"
Tindakan ini akan menampilkan 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": []
}Catat nilai id dan secure_stream_url yang ditampilkan kepada Anda. id adalah ID objek LiveVideo yang dapat Anda gunakan untuk memanipulasi siaran Anda. secure_stream_url adalah URL penyerapan yang akan Anda gunakan untuk mengalirkan data video siaran langsung dari encoder Anda ke objek LiveVideo.
Menyalurkan siaran
Masukkan nilai secure_stream_url yang Anda catat pada langkah terakhir ke perangkat enkode dan salurkan data video siaran langsung ke perangkat tersebut. Setelah objek LiveVideo mendeteksi data aliran, siaran tersebut akan disiarkan langsung di profil Pengguna Anda.
Lihat profil dan verifikasi bahwa postingan siaran langsung baru telah dibuat dan sedang menyiarkan data aliran Anda.
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/).
Mengakhiri siaran
Untuk mengakhiri siaran, kirim permintaan POST ke endpoint /<LIVE_VIDEO_ID>?end_live_video=true.
Contoh permintaan mengakhiri siaran
curl -i -X POST \
"https://graph.facebook.com/v25.0/<LIVE_VIDEO_ID>?end_live_video=true"
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>.
Kode kesalahan izin ditolak
| Code | Subcode | Message | Type | Mitigation messaging |
|---|---|---|---|---|
200 | 1363120 | Permissions error | OAuthException | You’re not eligible to go live Your profile needs to be at least 60 days old before you can go live on Facebook. Learn more at https://www.facebook.com/business/help/167417030499767?id=1123223941353904 |
200 | 1363144 | Permissions error | OAuthException | You’re not eligible to go live You need at least 100 followers before you can go live from your profile. Learn more at https://www.facebook.com/business/help/167417030499767?id=1123223941353904 |
Langkah Berikutnya
- Gunakan Live Video API untuk menjadwalkan video siaran langsung untuk siaran mendatang.