Assistance

Un logiciel de streaming, ou logiciel d’encodage RTMP, collecte votre URL de streaming et la clé RTMP et les envoie à Facebook. Nous ne fournissons aucun logiciel de streaming. Vous pouvez utiliser OBS (Open Broadcasting Software) ou Player.me, disponibles en version gratuite, pour streamer vos vidéos en direct.

Absolument ! Consultez notre liste de partenaires de solutions médias.

Vous pouvez immédiatement commencer à utiliser l’API Live. Néanmoins, si vous cherchez à créer entièrement une diffusion de qualité avec plusieurs caméras et éléments graphiques, la mise en place peut durer 1 à 2 semaines au minimum, en fonction du contrôle app.

Il faut environ 4 à 5 secondes à partir du moment où vous lancez un direct pour que votre vidéo s’affiche sur Facebook. Vous saurez que la diffusion est en cours lorsque la vidéo apparaîtra sur votre page de test (ou votre page publique).

Si vous rencontrez des problèmes avec vos diffusions en direct, veuillez consulter notre guide de dépannage des vidéos en direct. Nous vous recommandons également de consulter notre guide des caractéristiques pour vous assurer que vos paramètres sont optimaux pour vos diffusions en direct. Si vous pensez avoir découvert un bug, vous pouvez nous en faire part directement depuis notre outil de bugs, et un ingénieur reviendra vers vous.

Oui, c’est possible ! La deuxième diffusion déclenchera probablement moins de notifications que la première. Pour savoir comment les notifications de direct fonctionnent, veuillez consulter notre documentation.

Pas obligatoirement. Il existe des encodeurs et des API qui permettent de streamer sur deux pages différentes ou plus, comme Wowza et Streamshark. Même s’il est possible de streamer sur plusieurs pages avec un encodeur, nous vous recommandons plutôt de streamer sur une seule page et de partager le streaming sur d’autres pages afin que les commentaires, les réactions et le nombre de spectateurs soient regroupés.

Le format par défaut est 16x9, bien que nous identifions le format à partir du streaming. Pour plus d’informations sur les caractéristiques techniques, veuillez consulter notre guide sur les caractéristiques, le contenu de marque et les droits d’auteur.

Vous pouvez intégrer des vidéos en direct en utilisant le paramètre embeddable via l’API Live Video.

Envoyez une demande POST /{live_video_id} et définissez le paramètre embeddable sur true. Utilisez un token d’accès Page ou Utilisateur avec les mêmes autorisations que celles requises pour créer une vidéo en direct.

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

GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/{your-live-video-id}",
  new JSONObject("{}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{your-live-video-id}"
           parameters:@{ @"embeddable": @"true",}
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{your-live-video-id}',
  'POST',
  {"embeddable":"true"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->post(
    '/{your-live-video-id}',
    array (
      'embeddable' => 'true'
    ),
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Pour obtenir le code HTML intégré, envoyez une demande GET /{live_video_id}?fields=embed_html. Utilisez un token d’accès Page ou Utilisateur avec les mêmes autorisations que celles requises pour créer une vidéo en direct.

curl -i -X GET \
 "https://graph.facebook.com/{your-live_video_id}
   ?fields=embed_html
   &access_token={your-access-token}"

GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/{your-live_video_id}",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "embed_html");
request.setParameters(parameters);
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{your-live_video_id}"
           parameters:@{ @"fields": @"embed_html",}
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{your-live_video_id}',
  'GET',
  {"fields":"embed_html"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/{your-live_video_id}',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Exemple de réponse

{ "embed_html": "<iframe src=\"https://www.facebook.com/plugins/video.php?href=https%3A%2F%2Fwww.facebook.com%2Fyourpage%2Fvideos%2F{your-page-id}%2F&width=0\" width=\"0\" height=\"0\" style=\"border:none;overflow:hidden\" scrolling=\"no\" frameborder=\"0\" allowTransparency=\"true\" allowFullScreen=\"true\"></iframe>", "id": "{your-live-video-id}" } 

Non, c’est normal. Il n’est pour l’instant pas possible de regarder des vidéos en direct sur le web mobile avant qu’elles ne deviennent des VOD (vidéos à la demande). Toutefois, si vous souhaitez regarder une vidéo en direct qui a été intégrée à un autre site sur le web mobile, vous serez redirigé vers l’app Facebook pour la visionner.

Votre vidéo peut disparaître pour plusieurs raisons. Voici quelques-unes des causes les plus fréquentes :

1. Si vous avez mis une musique en fond sonore, votre vidéo en direct a peut-être été supprimée pour violation des droits d’auteur. Cela peut se produire pendant la diffusion de la vidéo en direct ou après, lorsque la vidéo est rejouée.
2. Vous, ou un autre auteur de votre page, pouvez avoir supprimé la vidéo en direct. Si quelqu’un a supprimé la vidéo en direct manuellement, il n’est pas possible de la récupérer.
3. Votre vidéo a été automatiquement signalée pour violation de la propriété intellectuelle. Si cela se produit, Facebook vous envoie un e-mail avec un lien qui vous permet de vérifier la raison de la suppression et de soumettre à nouveau la vidéo afin qu’elle soit examinée par notre équipe chargée de la politique.

Cela se produit lorsque la diffusion ne traite pas le signal de fin de la vidéo en direct et ne s’arrête pas. Assurez-vous d’avoir envoyé une requête POST avec le paramètre end_live_video. Si ce problème se reproduit, veuillez remplir un rapport de bug dans notre outil de bugs en indiquant l’ID de la vidéo.

Consultez notre liste des codes d’erreur pour mieux comprendre le problème.

Le son peut être déformé lorsque Facebook reçoit un stream vidéo avec du son déformé ou après que nous avons reçu les images, mais avant que nous ne les réencodions pour la diffusion. Ce type d’erreur peut se produire si le débit vidéo utilisé est plus élevé que ce que la connexion entre votre point de terminaison de diffusion et les serveurs Facebook peut supporter. Si cela se produit ou si un paquet est perdu, une partie de la piste vidéo ou audio ne sera pas correctement reçue, entraînant ainsi une déformation du son.

Les problèmes de synchronisation du son et la vidéo peuvent se produire lorsqu’une vidéo en direct est diffusée auprès du client avec une bande passante limitée, ou que le client ne dispose pas de la bande passante nécessaire pour la visionner en direct. De plus, si le streaming reçu par le serveur Facebook n’est pas synchronisé, la vidéo en direct ne sera pas non plus synchronisée. Assurez-vous de vérifier le matériel d’enregistrement et d’encodage afin d’identifier les éventuels problèmes qui pourraient causer une désynchronisation entre le son et la vidéo.

L’API Live Video nécessite du contenu audio. Si vous essayez de streamer du contenu vidéo uniquement, le streaming prend fin.

Votre diffusion en direct peut s’interrompre en raison d’un problème d’encodage ou d’une mauvaise connectivité au réseau. Si cela se produit, vous avez 2 à 3 minutes pour reconnecter l’URL de streaming d’origine que vous avez généré pour votre publication en direct. Sinon, vous devrez générer une nouvelle clé de streaming et une nouvelle URL de streaming pour poursuivre la diffusion en direct.

Oui, vous pouvez limiter l’audience de vos vidéos en fonction de l’endroit où elle se situe. Pour en savoir plus sur le champ targeting des vidéos en direct, veuillez consulter notre guide avancé sur le ciblage d’audience.

Oui, c’est possible ! Pour en savoir plus sur le champ targeting des vidéos en direct, veuillez consulter notre guide avancé sur le ciblage d’audience.

Oui, les vidéos qui ont été supprimées pour violation des droits d’auteur peuvent être restaurées. Vous recevrez une notification qui vous permettra de restaurer votre vidéo. Néanmoins, si vous ne restaurez pas votre vidéo au moment où vous recevez la notification, il ne sera plus possible de la restaurer par la suite.

Il n’est malheureusement pas encore possible de booster les vidéos en direct.

Actuellement, il n’existe pas de point de terminaison permettant de créer des sous-titres. Néanmoins, vous pouvez ajouter des sous-titres une fois la diffusion de la vidéo en direct terminée, ou vous pouvez ajouter des sous-titres à votre stream vidéo en direct pendant le streaming sur nos serveurs en utilisant le format CEA-608.

Pour ajouter des sous-titres à une vidéo en direct terminée (avec le statut « VOD »), veuillez consulter notre page d’aide Comment ajouter des sous-titres à une vidéo sur ma page ?. Pour ajouter des sous-titres en utilisant le format CEA-608, veuillez consulter notre guide sur les sous-titres.

Intégrer des publicités tierces aux diffusions en direct est contraire à la politique relative aux vidéos en direct de Facebook. Vous ne devez par exemple pas intégrer de bumpers, de pre-rolls, de mid-rolls ni de post-rolls.

Nous encourageons toutes les diffusions en direct à ne proposer que du contenu en direct afin de préserver l’intégrité de l’expérience du spectateur. Néanmoins, il peut être pertinent, dans certains cas uniques, d’intégrer une vidéo préenregistrée à une vidéo en direct, de la même manière qu’un journal TV en direct peut montrer du contenu préenregistré. Veuillez consulter notre guide sur les caractéristiques, le contenu de marque et les droits d’auteur.

Oui, vous pouvez crossposter les vidéos en direct. Consultez notre documentation Importation avec les vidéos crosspostées et les Pages d’aide, Comment crossposter la vidéo d’une autre page ?. Les commentaires et les réactions ne s’affichent que sur la page originale.

Pour apparaître sur Live Map, vous devez définir le lieu de votre vidéo en utilisant le paramètre place dans une demande POST /{live_video_id}.

Pour réinitialiser une clé de diffusion persistante, rendez-vous sur www.facebook.com/live/create, cliquez sur Créer un stream en direct, cochez la case Utiliser une clé de diffusion persistante, puis cliquez sur le bouton Réinitialiser.