Auf dieser Seite werden die verschiedenen Funktionen der YouTube Player API demonstriert. Eingebettete Player müssen einen Darstellungsbereich mit mindestens 200 x 200 Pixel haben. Wenn die Steuerung angezeigt wird, muss der Player groß genug sein, um die Steuerelemente vollständig anzuzeigen, ohne dass der Darstellungsbereich dabei die genannte Mindestgröße unterschreitet. Für 16:9-Player empfehlen wir eine Breite von mindestens 480 Pixel und eine Höhe von mindestens 270 Pixel.
Iframe-Einbettungscode

Inhalt Du kannst auswählen, ob geladene Inhalte vom Player direkt abgespielt werden oder nicht. Wenn du eine Option zum Laden von Inhalten auswählst und anschließend den Player aktualisierst, gibt der Player anstelle des Videos, das möglicherweise bereits abgespielt wird, den angegebenen Inhalt wieder.

Wenn du eine Option zum Verweis auf den Inhalt auswählst und anschließend den Player aktualisierst, wird das Video zwar im Player geladen, aber nicht automatisch abgespielt. Um das Video zu starten, musst du auf den Wiedergabe-Link klicken, der sich entweder im Abschnitt mit den Player-Steuerelementen oder direkt auf dem Videoplayer befindet.

Je nach Auswahl wird auf dieser Seite eine der folgenden API-Funktionen aufgerufen:
  • loadVideoById
  • loadVideoByUrl
  • loadPlaylist
  • cueVideoById
  • cueVideoByUrl
  • cuePlaylist

 
Steuerelemente Mit den Steuerelementen in diesem Abschnitt kannst du ein Video abspielen, pausieren oder beenden.

Wenn du nach einer bestimmten Stelle im Video suchen möchtest, kannst du eine Zahl in das Feld Springen zu eingeben. In diesem Feld wird der Zeitversatz in Sekunden angegeben, d. h. der Abstand vom Videobeginn zu der Stelle, wo die Wiedergabe beginnen sollte.
Wiedergeben | Pausieren | Beenden
   
Lautstärke Mit den Steuerelementen "Ton aus" und "Ton ein" wird der Ton deaktiviert bzw. aktiviert. Im Abschnitt Statistik wird im Feld Ton ein/aus angegeben, ob der Player stummgeschaltet ist.

Du kannst die Player-Lautstärke anpassen, indem du eine Zahl zwischen 0 und 100 in das Feld Wert eingibst. Tippe oder klicke auf eine Stelle außerhalb des Eingabefelds, damit die Lautstärke aktualisiert wird.
Ton aus | Ton ein | Wert:   (0-100) [ Aktueller Wert:  --]
Qualität Verwende dieses Drop-down-Menü, um die Funktion setPlaybackQuality() aufzurufen und die Wiedergabequalität für das aktuelle Video zu ändern. Wenn du die Qualität anpasst, wird das Video zunächst pausiert und anschließend von vorne neu gestartet.

Im Abschnitt Statistik erscheint im Feld Verfügbare Stufen eine Liste der Qualitätsstufen, die für dieses Video eingestellt werden können.

Wenn du eine nicht verfügbare Qualitätsstufe auswählst, verwendet YouTube automatisch die am besten geeignete Qualitätsstufe, die tatsächlich verfügbar ist. Beispiel: Wenn du die Qualitätsstufe niedrig ("small") auswählst, aber nur die Stufen mittel ("medium") und hoch ("large") unterstützt werden, wird automatisch die mittlere Qualitätsstufe festgelegt.
Geschwindigkeit Dieser Wert legt die Geschwindigkeit fest, mit der das Video abgespielt wird. Die Funktion getAvailablePlaybackRates() gibt die Wiedergabegeschwindigkeiten zurück, die für das aktuelle Video verfügbar sind. In dieser Demo werden die verfügbaren Geschwindigkeiten im Abschnitt Statistik angezeigt.

Der Wert 1 signalisiert, dass das Video mit normaler Geschwindigkeit abgespielt wird.
   
