Menjadwalkan Siaran

Anda dapat menggunakan Live Video API untuk membuat video siaran langsung yang akan disiarkan secara langsung pada waktu yang ditentukan sebelumnya, sampai tujuh hari sejak tanggal pembuatannya.

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

Untuk membuat video siaran langsung dengan tanggal mulai di masa mendatang pada Pengguna, Halaman, Grup, atau Acara, kirimkan permintaan ke:

POST /<ID>/live_videos?status=SCHEDULED_UNPUBLISHED&event_params=<UNIX_TIMESTAMP_FOR_START_TIME>

Gunakan parameter event_params dan cap waktu UNIX untuk menetapkan waktu mulai yang diinginkan.

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.

Ini akan membuat objek LiveVideo pada node target dan mengembalikan secure_stream_url dan id dari video siaran langsung. Gunakan URL aliran aman dengan enkoder Anda untuk menyalurkan data video siaran langsung ke objek LiveVideo pada, atau sebelum, waktu mulai yang dijadwalkan. Siaran akan muncul pada linimasa/kabar node pada waktu mulai yang dijadwalkan sepanjang siaran tersebut menerima data aliran.

Siaran terjadwal bisa menerima data aliran kapan saja sebelum tanggal mulainya, untuk tujuan cuplikan.

Contoh Permintaan

curl -i -X POST \ 
      "https://graph.facebook.com/v21.0/<ID>/live_videos?status=SCHEDULED_UNPUBLISHED&event_params=1541539800"

Contoh Tanggapan

{
  "id": "10214937378883406",  //LiveVideo object ID
  "stream_url": "rtmp://rtmp-api.facebook...",
  "secure_stream_url": "rtmps://rtmp-api.facebook..."  //Stream URL
}

Untuk mendapatkan daftar siaran yang dijadwalkan, lihat Mendapatkan Siaran Terjadwal.

Melihat Cuplikan Siaran

Anda dapat menggunakan Live Video API untuk melihat cuplikan video siaran langsung yang belum diterbitkan; objek LiveVideo dibuat dengan status yang diatur ke SCHEDULED_UNPUBLISHED atau UNPUBLISHED.

Untuk melihat cuplikan video siaran langsung yang belum diterbitkan, kirimkan permintaan ke:

GET /<LIVE_VIDEO_ID?fields={fields}

Gunakan parameter fields untuk mendapatkan dash_preview_url untuk objek LiveVideo.

Contoh Permintaan

curl -i -X GET \
 "https://graph.facebook.com/v21.0/<LIVE_VIDEO_ID>?fields=dash_preview_url"

Contoh Tanggapan

{
  'dash_preview_url': 'https://video.xx.fbcdn.net/...',
  'id': '<LIVE_VIDEO_ID>'
}

Ini mengembalikan dash_preview_url dan id dari video siaran langsung. Salin dan tempelkan URL ke Pemutar Dash untuk melihat cuplikan siaran.

Meski melihat cuplikan siaran Anda dengan pemutar video uji pihak ketiga adalah cara yang bagus untuk memeriksa isi siaran Anda, kami rekomendasikan Anda untuk menyiarkannya pada sebuah halaman uji. Anda harus menjadi admin atau editor halaman untuk dapat menyiarkan halaman. Selain itu, Anda dapat mengatur parameter privasi untuk membuat aliran yang hanya terlihat untuk Anda.

Mendapatkan Siaran Terjadwal

Untuk mendapatkan siaran terjadwal untuk Pengguna, Halaman, atau Acara, dapatkan token akses yang semestinya dengan izin publish_video dan kirimkan permintaan ke:

GET /<ID>/live_videos?broadcast_status=["SCHEDULED_UNPUBLISHED"]

Harap diketahui bahwa nilai broadcast_status haruslah array. Lihat referensi LiveVideo untuk daftar lengkap nilai tambahan.

Contoh Daftar Siaran untuk sebuah Halaman

curl -i -X GET \ 
  "https://graph.facebook.com/v21.0/<ID>/live_videos?broadcast_status=["SCHEDULED_UNPUBLISHED"]"

Contoh Tanggapan

{
  "data": [
    {
      "status": "SCHEDULED_UNPUBLISHED",
      "stream_url": "rtmp://rtmp-api-dev.facebook.com:80/rtmp/...",
      "secure_stream_url": "rtmps://rtmp-api-dev.facebook.com:443/rtmp/...",
      "embed_html": "<iframe src=\"https://www.facebook.com/plugins/video.php?...",
      "id": "10214937378883406 "  //LiveVideo object ID
    }
  ]
}

Menjadwalkan Ulang Siaran

Anda dapat mengubah waktu mulai siaran terjadwal dengan mengirimkan permintaan ke:

POST /<LIVE_VIDEO_ID>?event_params=<UNIX_TIMESTAMP_FOR_NEW_START_TIME>

Nilai <UNIX_TIMESTAMP_FOR_NEW_START_TIME> harus berupa cap waktu UNIX yang menunjukkan waktu mulai yang baru. Setelah berhasil, API akan menanggapi dengan ID objek LiveVideo.

Contoh Video Siaran Langsung untuk Halaman

curl -i -X POST \
  "https://graph.facebook.com/v21.0/<LIVE_VIDEO_ID>?event_params=1541540800"

Contoh Tanggapan

{
  "id": "10214937378883406"
}

Memulai Siaran Segera

Anda dapat memulai siaran segera dengan mengirimkan permintaan ke:

POST /<LIVE_VIDEO_ID>?status=LIVE_NOW

Siaran akan disiarkan secara langsung jika URL aliran yang terkait dengan objek LiveVideo, yang mewakili siaran, menerima data aliran. Setelah berhasil, API akan menanggapi dengan ID objek LiveVideo.

Contoh Permintaan

curl -i -X POST \
  "https://graph.facebook.com/v21.0/<LIVE_VIDEO_ID>?status=LIVE_NOW"

Contoh Tanggapan JSON

{
  "id": "10214937378883406" // <LIVE_VIDEO_ID>
}

Lihat Juga

LiveVideo Referensi