Zusätzlich zur Anpassung der Einbettungseinstellungen deines Videos vor Ort kannst du dem Vimeo-Player Funktionen hinzufügen, indem du verschiedene URL-Parameter am Ende der Player-URL in deinen Einbettungscode hinzufügst.
URL-Parameter beginnen mit einem Fragezeichen (?), Zum Beispiel:
<iframe src="https://player.vimeo.com/video/76979871?embedparameter=value" width="640" height="360" frameborder="0" allowfullscreen></iframe>
URL-Parameter gelten nur für den spezifischen Einbettungscode, in dem der Parameter hinzugefügt wird.
In diesem Artikel:
- Unterstützte Player-Parameter
- Mehrere Einbettungsparameter verwenden
- Einbettungsparameter auf eine Vimeo.com-URL anwenden
Unterstützte Player-Parameter
Eine Zusammenfassung der unterstützten Player-Parameter findest du in der folgenden Tabelle.
Parameter | Unterstützte Werte | Default Werte | Beschreibung | Unterstützte Videos |
---|---|---|---|---|
autopause |
true , false oder 1,0 |
true |
Der Vimeo-Player ist so konzipiert, dass er nur jeweils ein Vimeo-Video abspielt. Daher musst du diesen Parameter zu jedem Video hinzufügen, wenn du mehr als ein Vimeo-Video auf derselben Seite abspielen möchtest. ⚠️ Warnungen: - Das automatische Pausieren wird in Internet Explorer nicht unterstützt. - Damit das automatische Pausieren funktioniert, musst du die Cookies in deinem Browser aktivieren. |
Alle Videos |
autoplay |
true , false oder 1,0 |
false |
Startet automatisch die Wiedergabe des Videos. ⚠️ WarnungAutomatische Wiedergabe wird eventuell in einigen Umgebungen wie IOS, Chrome 66+ und Safari 11+ gesperrt. In solchen Fällen kehren wir zur Standardwiedergabe zurück, bei der die Zuschauer die Wiedergabe starten müssen. |
Alle Videos |
background |
true , false oder 1,0 |
false |
Die Hinzufügung dieses Parameters hat die folgenden Auswirkungen:
Wenn du möchtest, dass dein Video nicht in einer Schleife oder automatisch abgespielt wird, sieh dir den Parameter controls=0 unten an. Beachte, dass durch die Einstellung dieses Parameters die Tastatursteuerung nicht deaktiviert wird. |
Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
byline |
true , false oder 1,0 |
Der Wert wird |
Zeige den Autor des Videos an (Quellenangabe). |
Alle Videos (aber nur, wenn der Videobesitzer es erlaubt) |
color |
[hex code] |
Vimeo blue- |
Legen Sie die Farbe der Videosteuerung fest. |
Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
Farben
|
1-4 [Hex-Codes] - durch Komma getrennt. (Example: colors=000000,00adef, ffffff,000000) |
Farbe 1- Primär: #000000 |
Legen Sie die Farben des Players fest. Die Farben können durch die Einbettungseinstellungen des Videos außer Kraft gesetzt werden. |
Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
Steuerungen |
true , false oder 1,0 |
true |
Mit diesem Parameter werden alle Elemente im Player (Wiedergabeleiste, Teilen-Buttons usw.) ausgeblendet, um ein Erlebnis ohne Chrome-Elemente zu ermöglichen.
⚠️ Warnungen: Bei Verwendung dieses Parameters wird der Button „Wiedergabe/Pause“ ausgeblendet. Um die Wiedergabe für deine Zuschauer zu starten, musst du entweder die automatische Wiedergabe aktivieren, Tastatursteuerungen verwenden oder unser Player-SDK zum Starten und Steuern der Wiedergabe implementieren. Beachte, dass durch die Einstellung dieses Parameters die Tastatursteuerung nicht deaktiviert wird. |
Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
dnt |
true , false oder 1,0 |
false |
Wenn Sie diesen Parameter auf "true" setzen, wird der Player von der Verfolgung von Sitzungsdaten und Analysen ausgeschlossen. (Dies hat die gleiche Wirkung wie die Aktivierung einer "Do Not Track" -Einstellung in Ihrem Browser). ⚠️ Warnungen: Wenn DNT aktiviert ist, setzt Vimeo ein wichtiges Cookie über den einbettbaren Player ein:
|
Alle Videos |
keyboard |
true, false |
true |
Ermöglicht Tastatureingaben zum Auslösen von Spielerereignissen. Wenn false, ignoriert der Spieler die Tastatureingabe. Tabulatoren werden in beiden Modi weiterhin unterstützt. |
Alle Videos |
loop |
true , false oder 1,0 |
false |
Spiele das Video ohne zu stoppen jedes Mal von vorne, wenn das Ende erreicht ist. Hinweis: DieSchleife kann auch als Endbildschirm für ein Video auf der Seite mit den Einbettungseinstellungen ausgewählt werden. Erfahren Sie hiermehr. |
Alle Videos |
muted |
true , false oder 1,0 |
false |
Stelle das Video beim Laden auf stumm. Zuschauer können weiterhin die Lautstärkeeinstellungen im Player anpassen. Kann verwendet werden, um Hintergrundvideos stummzuschalten oder die Einschränkungen der automatischen Wiedergabe in bestimmten Browsern wie Chrome und Safari zu umgehen. |
Alle Videos |
pip
|
true , false oder 1,0 |
false |
Zeige den Bild-im-Bild-Button in der Steuerleiste an und aktiviere die Bild-im-Bild-API. |
Alle Videos |
playsinline |
true , false oder 1,0 |
true |
Spiele Videos inline auf mobilen Geräten ab, anstatt automatisch in den Vollbildmodus zu wechseln. Die Inline-Wiedergabe ist standardmäßig für alle Videos aktiviert. |
Alle Videos |
portrait |
true , false oder 1,0 |
Der Wert wird |
Das Profilbild des Autors anzeigen (Portrait) |
Alle Videos (Vorausgesetzt, du hast die Erlaubnis des Videobesitzers) |
quality |
240p, 360p, 540p, 720p, 1080p, 2k, 4k |
auto |
Standardmäßig ist der Vimeo-Player auf den Modus „Auto" eingestellt, d.h. er wählt die höchstmögliche Videoqualität je nach Bandbreite beim Zuschauer und anderen Faktoren in der Wiedergabeumgebung. Mit dem Qualitätsparameter kannst du die Standard-Wiedergabequalität für dein eingebettetes Video festlegen. Wenn du eine Qualität wählst, die es für dein Video nicht gibt, wird der Qualitätsparameter ignoriert, und die Einbettung fällt automatisch auf Standard zurück. ⚠️ Warnungen: - Dieser Parameter wird auf mobilen Geräten oder Tablets nicht unterstützt. - Sei bitte vorsichtig, wenn du diesen Parameter implementierst. Die Vorgabe einer höheren Qualität (z. B. 4K) kann eine übermäßige Pufferung und abgehackte Wiedergabe für deine Zuschauer zur Folge haben. - Dieser Parameter wird nur für hochgeladene Videos und archivierte Events, die eingebettet sind, unterstützt. Er ist nicht mit Live-Events kompatibel. |
Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
speed |
true , false oder 1,0 |
false |
Zeigen Sie die Geschwindigkeitssteuerung im Einstellungsmenü des Players an und aktivieren Sie die Wiedergaberaten-API. (Erfahren Sie mehr über unsere Player-API unter Vimeo Entwickler: API ) |
Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
#t |
Zeit in Minuten und/oder Sekunden (z.B. #t=1m2s) |
Videostart |
Dient zum automatischen Starten der Wiedergabe zu einem bestimmten Zeitpunkt. Weitere Informationen findest du unter „Start der Wiedergabe bei einem bestimmten Timecode“. Hinweis: Dieser Parameter benötigt kein vorangestelltes Fragezeichen wie alle anderen. |
Alle Videos |
texttrack |
einen Sprachcode in Kleinbuchstaben und optional die Spracheinstellung und den Typ der Textdatei. (Beispiele: „en“, „en-US“, „en.captions“, „en.subtitles“) |
false |
Zeigt eine bestimmte CC-/Untertitelspur standardmäßig im Player an (vorausgesetzt die CC-/Untertitelspur ist verfügbar).
Wenn du eine Spracheinstellung eingibst, die für ein bestimmtes Video noch nicht hochgeladen wurde, wird der Textdatei-Parameter ignoriert, und dein eingebettetes Video wird möglicherweise mit CC oder standardmäßig deaktivierten Untertiteln geladen. |
Alle Videos mit verfügbaren Untertiteln und erweiterten Untertiteln (Hinweis: Erweiterte Untertitel und Untertitel müssen vom Videobesitzer hochgeladen werden. Weitere Informationen findest du unter Erweiterte Untertitel und Untertitel) |
title |
true , false oder 1,0 |
Der Wert wird |
Den Titel des Videos anzeigen. |
Alle Videos (aber nur, wenn der Videobesitzer es erlaubt) |
transparent |
true , false oder 1,0 |
true |
Standardmäßig ist der Hintergrund des Player-iframe bei Vimeo durchsichtig. Wenn deaktiviert, wird der Iframe-Hintergrund schwarz. Der Player bekommt schwarze Balken verpasst, wenn die Höhen- und Breitenabmessungen für den eingebetteten Player nicht mit dem ursprünglichen Seitenverhältnis eines Videos übereinstimmen, z.B. wenn die Iframe-Abmessungen auf 4:3 Square eingestellt sind, aber das Originalvideo 16:9 breit ist. |
Alle Videos |
Transkript |
true , false oder 1,0
|
true |
Zeigen Sie die Schaltfläche Transkription in der Kontrollleiste an und aktivieren Sie die Transkriptionssteuerung. |
Alle Videos mit Textspuren. |
Mehrere Einbettungsparameter verwenden
Falls du mehrere Parameter zum gleichen Einbettungscode hinzufügst, musst du diese durch ein Ampersand (&) trennen. Zum Beispiel:
<iframesrc="https://player.vimeo.com/video/76979871?autoplay=1&loop=1&muted=1" width="640" height="360" frameborder="0"webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>
Einbettungsparameter auf eine Vimeo.com-URL anwenden
Wenn Sie eine Anwendung verwenden, die das Einfügen einer Vimeo.com URL( z.B. https://vimeo.com/
Zum Beispiel wird diese Methode . nicht unterstützt:
https://vimeo.com/76979871?
Das wiederum wird unterstützt:
<iframe src="https://player.vimeo.com/video/76979871?quality=720p" width="640" height="360" frameborder="0"
webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>
Einige Beispiele für Anwendungen, die nur Vimeo-URLs unterstützen, sind Beiträge in sozialen Medien, WordPress-Themes und -Plugins, Wix-Plugins, Squarespace-Plugins und andere verschiedene Tools zum Einbetten von Videos bei Website-Buildern. Andererseits ermöglichen es einige Tools, dass du die Player-Einstellungen (z. B. Autoplay) direkt in ihrer eigenen Benutzeroberfläche anpassen kannst.
Fehlerbehebung bei Player-Parametern
Wenn Sie Probleme mit dem Hinzufügen eines Player-Parameters haben, wenden Sie sich bitte an uns und geben Sie den von Ihnen verwendeten Einbettungscode an, um die Fehlerbehebung zu beschleunigen.