Größe In diesem Abschnitt kannst du die Funktion setSize(width, height) verwenden, um die Playergröße zu verändern. In der Regel ist diese Funktion ausschließlich in einer ActionScript-Anwendung sinnvoll. In einer JavaScript-Anwendung befindet sich der Player mit der modifizierten Größe weiterhin im gleichen Objekt; dies gilt auch, wenn dieses Objekt kleiner oder größer als der Player mit der modifizierten Größe ist.
 x 405   
Verlauf Auf dieser Seite werden die Funktionen getVideoUrl() und getEmbedCode() aufgerufen, wenn der Player bereit zur Videowiedergabe ist. Dieselben Funktionen werden erneut aufgerufen, wenn du ein Video lädst oder auf ein Video verweist.

Wenn du getVideoUrl() aufrufst, nachdem ein Video mindestens zehn Sekunden lang wiedergegeben wurde, wird die URL um einen Parameter erweitert, der einen Zeitpunkt für den Wiedergabestart angibt. 		(löschen)
Fehler
Noch keine Fehler.

Ereignisse und Funktionsaufrufe
Noch keine Fehler.

Player-Parameter
  • aktiviertes Kontrollkästchen = Parameterwert von 1
  • deaktiviertes Kontrollkästchen = Parameterwert von 0
  • Verwende den Iframe-Einbettungscode, um einen Player mit den ausgewählten Optionen einzubetten.

Parameter Wert
autoplay  1: Das Video wird automatisch gestartet, wenn der Player lädt.

0 (Standard): Das Video wird nicht automatisch gestartet, wenn der Player lädt.
cc_load_policy  1: Untertitel werden auch dann standardmäßig eingeblendet, wenn sie gemäß Nutzereinstellung deaktiviert sind. Das Standardverhalten richtet sich nach den Einstellungen des Nutzers.
color Dieser Parameter gibt die Farbe an, die im Fortschrittsbalken des Players verwendet wird, um den bereits wiedergegebenen Videoanteil zu markieren. Der Standardwert ist rot ("red").
controls  1 (Standard): Die Player-Steuerelemente werden auf dem Videoplayer angezeigt.

0: Die Player-Steuerelemente werden nicht auf dem Videoplayer angezeigt.
disablekb  1: Die Player-Tastatursteuerelemente werden deaktiviert.

0 (Standard): Die Player-Tastatursteuerelemente werden aktiviert. Die folgenden Tastatursteuerelemente können verwendet werden:
  • Leertaste: Wiedergeben/Pausieren
  • Pfeil nach links: im aktuellen Video ein paar Sekunden zurückspringen
  • Pfeil nach rechts: im aktuellen Video ein paar Sekunden nach vorn springen
  • Pfeil nach oben: Ton lauter
  • Pfeil nach unten: Ton leiser
enablejsapi  1: Die Iframe Player API wird aktiviert, damit du sie verwenden kannst, um den Player zu steuern.

0 (Standard): Die API wird nicht aktiviert.
end  Der Moment, wo die Videowiedergabe gestoppt werden sollte. Bei diesem Wert handelt es sich um eine positive ganze Zahl, die den Zeitpunkt in Sekunden angibt, wo die Videowiedergabe durch den Player gestoppt werden soll.
fs  1 (Standard): Auf dem Player wird eine Schaltfläche für den Vollbildmodus angezeigt.

0: Die Schaltfläche erscheint nicht auf dem Player.
hl  Legt die Spracheinstellung für die Player-Benutzeroberfläche fest. Bei diesem Parameterwert handelt es sich um einen ISO 639-1-Code mit zwei Buchstaben oder ein vollständig angegebenes Gebietsschema wie fr oder fr-ca. Andere Codes für die Spracheinstellung, wie IETF-Sprach-Tags (BCP 47), können ebenfalls korrekt verarbeitet werden.

