In diesem Dokument wird das programmgesteuerte Zuweisen von Inhalt zu Playern mit den einzelnen Video Cloud-Veröffentlichungscodes (JavaScript, ActionScript, HTML embed-Tag und Link-URL) erläutert.
Nach dem Hochladen von Videocontent und Erstellen von Playern müssen Sie diese miteinander verknüpfen, sodass vom richtigen Player der richtige Videocontent wiedergegeben wird. Nicht allen Playervorlagen können Wiedergabelisten zugewiesen werden. Wenn ein Player keine Wiedergabeliste akzeptiert, wird er im Medienmodul mit dem Hinweis „Diesem Player Videos mithilfe der Schnellveröffentlichung oder der Video Cloud-APIs zuweisen“ versehen.
Falls noch nicht geschehen, laden Sie Content in Video Cloud Studio hoch, indem Sie die Schritte in Erste Schritte mit dem Medienmodul und Hochladen von Videos mit dem Medienmodul ausführen. Falls Sie noch keinen Player erstellt haben, führen Sie dazu die Schritte in Studio-Schnelleinstieg: Erstellen des ersten Video Cloud-Players aus.
Sie müssen zum Zuweisen von Inhalt zu einem Player Parameter im Veröffentlichungscode der Player festlegen und dadurch die wiederzugebenden Videos oder Wiedergabelisten angeben. Sie können die Videos oder Wiedergabelisten mithilfe der ID oder Referenz-ID angeben, können jedoch nicht beide im selben Veröffentlichungscode verwenden. Die Video-ID eines Videos kann auf folgende zwei Arten abgerufen werden:
Nach dem Abrufen der IDs für die im Player wiederzugebenden Videos oder Wiedergabelisten kann der Content dem Player auf verschiedene Arten zugewiesen werden. Die Methode hängt davon ab, wie der Player veröffentlicht wurde und wie Sie den im Player dargestellten Content steuern möchten. Die Syntax variiert je nach Typ des verwendeten Veröffentlichungscodes.
Zum Zuweisen von Content zu Playern stehen im Medienmodul auch noch andere Möglichkeiten zur Verfügung. Weitere Informationen hierzu finden Sie unter Zuweisen von Inhalt zu Playern mithilfe des Medienmoduls und Schnelle Veröffentlichung von Videos. Sie können auch mithilfe von Konfigurationsparametern im Playerveröffentlichungscode angeben, dass vom Player ein bestimmtes Video aus der Wiedergabeliste abgespielt werden soll. Informationen hierzu finden Sie unter Festlegen von bereitgestelltem Inhalt in Playern.
In diesem Dokument erfahren Sie, wie Sie den Playern programmgesteuert einzelne Videos oder Wiedergabelisten mithilfe der Video Cloud-Veröffentlichungscodes zuweisen:
Fügen Sie zum Übergeben einer Video-ID an einen Player, der ein einzelnes Video akzeptiert und mittels JavaScript-Code veröffentlicht wird, den folgenden Parameter zum JavaScript-Veröffentlichungscode hinzu:
<param name="@videoPlayer" value="12345" />
Dabei steht „12345“ für die Video-ID des im Player wiederzugebenden Videos.
Der vollständige HTML-Code zum Veröffentlichen des Players und zum Zuweisen eines Videos mit der ID „12345“ zur Wiedergabe beim Laden würde folgendermaßen lauten:
<script language="JavaScript" type="text/javascript" src=" http://admin.brightcove.com/js/BrightcoveExperiences.js"></script> <object id="myPlayer" class="BrightcoveExperience"> <param name="bgcolor" value="#FFFFFF" /> <param name="width" value="486" /> <param name="height" value="412" /> <param name="playerID" value="1234567890" /> <param name="playerKey" value="AQ~~,AAAAstMe5SE~,5vOZeV6rFDb4JUBomUtNzVLbOfHyhc1i" /> <param name="isVid" value="true" /> <param name="@videoPlayer" value="12345" /> </object>
Fügen Sie zum Übergeben einer Referenz-ID an einen Player, der ein einzelnes Video akzeptiert und mittels JavaScript-Code veröffentlicht wird, den folgenden Parameter zum JavaScript-Veröffentlichungscode hinzu:
<param name="@videoPlayer" value="ref:myVid12345" />
Dabei steht „myvid12345“ für die Referenz-ID des im Player wiederzugebenden Videos. Beachten Sie, dass der Referenz-ID ref: vorangestellt werden muss.
Der vollständige HTML-Code zum Veröffentlichen des Players und zum Zuweisen eines Videos mit der ID „12345“ zur Wiedergabe beim Laden würde folgendermaßen lauten:
<script language="JavaScript" type="text/javascript" src=" http://admin.brightcove.com/js/BrightcoveExperiences.js"></script> <object id="myPlayer" class="BrightcoveExperience"> <param name="bgcolor" value="#FFFFFF" /> <param name="width" value="486" /> <param name="height" value="412" /> <param name="playerID" value="1234567890" /> <param name="playerKey" value="AQ~~,AAAAstMe5SE~,5vOZeV6rFDb4JUBomUtNzVLbOfHyhc1i" /> <param name="isVid" value="true" /> <param name="@videoPlayer" value="ref:myVid12345" /> </object>
Fügen Sie zum Übergeben einer Wiedergabelisten-ID an einen Player, der mehrere Wiedergabelisten akzeptiert und mittels JavaScript-Code veröffentlicht wird, den playlistTabs- oder playlistCombo-Parameter zum JavaScript-Veröffentlichungscode hinzu:
<param name="@playlistTabs" value="6789"/> <param name="@playlistCombo" value="6789"/>
Dabei steht „6789“ für die Wiedergabelisten-ID der im Player wiederzugebenden Wiedergabeliste. Verwenden Sie den playlistTabs-Konfigurationsparameter für Player, in denen Wiedergabelisten über Registerkarten ausgewählt werden, und verwenden Sie den playlistCombo-Konfigurationsparameter für Player, in denen die Auswahl der Wiedergabelisten über Kombinationsfelder (Dropdownlisten) erfolgt. Sie können mehrere Wiedergabelisten-IDs übergeben, indem Sie sie durch Kommas trennen:
<param name="@playlistTabs" value="6789,9876,5432"/>
Bei Playern, deren Inhalt von einer List- oder TabList-Komponente abgerufen wird, wie zum Beispiel bei der Vorlage Breitbild mit horizontaler Liste, ist nur eine einzelne Wiedergabeliste zulässig. Fügen Sie zum Übergeben der Wiedergabelisten-ID an einen Player, der nur eine einzelne Wiedergabeliste akzeptiert und mittels JavaScript-Code veröffentlicht wird, den videoList-Parameter zum JavaScript-Veröffentlichungscode hinzu:
<param name="@videoList" value="6789"/>
Der vollständige HTML-Code zum Veröffentlichen des Players und zum Zuweisen einer Wiedergabeliste mit der ID „6789“ zur Wiedergabe beim Laden würde folgendermaßen lauten:
<script language="JavaScript" type="text/javascript" src="http://admin.brightcove.com/js/BrightcoveExperiences.js"></script> <object id="myPlayer" class="BrightcoveExperience"> <param name="bgcolor" value="#FFFFFF" /> <param name="width" value="790" /> <param name="height" value="529" /> <param name="playerID" value="1234567890" /> <param name="playerKey" value="AQ~~,AAAAstMe5SE~,5vOZeV6rFDb4JUBomUtNzVLbOfHyhc1i" /> <param name="isVid" value="true" /> <param name="isUI" value="true" /> <param name="@playlistTabs" value="6789" /> </object>
Fügen Sie zum Übergeben der Referenz-ID einer Wiedergabeliste an einen Player, der mehrere Wiedergabelisten akzeptiert und mittels JavaScript-Code veröffentlicht wird, den playlistTabs- oder playlistCombo-Parameter zum JavaScript-Veröffentlichungscode hinzu, und stellen Sie der Referenz-ID im Parameterwert ref: folgendermaßen voran:
<param name="@playlistTabs" value="ref:myPlaylist6789"/> <param name="@playlistCombo" value="ref:myPlaylist6789"/>
Dabei steht „myplaylist6789“ für die Referenz-ID der im Player wiederzugebenden Wiedergabeliste. Wenn Sie mehrere Wiedergabelisten nach Referenz-ID übergeben möchten, stellen Sie der durch Kommata getrennten Auflistung der Referenz-IDs der einzelnen Wiedergabelisten ref: voran. Stellen Sie sicher, dass sich zwischen den durch Kommas getrennten Elementen keine Leerzeichen befinden.
<param name="@playlistTabs" value="ref:myPlaylist6789,yourPlaylist9876,herPlaylist5432"/>
Bei Playern, deren Inhalt von einer List- oder TabList-Komponente abgerufen wird, wie zum Beispiel bei der Vorlage Breitbild mit horizontaler Liste, ist nur eine einzelne Wiedergabeliste zulässig. Fügen Sie zum Übergeben der Referenz-ID einer Wiedergabeliste an einen Player, der nur eine einzelne Wiedergabeliste akzeptiert und mittels JavaScript-Code veröffentlicht wird, den videoList-Parameter zum JavaScript-Veröffentlichungscode hinzu, und stellen Sie der Referenz-ID im Parameterwert ref: voran:
<param name="@videoList" value="ref:myPlaylist6789"/>
Der vollständige HTML-Code zum Veröffentlichen des Players und zum Zuweisen einer Wiedergabeliste mit der Referenz-ID myPlaylist6789 zur Wiedergabe beim Laden würde folgendermaßen lauten:
<script language="JavaScript" type="text/javascript" src="http://admin.brightcove.com/js/BrightcoveExperiences.js"></script> <object id="myPlayer" class="BrightcoveExperience"> <param name="bgcolor" value="#FFFFFF" /> <param name="width" value="790" /> <param name="height" value="529" /> <param name="playerID" value="1234567890" /> <param name="playerKey" value="AQ~~,AAAAstMe5SE~,5vOZeV6rFDb4JUBomUtNzVLbOfHyhc1i" /> <param name="isVid" value="true" /> <param name="isUI" value="true" /> <param name="@playlistTabs" value="ref:myPlaylist6789" /> </object>
Verwenden Sie zum Übergeben der Video-ID an den Player, der ein einzelnes Video akzeptiert und mittels ActionScript veröffentlicht wird, den videoPlayer-Konfigurationsparameter folgendermaßen:
config["@videoPlayer"] = "12345";
Dabei steht „12345“ für die Video-ID des im Player wiederzugebenden Videos. Fügen Sie diesen Konfigurationsparameter dem ActionScript-Veröffentlichungscode für den Player hinzu, den Sie aus dem Veröffentlichungsmodul kopiert haben.
Verwenden Sie zum Übergeben der Referenz-ID an den Player, der ein einzelnes Video akzeptiert und mittels ActionScript veröffentlicht wird, den videoPlayer-Konfigurationsparameter, und stellen Sie der Referenz-ID ref: folgendermaßen voran:
config["@videoPlayer"] = "ref:myVideo12345";
Dabei steht „myVideo12345“ für die Referenz-ID des im Player wiederzugebenden Videos. Fügen Sie diesen Konfigurationsparameter dem ActionScript-Veröffentlichungscode für den Player hinzu, den Sie aus dem Veröffentlichungsmodul kopiert haben.
Verwenden Sie zum Übergeben der Wiedergabelisten-ID an den Player, der mehrere Videos akzeptiert und mittels ActionScript veröffentlicht wird, den playlistTabs- oder playlistCombo-Konfigurationsparameter folgendermaßen:
config["@playlistTabs"] = "6789"; config["@playlistCombo"] = "6789";
Dabei steht „6789“ für die Wiedergabelisten-ID des im Player wiederzugebenden Videos. Verwenden Sie den playlistTabs-Konfigurationsparameter für Player, in denen Wiedergabelisten über Registerkarten ausgewählt werden, und verwenden Sie den playlistCombo-Konfigurationsparameter für Player, in denen die Auswahl der Wiedergabelisten über Kombinationsfelder (Dropdownlisten) erfolgt. Fügen Sie den Konfigurationsparameter dem ActionScript-Veröffentlichungscode für den Player hinzu, den Sie aus dem Veröffentlichungsmodul kopiert haben. Sie können mehrere Wiedergabelisten-IDs übergeben, indem Sie sie durch Kommas trennen:
config["@playlistTabs"] = "6789,9876,5432";
Bei Playern, deren Inhalt von einer List- oder TabList-Komponente abgerufen wird, wie zum Beispiel bei der Vorlage Breitbild mit horizontaler Liste, ist nur eine einzelne Wiedergabeliste zulässig. Fügen Sie zum Übergeben der Wiedergabelisten-ID an einen Player, der nur eine einzelne Wiedergabeliste akzeptiert und mittels ActionScript-Code veröffentlicht wird, den videoList-Parameter zum ActionScript-Veröffentlichungscode hinzu:
config["@videoList"] = "6789";
Verwenden Sie zum Übergeben der Referenz-ID einer Wiedergabeliste an den Player, der mehrere Videos akzeptiert und mittels ActionScript veröffentlicht wird, den playlistTabs- oder playlistCombo-Konfigurationsparameter, und stellen Sie der Referenz-ID ref: folgendermaßen voran:
config["@playlistTabs"] = "ref:myPlaylist6789"; config["@playlistCombo"] = "ref:myPlaylist6789";
Dabei steht „myPlaylist6789“ für die Referenz-ID der im Player wiederzugebenden Wiedergabeliste. Fügen Sie diesen Konfigurationsparameter dem ActionScript-Veröffentlichungscode für den Player hinzu, den Sie aus dem Veröffentlichungsmodul kopiert haben. Wenn Sie mehrere Referenz-IDs übergeben möchten, stellen Sie der durch Kommata getrennten Aufzählung der Referenz-IDs ref: voran. Stellen Sie sicher, dass sich zwischen den durch Kommas getrennten Elementen keine Leerzeichen befinden.
config["@playlistTabs"] = "ref:myPlaylist6789,myPlaylist9876,myPlaylist5432";
Bei Playern, deren Inhalt von einer List- oder TabList-Komponente abgerufen wird, wie zum Beispiel bei der Vorlage Breitbild mit horizontaler Liste, ist nur eine einzelne Wiedergabeliste zulässig. Fügen Sie zum Übergeben der Referenz-ID einer Wiedergabeliste an einen Player, der nur eine einzelne Wiedergabeliste akzeptiert und mittels ActionScript-Code veröffentlicht wird, den videoList-Parameter zum ActionScript-Veröffentlichungscode hinzu, und stellen Sie der Referenz-ID der Wiedergabeliste ref: voran:
config["@videoList"] = "ref:myPlaylist6789";
Fügen Sie zum Übergeben der Video-ID an den Player, der ein einzelnes Video akzeptiert und mittels HTML eingebettet wird, im HTML-Einbettungscode nach der Player-ID &@videoPlayer=12345 ein. Dabei steht „12345“ für die Video-ID des wiederzugebenden Videos. Dies muss nach beiden Angaben der Player-ID im Einbettungscode hinzugefügt werden.
Beispiel-HTML-Einbettungscode zum Erzwingen der Wiedergabe eines Videos mit der ID „12345“:
<object id="flashObj" width="486"
height="412" classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,47,0">
<param name="movie" value="http://c.brightcove.com/services/viewer/federated_f9/19174954001?isVid=1" />
<param name="bgcolor" value="#FFFFFF" />
<param name="flashVars" value="playerID=12345678900&@videoPlayer=12345&domain=embed&" />
<param name="base" value="http://admin.brightcove.com" />
<param name="seamlesstabbing" value="false" />
<param name="allowFullScreen" value="true" />
<param name="swLiveConnect" value="true" />
<param name="allowScriptAccess" value="always" />
<embed src="http://c.brightcove.com/services/viewer/federated_f9/19174954001?isVid=1"
bgcolor="#FFFFFF" flashVars="playerID=12345678900&@videoPlayer=12345&domain=embed&"
base="http://admin.brightcove.com" name="flashObj" width="486"
height="412" seamlesstabbing="false" type="application/x-shockwave-flash"
allowFullScreen="true" swLiveConnect="true"
allowScriptAccess="always" pluginspage="http://www.macromedia.com/shockwave/download/index.cgi?P1_Prod_Version=ShockwaveFlash">
</embed>
</object>
Fügen Sie zum Übergeben der Referenz-ID eines Videos an einen Player, der ein einzelnes Video akzeptiert und mittels HTML eingebettet wird, im HTML-Einbettungscode nach der Player-ID &@videoPlayer=ref:myVideo12345 ein. Dabei steht „myVideo12345“ für die wiederzugebende Video-ID. Dies muss nach beiden Angaben der Player-ID im Einbettungscode hinzugefügt werden.
Fügen Sie zum Übergeben der Wiedergabelisten-ID an einen Player, der mehrere Wiedergabelisten akzeptiert und mittels HTML eingebettet wird, im HTML-Einbettungscode nach der Player-ID &@playlistTabs=6789 oder &@playlistCombo=6789 ein. Dabei steht „6789“ für die wiederzugebende Wiedergabelisten-ID. Sie können mehrere Wiedergabelisten-IDs übergeben, indem Sie sie durch Kommas trennen: &@playlistTabs=6789,9876,5432
Falls der Player nur eine einzelne Wiedergabeliste akzeptiert, verwenden Sie stattdessen den @videoList-Parameter: &@videoList=6789.
Dies muss nach beiden Angaben der Player-ID im Einbettungscode hinzugefügt werden.
Dies ist ein Beispiel für einen HTML-Einbettungscode zum Erzwingen der Wiedergabe einer Wiedergabeliste mit der ID „6789“:
<object id="flashObj" width="486" height="412"
classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,47,0">
<param name="movie"
value="http://c.brightcove.com/services/viewer/federated_f9/19174954001?isVid=1&isUI=1" />
<param name="bgcolor" value="#FFFFFF" />
<param name="flashVars" value="playerID=12345678900&@playlistTabs=6789&domain=embed&" />
<param name="base" value="http://admin.brightcove.com" />
<param name="seamlesstabbing" value="false" />
<param name="allowFullScreen" value="true" />
<param name="swLiveConnect" value="true" />
<param name="allowScriptAccess" value="always" />
<embed src="http://c.brightcove.com/services/viewer/federated_f9/19174954001?isVid=1&isUI=1"
bgcolor="#FFFFFF" flashVars="playerID=12345678900&@playlistTabs=6789&domain=embed&"
base="http://admin.brightcove.com" name="flashObj"
width="486" height="412" seamlesstabbing="false"
type="application/x-shockwave-flash" allowFullScreen="true"
swLiveConnect="true" allowScriptAccess="always"
pluginspage="http://www.macromedia.com/shockwave/download/index.cgi?P1_Prod_Version=ShockwaveFlash">
</embed>
</object>
Fügen Sie zum Übergeben der Referenz-ID einer Wiedergabeliste an einen Player, der mehrere Wiedergabelisten akzeptiert und mittels HTML eingebettet wird, Folgendes hinzu:
&@playlistTabs=ref:myPlaylist6789 or &@playlistCombo=ref:myPlaylist6789
Fügen Sie diesen Code im HTML-Einbettungscode nach der Player-ID ein. Dabei steht „myPlaylist6789“ für die Referenz-ID der wiederzugebenden Wiedergabeliste. Wenn Sie mehrere Referenz-IDs übergeben möchten, stellen Sie der durch Kommata getrennten Aufzählung der Referenz-IDs ref: voran.
&@playlistTabs=ref:myPlaylist6789,myPlaylist9876,myPlaylist5432
Stellen Sie sicher, dass sich zwischen den durch Kommas getrennten Elementen keine Leerzeichen befinden.
Falls der Player nur eine einzelne Wiedergabeliste akzeptiert, verwenden Sie stattdessen @videoList parameter: &@videoList=ref:myVideo6789.Dies muss nach beiden Angaben der Player-ID im Einbettungscode hinzugefügt werden.
Sie können die Video-ID in die URL eines von Video Cloud gehosteten Players aufnehmen, indem Sie an die Player-URL ?bctid=12345 anhängen. Dabei steht „12345“ für die wiederzugebende Video-ID. Beispiel:
http://link.brightcove.com/services/player/bcpid0789?bctid=12345
Beim Hosten des Players mittels JavaScript-Code auf Ihrer eigenen Website können Sie die URL auch ändern, um die Wiedergabe eines bestimmten Videos zu erzwingen. Hängen Sie ?bctid=12345 an die URL an, unter der der Player gehostet wird. Dabei steht „12345“ für die wiederzugebende Video-ID. Beispiel:
http://www.myexamplesite.com/playerpage.html?bctid=12345
In der Player-URL können Sie anstelle der Video-ID eines Videos dessen Referenz-ID verwenden. Hängen Sie der Player-URL ?bctid=ref:myvid123 an, wobei myvid123 die Referenz-ID des gewünschten Videos ist. Beispiel:
http://link.brightcove.com/services/player/bcpid0789?bctid=ref:myvid123
Beim Hosten des Players mittels JavaScript-Code auf Ihrer eigenen Website können Sie die URL auch ändern, um die Wiedergabe eines bestimmten Videos zu erzwingen. Hängen Sie der Player-URL ?bctid=ref:myvid123 an, wobei myvid123 die Referenz-ID des gewünschten Videos ist. Beispiel:
http://www.myexamplesite.com/playerpage.html?bctid=ref:myvid123
Sie können die Wiedergabelisten-ID in die URL eines von Brightcove gehosteten Players aufnehmen, indem Sie an die Player-URL ?bclid=6789 anhängen. Dabei steht „6789“ für die wiederzugebende Video-ID. Beispiel:
http://link.brightcove.com/services/player/bcpid0789?bclid=6789
Beachten Sie, dass dieser Ansatz nicht zum Aufnehmen mehrerer Wiedergabelisten in einen Player geeignet ist.
Beim Hosten des Players mittels JavaScript-Code auf Ihrer eigenen Website können Sie die URL auch ändern, um die Wiedergabe einer bestimmten Wiedergabliste zu erzwingen. Hängen Sie ?bclid=6789 an die URL an, unter der der Player gehostet wird. Dabei steht „6789“ für die wiederzugebende Wiedergabelisten-ID. Beispiel:
http://www.myexamplesite.com/playerpage.html?bclid=6789
In der Player-URL können Sie anstelle der Wiedergabelisten-ID eines Videos dessen Referenz-ID verwernden. Hängen Sie ?bclid=ref:mylist123 and die Player-URL an, wobei mylist123 die Referenz-ID der gewünschten Wiedergabeliste ist. Beispiel:
http://link.brightcove.com/services/player/bcpid0789?bclid=ref:mylist123
Beim Hosten des Players mittels JavaScript-Code auf Ihrer eigenen Website können Sie die URL auch ändern, um die Wiedergabe einer bestimmten Wiedergabeliste zu erzwingen. Hängen Sie ?bctid=ref:mylist123 and die Player-URL an, wobei mylist123 die Referenz-ID der gewünschten Wiedergabeliste ist. Beispiel:
http://www.myexamplesite.com/playerpage.html?bclid=ref:mylist123
Weitere Informationen zum Zuweisen von Inhalt zu Playern finden Sie im Abschnitt Player programmieren.