Player.ScriptCommand-Ereignis

Das ScriptCommand-Ereignis tritt auf, wenn ein synchronisierter Befehl oder eine synchronisierte URL empfangen wird.

Syntax

Player.ScriptCommand(
  scType,
  Param
)

Parameter

scType

Zeichenfolge, die den Typ des Skriptbefehls angibt.

Param

Zeichenfolge, die den Skriptbefehl angibt.

Rückgabewert

Dieses Ereignis gibt keinen Wert zurück.

Hinweise

Befehle können in die Sounds und Bilder einer Mediendatei oder Windows Stream eingebettet werden. Die Befehle sind ein Paar von Unicode-Zeichenfolgen, die einer festgelegten Zeit im Stream zugeordnet sind. Wenn der Stream die dem Befehl zugeordnete Zeit erreicht, sendet das Windows Media Player-Steuerelement ein ScriptCommand-Ereignis mit zwei Parametern. Ein Parameter gibt den Typ des gesendeten Befehls an, während der andere Parameter den Befehl angibt. Der Typ des Parameters wird verwendet, um zu bestimmen, wie der Befehlsparameter verarbeitet wird. Jeder Befehlstyp kann in eine Datei oder einen Stream eingebettet werden, um vom ScriptCommand-Ereignis behandelt zu werden.

In der folgenden Tabelle werden Skriptbefehlstypen aufgeführt, die automatisch von der Windows Media Player.

type BESCHREIBUNG
CAPTION Das -Steuerelement zeigt den zugeordneten Text in der div an, die durch ClosedCaption angegeben wird. captioningID.
EREIGNIS Weist das Steuerelement an, für das angegebene Ereignis definierte Anweisungen auszuführen.
DATEINAME Das Steuerelement setzt seine URL-Eigenschaft zurück, versucht, die angegebene Datei zu öffnen, und beginnt sofort mit der Wiedergabe des neuen Streams.
OPENEVENT Puffert den zugeordneten EVENT-Typbefehl für die rechtzeitige Ausführung des EVENT-Skripts.
SYNCHRONIZEDLYRICLYRIC Der Parameter Param enthält den synchronisierten Text . Windows Media Player wird der Text im Untertitelbereich des Features Jetzt wieder verwendet angezeigt.
TEXT Das -Steuerelement zeigt den zugeordneten Text in der div an, die durch ClosedCaption angegeben wird. captioningID.
URL Das Steuerelement öffnet automatisch die URL, die mithilfe des Standard-Internetbrowsers angegeben wird, wenn Einstellungen. Die invokeURLs-Eigenschaft ist auf TRUE festgelegt.

Sie können jeden anderen Befehlstyp einbetten, solange Sie reziproken Code zur Handhabung des Befehls bereitstellen. Obwohl unbekannte Befehle vom Steuerelement ignoriert Windows Media Player werden, werden sie weiterhin an das ScriptCommand-Ereignis übergeben.

Url-Befehle, die vom Windows Media Player-Steuerelement empfangen werden, werden automatisch in Ihrem Standardwebbrowser aufgerufen, wenn Einstellungen. Die invokeURLs-Eigenschaft ist auf TRUE festgelegt. Sie können die -Einstellungen. defaultFrame-Eigenschaft, um den Zielframe anzugeben, in dem die Webseite angezeigt wird.

Die url, die an Windows Media Player gesendet wird, wird relativ zur Basis-URL verarbeitet, die vom Einstellungen. baseURL-Eigenschaft. Die Basis-URL wird mit der relativ angegebenen URL verkettet, was zu einer vollständig angegebenen URL führt, die vom ScriptCommand-Ereignis als Befehlsparameter übergeben wird.

Das Windows Media Player verarbeitet eingehende URL-Typbefehle immer wie folgt:

  1. Ein URL-Typbefehl wird empfangen.
  2. Einstellungen. baseURL wird verwendet, um eine vollständige URL aus dem im Skriptbefehl angegebenen relative URL zu erstellen.
  3. ScriptCommand wird aufgerufen.
  4. Nachdem ScriptCommand zurückgegeben wurde, Einstellungen . invokeURLs ist überprüft.
  5. Wenn Einstellungen. invokeURLs ist true, und der Befehl ist ein URL-Typ. Die angegebene URL wird aufgerufen. Wenn Einstellungen. invokeURLs ist false, oder wenn der Befehl kein URL-Typ ist, wird der Befehl ignoriert.

Beim Erstellen einer Windows-Mediendatei können Sie angeben, in welchem Frame die neue URL angezeigt wird, indem Sie zwei ampersands und den Namen des Frames im Parameterfeld verketten. Das folgende Beispiel veranschaulicht typische ScriptCommand-Parameter. Sie gibt an, dass die URL mypage im myframe-Frame gestartet werden muss.

scType = "URL"
Param = https://myweb/mypage.html&&myframe

Das ScriptCommand-Ereignis wird nicht aufgerufen, wenn die Datei gescannt wird (schnell weitergeleitet oder schnell umgekehrt).

Der Wert von Ereignisparametern wird von Windows Media Player angegeben und kann mithilfe des angegebenen Parameternamens auf eine Methode in einer importierten JScript-Datei zugegriffen oder an diese übergeben werden. Dieser Parametername muss genau wie gezeigt typisieren, einschließlich Groß- und Groß-/Schreibanforderungen.

Anforderungen

Anforderung Wert
Version
Windows Media Player Version 7.0 oder höher.
DLL
Wmp.dll

Weitere Informationen

Player-Objekt

Player.URL

Einstellungen.baseURL

Einstellungen.defaultFrame

Einstellungen.invokeURLs