In questa pagina vengono descritte le funzioni della YouTube Player API. Per i player incorporati, la visualizzazione deve essere di almeno 200 px per 200 px. Nel caso in cui siano presenti i controlli, il player dovrà avere dimensioni tali da mostrare i controlli senza ridurre la visualizzazione al di sotto del valore minimo. I player in formato 16:9 devono avere una larghezza minima di 480 pixel e un'altezza minima di 270 pixel.

Codice di incorporamento IFrame

Contenuti Puoi scegliere se caricare o mettere in coda i contenuti nel player. Se selezioni un'opzione per caricare i contenuti ed eseguire successivamente l'aggiornamento del player, quest'ultimo riprodurrà il contenuto specificato piuttosto che l'eventuale video già in riproduzione.

Se selezioni un'opzione per mettere in coda i contenuti ed eseguire successivamente l'aggiornamento, il video verrà caricato ma non sarà riprodotto dal player. Per riprodurre il video, fai clic sul link Riproduci nella sezione dei controlli del player o sul video player stesso.

In base alla selezione effettuata, la pagina chiama una delle funzioni API seguenti:
  • loadVideoById
  • loadVideoByUrl
  • loadPlaylist
  • cueVideoById
  • cueVideoByUrl
  • cuePlaylist
 
 
Controlli I controlli in questa sezione consentono di riprodurre, mettere in pausa o interrompere un video.

Per cercare un punto specifico nel video, inserisci un numero nel campo Vai a; questo campo permette di specificare il punto di corrispondenza in secondi dall'inizio del video dopo i quali deve essere avviata la riproduzione.
   
Volume I controlli Attiva audio e Disattiva audio consentono di abilitare o disabilitare il volume dell'audio. Il campo Volume on/off nella sezione Statistiche indica se l'audio del player è disattivato.

Puoi regolare il volume del player specificando un numero da 0 a 100 nel campo Imposta volume. Per modificare il volume, premi il tasto Tab o fai clic fuori dalla casella di immissione.
Disattiva audio | Riattiva audio
Imposta:   (0-100) [ livello attuale:  --]
Qualità Usa questo elenco a discesa per chiamare la funzione setPlaybackQuality() e modificare la qualità del video in riproduzione. Quando apporti tale modifica, il video viene messo in pausa e la riproduzione riprende poi dall'inizio.

Nel campo Livelli disponibili della sezione Statistiche vengono elencati i livelli di qualità disponibili per il video.

Se selezioni un livello di qualità non disponibile, YouTube selezionerà il livello più appropriato tra quelli disponibili. Ad esempio, se imposti il livello di qualità su basso, ma i livelli supportati sono medio e alto, YouTube imposterà il livello su medio.
Velocità La velocità di riproduzione identifica la velocità con cui il video viene riprodotto. La funzione getAvailablePlaybackRates() restituisce l'insieme delle velocità di riproduzione a cui il video è disponibile. In questa demo, le velocità di riproduzione disponibili vengono mostrate nella sezione Statistiche.

Il valore 1 indica che la riproduzione del video viene eseguita alla velocità normale.
   
Dimensioni In questa sezione puoi modificare le dimensioni del player mediante la funzione setSize(width, height). In genere, questa funzione è utile solo in un'applicazione ActionScript. In un'applicazione JavaScript il player ridimensionato è ancora incluso nell'oggetto che contiene il video player, anche se tale oggetto è più piccolo o più grande del player ridimensionato.
 x 405   
Cronologia Questa pagina chiama le funzioni getVideoUrl() e getEmbedCode() quando il player è pronto per riprodurre un video. Queste funzioni vengono nuovamente chiamate se carichi o metti in coda un video.

Se chiami getVideoUrl() dopo che un video è stato riprodotto per almeno 10 secondi, nell'URL verrà incluso un parametro che specifica il punto di corrispondenza in cui il player deve iniziare la riproduzione del video.
(cancella)
Errori
Ancora nessuno.

Eventi e chiamate di funzioni
Ancora nessuno.

Parametri del player
  • casella attivata = valore del parametro 1
  • casella disattivata = valore del parametro 0
  • Usa il codice di incorporamento Iframe per incorporare un player con le opzioni selezionate.

Parametro Valore
autoplay  1 - La riproduzione del video viene avviata automaticamente al caricamento del player.

0 (predefinito) - La riproduzione del video non viene eseguita automaticamente al caricamento del player.
cc_load_policy  1 - I sottotitoli vengono visualizzati per impostazione predefinita anche se l'utente li ha disattivati. Il comportamento predefinito si basa sulla preferenza dell'utente.
color Questo parametro consente di specificare il colore utilizzato nella barra di avanzamento video del player per mostrare la porzione di video già visualizzata dallo spettatore. Il valore predefinito è rosso.
controls  1 (predefinito) - Vengono visualizzati i controlli disponibili nel video player.

