Player-Konfigurationsparameter

Sie können einige Aspekte des Verhaltens von Video Cloud-Playern konfigurieren, indem Sie den Veröffentlichungscode des Players bearbeiten. In diesem Themenbereich werden die in Video Cloud unterstützten Player-Konfigurationsparameter aufgelistet und die beim Festlegen von Player-Konfigurationsparametern in JavaScript, ActionScript und HTML-Einbettungscode verwendete Syntax gezeigt.

Die Konfiguration von Playerparametern kann praktisch sein, wenn eine Player-Instanz sich in zwei verschiedenen Fällen unterschiedlich verhalten soll.

In diesem Abschnitt werden folgende Lerninhalte behandelt:

Syntax für Player-Konfigurationsparameter in JavaScript, ActionScript und HTML-Einbettungscode
Unterstützte Player-Konfigurationsparameter
Player-Konfigurationsparameter für Anzeigenanforderungen

Syntax für Player-Konfigurationsparameter in JavaScript, ActionScript und HTML-Einbettungscode

Die Namen der Konfigurationsparameter sind gleich, unabhängig von der Art des verwendeten Veröffentlichungscodes. Die Syntax unterscheidet sich jedoch bei JavaScript, ActionScript und HTML-Einbettungscode. Weitere Informationen zu Playerveröffentlichungscodes.

Konfigurationsparameter für JavaScript-Veröffentlichungscode

Wenn Sie JavaScript verwenden, fügen Sie Konfigurationsparameter zwischen den <object>-Tags des Player-Veröffentlichungscodes ein. Die Player-Konfigurationsparameter in JavaScript haben diese Form:

<param name="param_name" value="param_value" />

Konfigurationsparameter für ActionScript-Veröffentlichungscode

Wenn Sie ActionScript verwenden, fügen Sie Konfigurationsparameter in die init-Funktion des Player-Veröffentlichungscodes ein. Die Player-Konfigurationsparameter in ActionScript haben diese Form:

config["param_name"] = "param_value";

Konfigurationsparameter für Einbettungsveröffentlichungscode

Wenn Sie HTML-embed-Code verwenden, fügen Sie Konfigurationsparameter in den flashVars-Parameter des Player-Veröffentlichungscodes ein. Die Player-Konfigurationsparameter im HTML-embed-Code haben die folgende Form:

<param name="flashVars" value="playerID=13578640001&domain=embed
             &param_name1=param_value1&param_name2=param_value2" />

Unterstützte Player-Konfigurationsparameter

In der folgenden Tabelle sind die in Video Cloud unterstützten Player-Konfigurationsparameter aufgelistet. Beachten Sie, dass bei allen Parameternamen zwischen Groß- und Kleinschreibung unterschieden wird. Zudem funktionieren Player-Konfigurationsparameter, die Sie in ActionScript 2-Playern von Brightcove verwendet und mithilfe der Brightcove-Konsole oder vor der Veröffentlichung von Brightcove 3 erstellt haben, nicht mit ActionScript 3-Playern von Video Cloud.

