Questo documento è stato aggiornato.
La traduzione in Italiano non è ancora completa.

Aggiornamento inglese: 23 dic 2019

API Embedded Video Player

Utilizzando l'API Embedded Video Player, puoi controllare lo strumento di riproduzione dei video incorporati e osservare gli eventi innescati dal giocatore. Ad esempio, puoi analizzare l'evento quando il video è in pausa o avviare la riproduzione del video mediante un pulsante personalizzato.

Per iniziare, segui le sezioni seguenti:

Configurazione
Controlli dello strumento di riproduzione
Ricevere gli aggiornamenti degli eventi
Riferimenti dei controlli dello strumento di riproduzione

Configurazione

1. Configurazione del plug-in

Consulta la documentazione dello strumento di riproduzione dei video incorporati per scoprire come configurare il plug-in.

2. Acquisizione dell'istanza dell'API Embedded Video Player

Per ottenere l'istanza dell'API Embedded Video Player, analizza xfbml.ready. Se il messaggio type è video, l'evento ready è stato attivato dallo strumento di riproduzione dei video incorporati.

var my_video_player;
FB.Event.subscribe('xfbml.ready', function(msg) {
  if (msg.type === 'video') {
    my_video_player = msg.instance;
  }
});

3. Esempio di codice completo

Nel codice d'esempio seguente, supponiamo che usi un ID app durante l'inizializzazione dell'SDK di Facebook per JavaScript. Se non disponi ancora di un ID app, consulta la documentazione per la creazione di un ID app.

Nel codice d'esempio seguente, sostituisci {your-app-id} con il tuo ID app e data-href con l'URL del video. Verifica di aver controllato l'evento xfbml.ready dopo aver chiamato la funzione FB.init().

<html>
<head>
  <title>Your Website Title</title>
</head>
<body>

  <!-- Load Facebook SDK for JavaScript -->
  <script>
    window.fbAsyncInit = function() {
      FB.init({
        appId      : '{your-app-id}',
        xfbml      : true,
        version    : 'v3.2'
      });
    
      // Get Embedded Video Player API Instance
      var my_video_player;
      FB.Event.subscribe('xfbml.ready', function(msg) {
        if (msg.type === 'video') {
          my_video_player = msg.instance;
        }
      });
    };
  </script>
  <div id="fb-root"></div>
  <script async defer src="https://connect.facebook.net/en_US/sdk.js"></script>

  <!-- Your embedded video player code -->
  <div  
    class="fb-video" 
    data-href="https://www.facebook.com/facebook/videos/10153231379946729/" 
    data-width="500" 
    data-allowfullscreen="true"></div>

</body>
</html>

Gestione di più strumenti di riproduzione

Se usi più strumenti di riproduzione nella stessa pagina, puoi individuarne uno aggiungendo un attributo id al relativo tag e controllandone l'id nell'oggetto msg:

<div id="my-video-player-id" ... />
<script>
FB.Event.subscribe('xfbml.ready', function(msg) {
  if (msg.type === 'video' && msg.id === 'my-video-player-id') {
     // True for <div id="my-video-player-id" ...
     my_video_player = msg.instance;
  }
});
</script>

Controlli dello strumento di riproduzione

Puoi chiamare un insieme di funzioni per controllare lo strumento di riproduzione dei video o per verificarne lo stato attuale, ad es. la posizione di riproduzione corrente.

Esempi d'uso

// Start video playback
my_video_player.play();

// Check whether video is muted
if (my_video_player.isMuted()) {
  // Video is muted
}

// Jump to second 5 of the video
my_video_player.seek(5);

Riferimenti dei controlli dello strumento di riproduzione

Registrazione delle azioni

La funzione subscribe() aggiunge una funzione di analisi per un dato evento, ad es. startedPlaying.

var myEventHandler = my_video_player.subscribe('startedPlaying', function(e) {
  // Video started playing ...
});

Rimozione della registrazione degli eventi

La funzione subscribe() restituisce un token contenente un metodo release che, se chiamato, rimuoverà nuovamente la funzione di analisi dall'evento.

myEventHandler.release('startedPlaying');

Riferimenti degli eventi

Riferimenti dei controlli dello strumento di riproduzione

Puoi chiamare un insieme di funzioni per controllare lo strumento di riproduzione dei video o per verificarne lo stato attuale, ad es. la posizione di riproduzione corrente.

Funzione	Descrizione	Argomenti (tipo)
`play()`	Riproduce il video.
`pause()`	Mette in pausa il video.
`seek(seconds)`	Cerca la posizione indicata.	`seconds` (`number`)
`mute()`	Disattiva l'audio del video.
`unmute()`	Riattiva l'audio del video.
`isMuted()`	`true` se l'audio del video è disattivato, altrimenti `false`.
`setVolume(volume)`	Imposta il volume sul numero specificato (`float`, scala da `0` a `1`).	`volume` (`float`)
`getVolume()`	Restituisce il volume corrente del video (`float`, scala da `0` a `1`).
`getCurrentPosition()`	Restituisce la posizione corrente del video espressa in secondi.
`getDuration()`	Restituisce la durata del video espressa in secondi.
`subscribe(event, eventCallback)`	Aggiunge una funzione di analisi per l'evento specificato. Per maggiori informazioni sulle azioni, consulta la sezione Registrazione delle azioni. Restituisce un token contenente un metodo `release` che, se chiamato, rimuoverà nuovamente la funzione di analisi dall'evento.	`event` (`string`), `eventCallback` (`function`)

Riferimenti degli eventi

Azione	Descrizione
`startedPlaying`	Attivata quando viene avviata la riproduzione del video.
`paused`	Attivata quando il video viene messo in pausa.
`finishedPlaying`	Attivata quando termina la riproduzione del video.
`startedBuffering`	Attivata all'avvio del buffering del video.
`finishedBuffering`	Attivata al termine del buffering del video.
`error`	Attivata quando si verifica un errore nel video.