Die Spracheinstellung der Benutzeroberfläche wird für Tooltipps im Player verwendet und wirkt sich zudem auf die standardmäßigen Untertitel aus.
iv_load_policy 1 (Standard): Videoanmerkungen werden angezeigt. 3: Videoanmerkungen werden nicht angezeigt.
list  Dieser Parameter identifiziert – in Verbindung mit dem Parameter list – die Inhalte, die im Player geladen werden.
  • playlist:Der Parameter list gibt eine YouTube-Playlist-ID an. Stelle sicher, dass der Parameterwert mit den Buchstaben PL beginnt.
  • search: Der Parameter list gibt den Suchbegriff an, der verwendet werden soll, um Inhalte für die Wiedergabe auszuwählen.
  • user_uploads: Der Parameter list gibt den YouTube-Kanal an, dessen Videos geladen werden sollen.
listType Dieser Parameter identifiziert – in Verbindung mit dem Parameter list – die Inhalte, die im Player geladen werden.
  • search: Der Parameter list gibt den Suchbegriff an, der verwendet werden soll, um Inhalte für die Wiedergabe auszuwählen.
  • user_uploads: Der Parameter list gibt den YouTube-Kanal an, dessen Videos geladen werden sollen.
  • playlist: Der Parameter list gibt eine YouTube-Playlist-ID an. Stelle sicher, dass der Parameterwert mit den Buchstaben PL beginnt.
loop  1: Wenn der Player ein einzelnes Video lädt, wird das Video nach abgeschlossener Wiedergabe automatisch immer wieder von vorn abgespielt. Wenn der Player eine Playlist lädt, wird die gesamte Playlist vollständig wiedergegeben. Anschließend beginnt die Wiedergabe automatisch wieder mit dem ersten Video.

0 (Standard): Videos und Playlists werden nicht in einer automatischen Endlosschleife wiedergegeben.
modestbranding  1: Das YouTube-Logo wird nicht in der Steuerleiste angezeigt. Es erscheint allerdings ein Textlabel oder Wasserzeichen von YouTube, wenn der Nutzer mit der Maus auf den Player zeigt.

0: In der Steuerleiste des Players wird ein YouTube-Logo angezeigt.
playlist  Eine durch Kommas getrennte Liste mit Video-IDs, die nacheinander wiedergegeben werden.
playsinline  1: Veranlasst eine Inline-Wiedergabe für das UIWebViews-Element, bei dessen Erstellung die allowsInlineMediaPlayback-Eigenschaft auf TRUE gesetzt wurde.

0 (Standard): Veranlasst die Wiedergabe im Vollbildmodus. Der Standardwert kann geändert werden.
start  Der Moment, wo die Videowiedergabe beginnen sollte. Bei diesem Wert handelt es sich um eine positive ganze Zahl, die den Zeitpunkt in Sekunden angibt, wo die Videowiedergabe durch den Player beginnen soll. Der Player sucht nach einem Keyframe, der so dicht wie möglich an der festgelegten Zeit liegt (davor oder danach).
Statistik   Die Informationen in diesem Abschnitt beschreiben den Status des Videoplayers und des wiedergegebenen Videos bzw. des Videos, das zuletzt wiedergegeben werden soll. In der folgenden Liste wird die mit jedem einzelnen Feld in diesem Abschnitt verknüpfte API-Funktion aufgeführt:
  • Dauer: getDuration()
  • Aktuelle Zeit: getCurrentTime()
  • Player-Status: getPlayerState()
  • Geladener Videoanteil in %: getVideoLoadedFraction()
  • Start-Bytes: getVideoStartBytes()
  • Qualitätsstufe: getPlaybackQuality()
  • Verfügbare Stufen: getAvailableQualityLevels()
  • Ton (ein/aus): isMuted()
  • Anzahl von Videos in der Playlist: count(getPlaylist())
  • Position des aktuellen Videos: getPlaylistIndex()
  • Videos in der Playlist: getPlaylist()
  • Geladene Bytes: getVideoBytesLoaded() (veraltet)
  • Bytes insgesamt: getVideoBytesTotal() (veraltet)
Dauer: --:--
Aktuelle Zeit: --:--
Player-Status: --
Start-Bytes: --
Geladener Videoanteil in %: --
Ton (ein/aus):
Wiedergabegeschwindigkeit: --
Verfügbare Geschwindigkeiten:
Veraltet
Geladene Bytes: --
Bytes insgesamt: --