0 - I controlli non vengono visualizzati nel video player.
disablekb  1 - Vengono disattivati i comandi da tastiera.

0 (predefinito) - Vengono attivati i comandi da tastiera. I comandi sono i seguenti:
  • Barra spaziatrice: Play/Pausa
  • Freccia a sinistra: consente di tornare indietro nel video di alcuni secondi.
  • Freccia a destra: consente di andare avanti nel video di alcuni secondi.
  • Freccia in alto: consente di alzare il volume.
  • Freccia in basso: consente di abbassare il volume.
enablejsapi  1 - Viene attivato il controllo del player tramite l'IFrame Player API.

0 (predefinito) - L'API non viene attivata.
end  Il punto di corrispondenza in cui termina la riproduzione del video. Il valore corrisponde a un numero intero positivo che specifica il numero di secondi nel video in cui la riproduzione nel player viene interrotta.
fs  1 (predefinito) - Nel player viene mostrato un pulsante per la visualizzazione a schermo intero.

0 - Il pulsante non viene visualizzato nel player.
hl  Consente di impostare la lingua di interfaccia del player. Il valore del parametro corrisponde a un codice lingua a due lettere ISO 639-1 o a impostazioni internazionali complete, ad esempio fr o fr-ca. Possono essere usati anche altri codici di immissione per le lingue, come i tag di lingua IETF (BCP 47).

Oltre a essere utilizzata per le descrizioni dei comandi, la lingua di interfaccia influisce anche sulla traccia predefinita dei sottotitoli.
iv_load_policy 1 (predefinito) - Vengono visualizzate le annotazioni del video. 3 - Le annotazioni del video non vengono visualizzate.
list  Insieme al parametro list, questo parametro identifica i contenuti caricati nel player.
  • playlist - Il parametro list specifica l'ID playlist YouTube. Assicurati che il valore del parametro inizi con le lettere PL.
  • ricerca - Il parametro list specifica il termine della query di ricerca utilizzato per selezionare i contenuti da riprodurre.
  • caricamenti_utente - Il parametro list specifica il canale YouTube di cui vengono caricati i video.
listType Insieme al parametro list, questo parametro identifica i contenuti caricati nel player.
  • ricerca - Il parametro list specifica il termine della query di ricerca utilizzato per selezionare il contenuto da riprodurre.
  • caricamenti_utente - Il parametro list specifica il canale YouTube di cui vengono caricati i video.
  • playlist - Il parametro list specifica l'ID playlist YouTube. Assicurati che il valore del parametro inizi con le lettere PL.
loop  1 - Se il player sta caricando un unico video, il video verrà continuamente riprodotto. Se il player sta caricando una playlist, la playlist verrà riprodotta interamente e poi riprenderà dal primo video.

0 (predefinito) - La riproduzione del video o dell'intera playlist non avviene in maniera continuativa.
modestbranding  1 - Il logo YouTube non viene visualizzato nella barra di controllo. Viene comunque visualizzata una filigrana o un'etichetta di testo YouTube quando il puntatore del mouse dell'utente passa sul player.

0 - Il logo YouTube viene visualizzato nella barra di controllo del player.
playlist  Un elenco di ID video separati da virgola che vengono riprodotti in successione.
playsinline  1 - Determina la riproduzione incorporata per UIWebViews creata con la proprietà allowsInlineMediaPlayback impostata su TRUE.

0 (predefinito) - La riproduzione viene effettuata a schermo intero. Tieni presente che il valore predefinito può essere diverso.
start  Il punto di corrispondenza in cui è previsto l'inizio della riproduzione. Il valore è un numero intero positivo che specifica i secondi nel video in cui deve iniziare la riproduzione nel player. Il player effettua la ricerca del fotogramma chiave che più si avvicina o che precede il punto specificato.
Statistiche   Le informazioni in questa sezione descrivono lo stato del video player e del video in riproduzione (o dell'ultimo video da riprodurre). Nell'elenco seguente viene indicata la funzione API associata a ogni campo nella sezione:
  • Durata: getDuration()
  • Ora attuale: getCurrentTime()
  • Stato del player: getPlayerState()
  • Percentuale di video caricato: getVideoLoadedFraction()
  • Byte inizio: getVideoStartBytes()
  • Livello di qualità: getPlaybackQuality()
  • Livelli disponibili: getAvailableQualityLevels()
  • Volume (on/off): isMuted()
  • Numero di video nella playlist: count(getPlaylist())
  • Posizione del video attuale: getPlaylistIndex()
  • Video nella playlist: getPlaylist()
  • Byte caricati: getVideoBytesLoaded() (obsoleto)
  • Byte totali: getVideoBytesTotal() (obsoleto)

Durata: --:--
Ora attuale: --:--
Stato del player: --
Byte inizio: --
% di video caricato: --
Volume (on/off):
Velocità di riproduzione: --
Velocità disponibili:
Obsoleto
Byte caricati: --
Byte totali: --