Parameter	Typ	Beschreibung
`@videoPlayer`	String	Die ID oder „refid“ eines Videos, das in den Player programmiert wird. Siehe Programmgesteuertes Zuweisen von Inhalt zu Playern.
`@playlistTabs`	String	Die ID oder „refid“ von mindestens einer Wiedergabeliste, die in einen Player programmiert wird, der Registerkarten zum Auswählen von Wiedergabelisten verwendet. Siehe Programmgesteuertes Zuweisen von Inhalt zu Playern.
`@playlistCombo`	String	Die ID oder „refid“ von mindestens einer Wiedergabeliste, die in einen Player programmiert wird, der eine ComboBox (Dropdownmenü) zum Auswählen von Wiedergabelisten verwendet. Siehe Programmgesteuertes Zuweisen von Inhalt zu Playern.
`@videoList`	String	Die ID oder „refid“ einer Wiedergabeliste, die in den Player programmiert wird. Siehe Festlegen von bereitgestelltem Inhalt.
`width`	Zahl	Die Gesamtbreite des Players in Pixeln.
`height`	Zahl	Die Gesamthöhe des Players in Pixeln.
`autoStart`	Boolesch	Wird „true“ festgelegt, wird die Videowiedergabe sofort beim Laden des Players gestartet.
`bgcolor`	String	Eine sechsstellige Hexadezimalzahl, die für die Hintergrundfarbe des Players steht. Beispiel: `bgcolor = "#FFFFFF;"` (Standard) steht für Weiß. Wenn Sie diesen Parameter weglassen, besitzt der Player einen weißen Hintergrund, bis er vollständig geladen ist. Diese Darstellung ist möglicherweise nicht in Ihrem Sinne. Die Hintergrundfarbe könnte beispielsweise auf die Farbe der Seite abgestimmt werden, auf der der Player geladen wird.
`dynamicStreaming`	Boolesch	Wird die Standardeinstellung „true“ festgelegt, kann der Player die reibungslosen Streamingfunktionen von Flash Media Server 3.5 und Flash Player 10 nutzen. Siehe Dynamisches Streaming.
`includeAPI`	Boolesch	Muss auf „true“ gesetzt werden, um die Smart-Player-API mit diesem Player zu verwenden.
`isUI`	Boolesch	Muss für Videoplayer, deren Vorlagen andere Benutzeroberflächenelemente als die `VideoPlayer`-Komponente beinhalten, z. B. eine `ChromelessVideoPlayer`-, `VideoDisplay`- oder `MediaControls`-Komponente, auf „true“ gesetzt werden.
`isVid`	Boolesch	Muss für alle Videoplayer auf „true“ gesetzt werden.
`labels`	String	Die URL einer XML-Datei, die den für diesen Player verwendeten Labelsatz beschreibt. Weitere Informationen zum Erstellen einer Labelsatzdatei finden Sie unter Lokalisieren von Playern.
`language`	Aufzählung	Die für die Standardplayerlabels zu verwendende Sprache: de (Deutsch), en (Englisch), fr (Französisch), it (Italienisch), jp (Japanisch) oder es (Spanisch). Dieser Wert setzt die für den Player im Veröffentlichungsmodul von Video Cloud Studio festgelegte Spracheinstellung außer Kraft.
`linkBaseURL`	String	Die Basis-URL, die verwendet werden soll, wenn der Betrachter im Player auf die Schaltfläche „Freigeben“, „Link kopieren“ oder „Per E-Mail senden“ klickt. Sie setzt die standardmäßige `linkBaseURL` außer Kraft und ermöglicht die Verknüpfung zur übergeordneten Seite des Players. Siehe Anpassen der Link-URL.
`localizedErrorXML`	String	Die URL einer Datei mit Playerfehlermeldungen. Diese XML-Datei definiert die Meldungen, die im Falle von Playerfehlern angezeigt werden sollen. Siehe Lokalisieren von Playerfehlermeldungen.
`majorVersion`	String	Die erforderliche Hauptversionsnummer von Flash. Standardmäßig erfordern Video Cloud-Player Flash-Version 9.0.28 oder höher. Verwenden Sie diesen Parameter, wenn Flash 10 erforderlich sein soll: `<param name="majorVersion" value="10" />`.
`minorRevision`	String	Die erforderliche Nebenrevisionsnummer von Flash 9. Standardmäßig erfordern Video Cloud-Player Flash-Version 9.0.28 oder höher. Verwenden Sie den folgenden Parameter, wenn eine höhere Flash 9-Version erforderlich sein soll: `<param name="minorRevision" value="115" />`.
`playerId`	Zahl	Die Player-ID. Dieser Parameter wird durch den playerKey-Parameter ersetzt. Wenn Sie einen anderen Player auf der Seite laden möchten, sollten Sie sowohl die Werte der playerId als auch des playerKey-Parameters ändern.
`playerKey`	String	Eine eindeutige Kennung für den Player mit einer verschlüsselten Darstellung der Player-ID.
`secureConnections`	Boolesch	Wird „true“ festgelegt, wird verhindert, dass ein auf einer HTTPS-Seite veröffentlichter Player Sicherheitswarnungen auslöst. Beachten Sie, dass dadurch nur Sicherheitswarnungen verhindert werden. Die Verwendung von HTTPS durch den Player wird dadurch nicht veranlasst. Beachten Sie auch, dass diese Einstellung nur auf HTTPS-Seiten verwendet werden sollte; auf HTTP-Seiten kann sie Fehler verursachen. Dies ist nur für JavaScript-Veröffentlichungscode relevant. Weitere Informationen finden Sie unter Veröffentlichen eines Video Cloud-Players auf einer HTTPS-Seite.
`skipContentCall`	Boolesch	Wird „true“ festgelegt, wird das Auslösen eines Contentaufrufs verhindert, wenn zum Abrufen von Content die Nur-Flash-Player-API verwendet wird.
`showNoContentMessage`	Boolesch	Wird „true“ festgelegt, wird eine Warnmeldung angezeigt, wenn dem Player kein Content zugewiesen wurde.
`templateErrorHandler`	String	Der Name einer benutzerdefinierten JavaScript-Funktion, die bei Fehlerereignissen im Player automatisch aufgerufen wird.
`templateLoadHandler`	String	Der Name einer benutzerdefinierten JavaScript-Funktion, die beim Laden des Players automatisch aufgerufen wird. Dies ist ein Einstiegspunkt für die Smart Player API.
`templateReadyHandler`	String	Der Name einer benutzerdefinierten JavaScript-Funktion, die bei Ereignissen bei Bereitschaft des Players automatisch aufgerufen wird.
`videoSmoothing`	Boolesch	Das Standardverhalten der Videoglättung des Players wird außer Kraft gesetzt. Wird der Standardwert „true“ festgelegt, wird die Videoglättung immer angewendet; bei „false“ wird die Videoglättung nie angewendet. Ist keine Angabe vorhanden, verwendet der Player die Videoglättung.