Ce document a été mis à jour.
La traduction en Français (France) n’est pas encore terminée.

Anglais mis à jour : 16 nov. 2021

Références

Paramètres recommandés

Pour que la diffusion fonctionne correctement, la vidéo en direct doit répondre aux critères suivants :

Inclure des données audio et vidéo
Durer 8 heures maximum
Utiliser les paramètres recommandés spécifiés plus bas (par exemple : codage H264/AAC)
Ne pas modifier les paramètres pendant la diffusion

Les désagréments suivants sont à craindre si vous ne respectez pas ces contraintes :

Arrêt inattendu du streaming
Qualité médiocre pour les spectateurs
Comportement inattendu

Paramètres vidéo

Intervalle entre les images clés : 2 secondes recommandées. Ne dépassez pas 4 secondes.
Résolution et débit binaire :
1 080 p à 60 vps
Résolution : 1 920 × 1 080
Plage de débit vidéo : 4 500–9 000 Kbit/s
1 080 p à 30 vps
Résolution : 1 920 × 1 080
Plage de débit vidéo : 3 000–6 000 Kbit/s
720 p à 60 vps
Résolution : 1 280 × 720
Plage de débit vidéo : 2 250–6 000 Kbit/s
720 p à 30 vps
Résolution : 1 280 × 720
Plage de débit vidéo : 1 500–4 000 Kbit/s
480 p à 30 vps
Résolution : 854 × 480
Plage de débit vidéo : 600–2 000 Kbit/s
360 p
Résolution : 640 × 360
Plage de débit vidéo : 400–1 000 Kbit/s
Protocole : flux RTMPS
Format pixel : 16:9, dans l’idéal ; si vous vous éloignez trop de ce format, votre diffusion ne sera peut-être pas acceptée
Codec vidéo :
- H.264, niveau 4.1 pour aller jusqu’à 1 080 p/30 vps
- H.264, niveau 4.2 pour 1 080 p/60 vps

Paramètres audio

Codec audio : AAC à faible complexité
Fréquence d’échantillonnage : 44,1 kHz ou 48 kHz
Débit audio : 128 Kbit/s (recommandé) à 256 Kbit/s (maximal)
Mode de canal : stéréo

Points de terminaison

Vidéo en direct

Point de terminaison	Description
`DELETE /{live_video_id}`	Supprime une vidéo en direct.
`GET /{event-id}/live_videos`	Obtient une collection de vidéos en direct sur un évènement.
`GET /{group-id}/live_videos`	Obtient une collection de vidéos en direct sur un groupe.
`GET /{live-video-id}`	Obtient des champs et des arêtes sur une vidéo en direct.
`GET /{live-video-id}/comments`	Obtient une collection de commentaires sur une vidéo en direct.
`GET /{live-video-id}/crosspost_shared_pages`	Obtient une collection de pages pouvant partager une vidéo en direct.
`GET /{live-video-id}/likes`	Obtient une collection de profils ayant aimé une vidéo en direct.
`GET /{live-video-id}/polls`	Obtient une collection de sondages vidéo sur une vidéo en direct.
`GET /{live-video-id}/reactions`	Obtient une collection de profils ayant réagi à une vidéo en direct.
`GET /{page-id}/live_videos`	Obtient une collection de vidéos en direct sur une page.
`GET /{user-id}/live_videos`	Obtient une collection de vidéos en direct sur un utilisateur.
`POST /{event-id}/live_videos`	Crée une vidéo en direct sur un évènement.
`POST /{group-id}/live_videos`	Crée une vidéo en direct sur un groupe.
`POST /{live_video_id}`	Met à jour les champs sur une vidéo en direct.
`POST /{live_video_id}/input_streams`	Crée un streaming d’entrée vidéo en direct sur une vidéo en direct.
`POST /{live_video_id}/polls`	Crée un sondage vidéo sur une vidéo en direct.
`POST /{page-id}/live_videos`	Crée une vidéo en direct sur une page.
`POST /{user-id}/live_videos`	Crée une vidéo en direct sur un utilisateur.

Streaming d’entrée vidéo en direct

Point de terminaison	Description
`GET /{live-video-input-stream-id}`	Obtient des champs et des arêtes sur un streaming d’entrée vidéo en direct.
`POST /{live_video_id}/input_streams`	Crée un streaming d’entrée vidéo en direct sur une vidéo en direct.

Sondages

Point de terminaison	Description
`GET /{live-video-id}/polls`	Obtient une collection de sondages vidéo sur une vidéo en direct.
`GET /{video-poll-id}`	Obtient des champs et des arêtes sur un sondage vidéo.
`POST /{live_video_id}/polls`	Crée un sondage vidéo sur une vidéo en direct.
`POST /{video_poll_id}`	Met à jour les champs sur un sondage vidéo.

Codes d’erreur

Les messages d’erreur seront envoyés via RTMP et seront conservés dans l’API Graph. Vous pouvez utiliser l’ID de diffusion/de la vidéo et rechercher les erreurs dans l’outil Explorateur de graphique avec une requête GET. Les erreurs renvoyées incluront le code, la description et l’horodatage de l’erreur.

Sous-code de l’erreur	Résumé de l’erreur	Description
`COPYRIGHT__LIVE_COPYRIGHT_VIOLATION`	Violation des droits d’auteur dans la vidéo en direct	Votre vidéo en direct a été suspendue, car il est possible qu’elle contienne du contenu audio ou vidéo qui appartient à une autre page.
`VIDEO__CREATE_FAILED`	Problème d’importation	Un problème s’est produit et nous n’avons pas pu importer votre vidéo. Veuillez réessayer.
`LIVE_VIDEO__DELETE_FAILED`	Problème de suppression de la vidéo en direct	Un problème s’est produit et nous n’avons pas pu supprimer votre vidéo en direct. Veuillez réessayer.
`LIVE_VIDEO__EDIT_API_NOT_ALLOWED`	Modification depuis l’API Video non autorisée pendant la diffusion en direct	Il n’est pas possible de modifier une vidéo en direct depuis l’API Video. Utilisez l’ID de la vidéo en direct.
`LIVE_VIDEO__LIVE_STREAM_ERROR`	Problème de streaming général	Une erreur s’est produite pendant le streaming.
`LIVE_VIDEO__NOT_EXIST`	La vidéo en direct n’existe pas	La vidéo en direct à laquelle vous tentez d’accéder n’existe plus dans le système.
`LIVE_VIDEO__PRIVACY_REQUIRED`	Paramètres de confidentialité obligatoires	Vous devez définir les paramètres de confidentialité avant de lancer un direct.