Pour plus d’informations sur l’API Live Video, consultez notre documentation sur Live Video.
Vous pouvez envoyer une demande POST à l’arête live_videos
à partir des chemins suivants :
/{group-id}/live_videos
Une publication sur cette arête crée une vidéo en direct.
Nom | Description |
---|---|
app_attribution_tag chaîne numérique ou nombre entier | Tag d’attribution pour les vidéos en direct qui seront diffusées sur le fil. |
attribution_app_id chaîne numérique ou nombre entier | ID de l’application d’attribution. |
content_tags liste<chaîne numérique> | Tags qui décrivent le contenu de la vidéo. Utilisez le point de terminaison search avec /search?type=adinterest&q=sunsets |
description chaîne UTF-8 | Description de la vidéo en direct. Emojis acceptés. |
encoding_settings chaîne |
Identifiant du groupe de paramètres d’encodage utilisé par le diffuseur pour ce stream. Actuellement, ce paramètre est uniquement utilisé pour la diffusion de vidéos 360 en direct. La valeur à transmettre à ce paramètre est la valeur de la clé |
event_params nombre entier | Horodatage Unix de la date à laquelle le diffuseur prévoit de passer en direct. |
fisheye_video_cropped Booléen | Indique si la vidéo au format fisheye simple est rognée. |
front_z_rotation nombre à virgule | Rotation avant sur l’axe Z en degrés sur la vidéo au format fisheye simple. |
game_id chaîne numérique ou nombre entier | Indiquez le jeu sur lequel porte cette vidéo. Utilisez le point de terminaison search avec /search?type=game&=pubg |
game_specs Paramètres des caractéristiques du jeu | Définissez les métadonnées d’attribution du jeu. |
is_spherical Booléen | Indicateur de diffusion d’une vidéo 360 en direct. |
live_encoders liste<chaîne numérique ou entier> | Encodeurs qui diffuseront vers cette vidéo en direct. |
original_fov nombre entier signé 64 bits | Champ de vision original de la caméra. |
post_surfaces_blacklist liste<énumération{1, 2, 3, 4, 5}> | Liste noire des endroits où la publication n’apparaîtra pas, pour tester le flux uniquement. |
privacy Paramètre de confidentialité | Confidentialité de cette vidéo en direct. |
projection énumération{EQUIRECTANGULAR, CUBEMAP} | Indicateur de la projection prévue de streams de vidéos 360 en direct. La valeur par défaut est EQUIRECTANGULAR. |
save_vod Booléen | Indique si les données vidéo doivent être enregistrées pour une consommation ultérieure au format VOD. Par défaut : true. (Remarque : ce paramètre ne peut être défini qu’au moment de la création.) |
schedule_custom_profile_image image | Image personnalisée qui apparaîtra dans la story en direct programmée et dans le lobby. |
spatial_audio_format énumération{ambiX_4} | Spécifie le format du stream audio spatial. Lorsque l’audio n’est pas spécifié, le format supposé est mono ou stéréo. |
status énumération{UNPUBLISHED, LIVE_NOW, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_CANCELED} | Statut de la diffusion. Une diffusion |
stereoscopic_mode énumération{MONO, LEFT_RIGHT, TOP_BOTTOM} | Définissez cet indicateur sur le mode stéréoscopique pour cette vidéo. |
stop_on_delete_stream | Définissez ce paramètre sur |
title chaîne UTF-8 | Titre de la vidéo en direct. Emojis acceptés. |
Ce point de terminaison prend en charge la lecture après écriture et lira le nœud représenté par id
dans le type de retour.
Structure { id : chaîne numérique, stream_url : chaîne, secure_stream_url : chaîne, stream_secondary_urls : Liste [ chaîne ], secure_stream_secondary_urls : Liste [ chaîne ], dash_ingest_url: chaîne, }
Erreur | Description |
---|---|
100 | Paramètre non valide |
200 | Erreur d’autorisation |
Nom | Description |
---|---|
API Groups | Cette fonctionnalité nécessite le Contrôle app. |
GET /v7.0/{group-id}/live_videos HTTP/1.1
Host: graph.facebook.com
Consultez notre Guide d’utilisation de l’API Graph pour en savoir plus.
Nom | Description |
---|---|
broadcast_status liste<énumération{UNPUBLISHED, LIVE, LIVE_STOPPED, PROCESSING, VOD, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_EXPIRED, SCHEDULED_CANCELED}> | Permet de spécifier le type de retour des vidéos en direct. Si aucune valeur n’est spécifiée, il renvoie tous les types de statuts. |
source énumération{target, owner} | Valeur par défaut : Source pour la demande des vidéos. Par exemple, |
La lecture à partir de cette arête renverra un résultat au format JSON :
{ "data": [], "paging": {} }
data
Liste des champs LiveVideo.
paging
Pour plus d’informations sur la pagination, consultez le guide de l’API Graph.
Erreur | Description |
---|---|
200 | Erreur d’autorisation |
Vous ne pouvez pas effectuer cette opération sur ce point de terminaison.
Vous ne pouvez pas effectuer cette opération sur ce point de terminaison.