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:
- Ein URL-Typbefehl wird empfangen.
- IWMPSettings. baseURL wird verwendet, um eine vollständige URL aus dem im Skriptbefehl angegebenen relative URL zu erstellen.
- ScriptCommand wird aufgerufen.
- Nachdem ScriptCommand zurückgegeben wurde, wird IWMPSettings zurückgegeben. invokeURLs ist überprüft.
- 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 |
|