Der Artikel erklärt, wie man den Vimeo-Player mithilfe von URL-Parametern im Einbettungscode anpassen kann, um dem Video bestimmte Funktionen hinzuzufügen.
In diesem Artikel:
Was ist ein Spielerparameter?
- Ein Player-Parameter ist eine Textzeichenfolge, die an die URL eines Videos innerhalb seines Einbettungscodes angehängt wird. Es dient als Anweisung, die das Verhalten des Video-Players verändert, z. B. das Starten von Autoplay oder das Wiederholen von Videos in einer Schleife.
- URL-Parameter beginnen mit einem Fragezeichen (?).
- URL-Einstellungen gelten nur für den jeweiligen Einbettungscode , in dem der Parameter hinzugefügt wurde.
Beispiel:
iframe src="https://player.vimeo.com/video/76979871?embedparameter=value" width="640" height="360" frameborder="0" allowfullscreen></iframe>
Die Spielerparameter optimal nutzen
In der folgenden Tabelle finden Sie eine Übersicht der unterstützten Player-Parameter, die Sie mit Ihrem Einbettungscode verwenden können:
| Parameter | Unterstützte Werte | Default Werte | Beschreibung | Unterstützte Videos |
| AirPlay |
true , false oder 1,0 |
true | ob AirPlay aktiviert ist. | Das Video muss von einem Starter-, Standard-, erweitert, Plus-, Pro, Business-, Premium- oder Enterprise -Konto gehostet werden. ⚠️Hinweis: AirPlay wird nur auf Safari unterstützt. |
| ask_ai | autopause | true | ob die Funktion „ KI fragen“ aktiviert ist. | Videos, die von einem Enterprise Konto gehostet werden und für die Funktion „KI fragen“ in Frage kommen. |
| audio_track |
true , false oder 1,0 |
true | ob das Audio-Menü angezeigt wird. | Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
| Audiospur |
einen klein geschriebenen Sprachcode oder „main“, wenn das Video standardmäßig auf die Haupt-Audiospur angezeigt werden soll
|
false | Zeigt standardmäßig eine bestimmte Audiospur im Player an (sofern die Audiospur verfügbar ist) | Alle Videos, in die mehrere Tonspuren hochgeladen wurden |
| autopause |
true , false oder 1,0 |
true |
Der Vimeo -Player gibt immer nur ein Video ab. Um mehrere Videos auf einer Seite zu haben, musst du für jedes Video einen bestimmten Parameter hinzufügen. ⚠️ Hinweis: Damit die automatische Pause funktioniert, musst du Cookies in deinem Browser aktiviert haben. |
Alle Videos |
| autoplay |
true , false oder 1,0 |
false | Startet automatisch die Wiedergabe des Videos. | Alle Videos |
| background |
true , false oder 1,0 |
false |
Das Hinzufügen dieses Parameters hat folgende Auswirkungen:
Um Loops oder Autoplay zu verhindern, verwenden Sie den Parameter control=0. Durch die Einstellung dieses Parameters wird die Tastatursteuerung nicht deaktiviert. |
Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
| Plakette |
true , false oder 1,0 |
true | Zeigen Sie die Kennzeichnung des Videos (z. B Staff Pick-Plakette). | Alle Videos |
| byline |
true , false oder 1,0 |
In den einbetten des Videos auf der Website angegeben |
Zeige den Autor des Videos an (Quellenangabe). | Alle Videos |
| CC |
true , false oder 1,0 |
true | ob die Schaltfläche für Untertitel aktiviert ist. | Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
| Kapitel |
true , false oder 1,0 |
true | ob der Kapitel-Button angezeigt wird. | Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
| Chromecast |
true , false oder 1,0 |
true | ob die Chromecast-Schaltfläche angezeigt wird. |
Das Video muss von einem Starter-, Standard-, erweitert, Plus-, Pro, Business-, Premium- oder Enterprise -Konto gehostet werden. ⚠️Hinweis: Chromecast wird auf iOS nicht unterstützt |
| color | [hex code] | Vimeo blue- 00adef |
Gib die Farbe der Videosteuerungen an. Die Farben können durch die eingebetteten Einstellungen des Videos überschrieben werden. Wenn die Farbe nicht über den Parameter oder die Einstellung eingestellt wird, wird der transparente Parameter aktiviert. |
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 Farbe 2-Akzent: #00adef Farbe 3- Symbol und Text:#ffffff Farbe 4- Hintergrund: #000000 |
Legen Sie die Farben des Players fest. Die Farben können durch die eingebetteten Einstellungen des Videos überschrieben 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 | Blendet alle Player-Elemente ein oder ein, z. B. die Playleiste und die Sharing-Buttons, um ein Chrome-Erlebnis zu schaffen. Hinweis: Wenn die Option aktiviert ist, ist der Button „Wiedergabe/Pause“ ausgeblendet. Zuschauer müssen Autoplay, Tastatursteuerungen oder unser Player-SDK verwenden, um die Wiedergabe zu starten und zu steuern. Durch diese Einstellung werden die Tastatursteuerungen nicht deaktiviert. |
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“ einstellen, kann der Player keine Sitzungsdaten und Analytics erfassen, ähnlich wie die Aktivierung der „Do Not Track“-Funktion in Ihrem Browser. ⚠️ Hinweis: Wenn DNT aktiv ist, sind einige wichtige Cookies noch aktiv. Besuchen Sie Vimeo-Player-Cookies, um diese Liste anzuzeigen. |
Alle Videos |
| Vollbild |
true , false oder 1,0 |
true | ob die Vollbild-Schaltfläche angezeigt wird. | Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
| initial_quality | 240p, 360p, 540p, 720p, 1080p, 2k, 4k | auto |
Die ursprüngliche Videoqualität, die kurz angezeigt wird, bevor das adaptive Streaming beginnt. Dies ist anpassbar, um das Laden zu beschleunigen oder die Klarheit zu verbessern. niedrigere Qualität, z. B. 360p, lädt schneller; höhere Qualität, wie 1080p oder 4K, bietet sofort eine bessere Auflösung. |
Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
| interactive_parameters | Durch Komma getrennte Schlüssel-Value-Paare | Keine Angabe | Schlüssel- Wert-Paare, die dynamische Parameter darstellen, die in interaktiv Videos mit dynamischen Elementen verwendet werden, z. B. title=my-video , untertitel= interaktiv | Interaktive Videos |
| interactive_markers |
true , false oder 1,0 |
true | ob Markierungen angezeigt werden sollen, die den Zeitstempel darstellen, an dem Hotspots in einem interaktiv Video erscheinen. | Interaktive Videos |
| keyboard |
true , false oder 1,0 |
true | Ermöglicht Tastatureingaben zur Auslösung von Player-Ereignissen. Bei „false“ ignoriert der Player die Tastatureingabe. Das Tabbing wird 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. 💡Tipp: Die Loop-Option kann auch als Endbildschirm eines Videos innerhalb der Seite mit den Einstellungen einbetten werden. Weitere Informationen findest du unter Über Endbildschirme. |
Alle Videos |
| maxi_quality | 240p, 360p, 540p, 720p, 1080p, 2k, 4k | auto |
Die höchste Qualität, die der Player während der Wiedergabe automatisch auswählt. Der Player wählt die beste Qualität bis zu diesem Wert, ohne ihn zu überschreiten. Mit dieser Einstellung kannst du den Bandbreite reduzieren. Sie können einen beliebigen Wert aus dem Qualitätsmenü im Video-Player auswählen, einschließlich 360p, 720p, 1080p, 2K und 4K. |
Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
| mind_quality | 240p, 360p, 540p, 720p, 1080p, 2k, 4k | auto |
Die niedrigere Qualität, auf die der Player während der Wiedergabe automatisch umschaltet . Der Player wählt die optimale Qualität, ohne unter diesen Grenzwert zu fallen. Mit der Einstellung dieses Parameters kannst du sicherstellen, dass Zuschauende Videos in hoher Auflösung erhalten und gleichzeitig Bandbreite berücksichtigen. Sie können jede im Player verfügbare Qualitätsoption auswählen, einschließlich 360p, 720p, 1080p, 2K und 4K. |
Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
| muted |
true , false oder 1,0 |
false |
Stelle das Video beim Laden stumm. Die Zuschauer können die Lautstärkeeinstellungen weiterhin im Player anpassen. Kann verwendet werden, um die Stummschaltung von Hintergrundvideos aufzuheben oder die Autoplay Einschränkungen 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. | Das Video muss von einem Starter-, Standard-, erweitert, Plus-, Pro, Business-, Premium- oder Enterprise -Konto gehostet werden |
| play_Button_position | automatisch, unten oder in der Mitte | auto | Wo sich der Wiedergabe-Button auf dem Player befindet. Wenn die Einstellung auf „Auto“ eingestellt ist, wird der Wiedergabe-Button in der Steuerleiste angezeigt, bevor er bei kleineren Haltepunkten in die Mitte des Players bewegt wird. | Das Video muss von einem Starter-, Standard-, erweitert, Plus-, Pro, Business-, Premium- oder Enterprise -Konto gehostet werden |
| playsinline |
true , false oder 1,0 |
true | Videos auf Mobilgeräten inline abspielen, 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 |
In den einbetten des Videos auf der Website angegeben |
Zeigen Sie das Profilbild des Verfassers an (Hochformat). | Alle Videos |
| vorladen | Metadaten, Metadaten_on_hover, Auto, Auto_on_hover, Keine |
Metadata_ on_hover |
Das Ladeverhalten des Players vor der Wiedergabe entspricht der nativen Preload-Eigenschaft der HTMLMediaElement-Oberfläche, mit einigen zusätzlichen Optionen:
Das Vorabladen von mehr Daten hilft, das Video schneller zu starten. Daher führen „auto“ und „auto_on_hover“ zu einem schnelleren Start, benötigen aber mehr Bandbreite , da Videosegmente geladen werden, unabhängig davon, ob der Benutzer das Video abspielt oder nicht. Weitere Informationen zu den Bandbreite von Vimeo finden Sie unter Bandbreite bei Vimeo . |
Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
| Progress_bar |
true , false oder 1,0 |
true | ob der Fortschrittsbalken angezeigt wird. | Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
| quality | 240p, 360p, 540p, 720p, 1080p, 2k, 4k | automatisch |
Standardmäßig ist der Vimeo-Player auf den Modus „Auto“ eingestellt, d. h. er wählt die höchstmögliche Videoqualität basierend auf der Bandbreite des Zuschauers und anderen Faktoren in der Wiedergabe aus. Mit Qualität kannst du die Standard-Auflösung für die Wiedergabe für dein eingebettetes Video festlegen. Wenn du eine Qualität auswählst, die nicht verfügbar ist, wird der Parameter ignorieren und für die einbetten standardmäßig auf „Auto“ eingestellt. 💡Tipp: Die Wahl einer höheren Qualitätseinstellung (z. B. 4K) kann für die Zuschauende zu übermäßiger Pufferung und ruckeliger Wiedergabe führen. |
Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. Verfügbar für hochgeladene Videos und archivierte Events. Live-Events werden nicht unterstützt. |
| quality_selector |
true , false oder 1,0 |
true | ob das Qualitätsauswahlmenü angezeigt wird. | Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
| skip_forrow |
true , false oder 1,0 |
true | ob der Benutzer während der Wiedergabe nach vorne springen darf . | 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 Geschwindigkeitssteuerungen im Einstellungsmenü des Players an und aktivieren Sie die API für die Wiedergabe . (Mehr über unsere Player-API findest du unter Vimeo Creator: 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) |
Anfang des Videos (0m) |
Wird verwendet, um die Wiedergabe automatisch an einem bestimmten Zeitpunkt zu beginnen. Weitere Informationen findest du unter „Wiedergabe zu einem bestimmten Timecode starten“. 💡Tipp: Für diesen Parameter ist kein vorgefertigtes Fragezeichen erforderlich, wie dies für alle anderen der Fall ist. |
Alle Videos |
| texttrack |
Ein klein geschriebener Sprachcode und optional das Standort und den Typ der Text-Track. (Beispiele: „en“, „en-US“, „en.captions“, „en.subtitles“) |
false |
Zeigt standardmäßig eine bestimmte CC-/Untertitelspur im Player an, falls verfügbar. Wenn Sie eine Spracheinstellung auswählen, die noch nicht für Ihr Video hochgeladen wurde, wird die Einstellung für die Text-Track abgelehnt und das eingebettete Video möglicherweise mit erweiterte Untertitel geladen oder die Untertitel standardmäßig deaktiviert. |
Alle Videos mit erweiterte Untertitel oder Untertitel sind verfügbar (Hinweis: erweiterte Untertitel und Untertitel müssen vom Videobesitzende hochgeladen werden. Weitere Informationen findest du unter Erweiterte Untertitel und Untertitel) |
| Vorschaubild_id | Die ID des Vorschaubildes, das aus dem verfügbaren Vorschaubild-Set des Videos geladen werden soll. | Keine Angabe | Zeigt die ID des Vorschaubildes an, das aus dem verfügbaren Vorschaubild-Set des Videos geladen werden soll. | Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
| title |
true , false oder 1,0 |
Inden einbetten des Videos auf der Website angegeben |
Den Titel des Videos anzeigen. | Alle Videos |
| transparent |
true , false oder 1,0 |
true |
Die transparente Einstellung ist aktiv, wenn die Farbe nicht über eine Einstellung oder einen Parameter festgelegt wurde. Normalerweise ist der iframe Hintergrund des Vimeo -Players standardmäßig transparent. Wenn die Option deaktiviert ist, wird der Hintergrund in schwarz geändert. Auf dem Player sind schwarzenbalken sichtbar, wenn die Höhe und Breite des iframes nicht mit dem ursprünglichen Seitenverhältnis des Videos übereinstimmen, z. B. wenn der iframe auf 4:3 eingestellt ist, während das ursprüngliche Video 16:9 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. | Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
| unmute_Button |
true , false oder 1,0 |
true | ob die Schaltfläche zum Aufheben der Stummschaltung angezeigt wird. | Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
| vimeo_logo |
true , false oder 1,0 |
true | ob das Vimeo -Logo angezeigt wird. | Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
| Lautstärke |
true , false oder 1,0 |
true | ob der Lautstärkeregler angezeigt wird. | Das Video muss von einem Starter-, Standard-, Advanced-, Plus-, Pro-, Business-, Premium- oder Enterprise-Konto gehostet werden. |
| watch_voll_video |
true , false oder 1,0 |
true | ob der Button Komplettes Video ansehen in Videos im Segmented Playback-Modus angezeigt wird. | Alle Videos im Segmented Playback-Modus. |
Empfohlene nächste Schritte
- Erfahren Sie,wie Sie Autoplay- und Loop-Parameter zu Ihrem Video-Einbettungscode hinzufügen.