ScriptCommand-Ereignis des AxWindowsMediaPlayer-Objekts

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

[C#]
private void player_ScriptCommand(
  object sender,
  _WMPOCXEvents_ScriptCommandEvent e
)

[Visual Basic]
Private Sub player_ScriptCommand(  
  sender As Object, 
  e As _WMPOCXEvents_ScriptCommandEvent
) Handles player.ScriptCommand

Ereignisdaten

Der diesem Ereignis zugeordnete Handler ist vom Typ AxWMPLib. _ WMPOCXEvents _ ScriptCommandEventHandler. Dieser Handler empfängt ein Argument vom Typ AxWMPLib. _ WMPOCXEvents _ ScriptCommandEvent, das die folgenden Eigenschaften im Zusammenhang mit diesem Ereignis enthält.

Eigenschaft BESCHREIBUNG
scType System.String Gibt den Typ des Skriptbefehls an.
Parameter System.String Gibt den Skriptbefehl an.

Bemerkungen

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 Zeit erreicht, die dem Befehl zugeordnet ist, 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 dem durch IWMPClosedCaption angegebenen HTML-Element an. captioningId.
EREIGNIS Das -Steuerelement führt anweisungen aus, die für das angegebene Ereignis definiert sind.
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 dem durch IWMPClosedCaption angegebenen HTML-Element an. captioningId.
URL Das Steuerelement öffnet automatisch die URL, die mithilfe des Standard-Internetbrowsers angegeben wird, wenn IWMPSettings verwendet wird. Die invokeURLs-Eigenschaft ist auf TRUE festgelegt.

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

Das ScriptCommand-Ereignis wird nicht aufgerufen, wenn die Datei im Modus für schnelles Vorwärts- oder Zurücksenden gescannt wird.

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

Die an die Windows Media Player URL wird relativ zur Basis-URL verarbeitet, die von IWMPSettings angegeben wird. baseURL-Eigenschaft. Die Basis-URL wird mit dem relative URL verkettet, was zu einer vollständig angegebenen URL führt, die vom ScriptCommand-Ereignis als Befehlsparameter übergeben wird.

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

  1. Ein URL-Typbefehl wird empfangen.
  2. IWMPSettings. 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, wird IWMPSettings zurückgegeben. invokeURLs ist überprüft.
  5. Wenn IWMPSettings. invokeURLs ist true, und der Befehl ist ein URL-Befehl. Die angegebene URL wird aufgerufen. Wenn IWMPSettings. invokeURLs ist false, oder wenn der Befehl kein URL-Befehl 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 (schnelles Weitergeleitetes oder erneutes Durchwaschen).

Requirements (Anforderungen)

Anforderung Wert
Version
Windows Media Player 9er Serie oder höher
Namespace
AxWMPLib
Assembly
AxInterop.WMPLib.dll (AxInterop.WMPLib.dll.dll)

Weitere Informationen

AxWindowsMediaPlayer-Objekt (VB und C#)

AxWindowsMediaPlayer.URL (VB und C#)

IWMPClosedCaption.captioningId (VB und C#)

IWMPSettings.baseURL (VB und C#)

IWMPSettings.defaultFrame (VB und C#)

IWMPSettings.invokeURLs (VB und C#)