EVENT-Element

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von Windows Medienwiedergabe SDK zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Das EVENT-Element definiert ein Verhalten oder eine Aktion, die von Windows Medienwiedergabe ausgeführt wird, wenn es einen Skriptbefehl empfängt, der als Ereignis bezeichnet wird.

<EVENT   
   NAME = "text string"
   WHENDONE = "RESUME" | "NEXT" | "BREAK"
>
</EVENT>

Attribute

NAME (erforderlich)

Der Name des Ereignisses.

WHENDONE (erforderlich)

Ein Wert, der definiert, was Windows Medienwiedergabe nach der Wiedergabe des Inhalts ausführt, auf den verwiesen wird.

Die folgenden Werte sind möglich.

Wert	Beschreibung
RESUME	Der aktuelle Eintrag (der vom Ereignis unterbrochene Clip) wird wieder wiedergegeben. Wenn der Inhalt gespeichert ist, wird er an dem Punkt fortgesetzt, an dem er angehalten wurde. wenn der Inhalt gesendet wird, wird er an der aktuellen Position fortgesetzt.
NEXT	Das nächste ENTRY-Element wird so wiedergegeben, als ob das Ereignis nicht aufgetreten wäre und Windows Medienwiedergabe das Ende des aktuellen Clips erreicht hätte.
BREAK	Wenn sich der aktuelle Eintrag in einer REPEAT-Schleife befindet, wird die Schleife so beendet, als wäre die Wiederholungsanzahl abgeschlossen worden. Andernfalls springt Windows Medienwiedergabe an das Ende der Wiedergabeliste, als ob der endgültige Eintrag wie gewohnt abgeschlossen wäre.

Übergeordnete/untergeordnete Elemente

Hierarchy	Elemente
Übergeordnete Elemente	ASX
Untergeordnete Elemente	ENTRY, ENTRYREF

Bemerkungen

Dieses Element definiert ein Verhalten oder eine Aktion, die von Windows Medienwiedergabe ausgeführt wird, wenn es einen Skriptbefehl empfängt, der als Ereignis bezeichnet wird. Ein Ereignis ist ein bestimmter Typ von Skriptbefehlen, der in einen Stream eingebettet ist, der an Windows Medienwiedergabe gesendet wird und aus einer Doppelzeichenfolge besteht. Die erste Zeichenfolge ist das Wort "event", und die zweite Zeichenfolge ist der Ereignisname. Der Ereignisname in der zweiten Zeichenfolge muss mit dem in der Metadatei definierten Ereignisnamen übereinstimmen. (Bei der Übereinstimmung wird die Groß-/Kleinschreibung nicht beachtet.) Ereignisse können an Windows Medienwiedergabe gesendet werden, die einen Echtzeitdatenstrom empfangen, oder in einer ASF-, WMA- oder WMV-Datei gespeichert werden, die als Bedarfs-Unicaststream übermittelt wird. Wenn Windows Medienwiedergabe den Skriptbefehl empfängt, verarbeitet es das Ereignis wie durch das EVENT-Element definiert.

Dieses Element definiert einen Bereich von ENTRY- oder ENTRYREF-Elementen, die verarbeitet werden, wenn Windows Medienwiedergabe den Skriptbefehl mit dem benannten Ereignis empfängt. ENTRYREF kann eine URL sein, die auf eine ASP-Seite verweist. Mit diesem Element können Sie ein Verhalten für den Streamwechsel nahezu in Echtzeit angeben, im Gegensatz zu vorab erstellten Streamänderungen mithilfe von Verweisen auf andere Inhalte oder Windows Media-Metadateien.

Wenn Sie ASP-Seiten zum Generieren von Wiedergabelisten verwenden, müssen Sie einen Wert für die Antwort angeben. Die ContentType-Eigenschaft und die Antwort. läuft auf der ASP-Seite aufgrund von Latenzproblemen mit Windows Medienwiedergabe ab. Die Antwort. ContentType muss eine gültige Dateinamenerweiterung für Windows Media-Metadateien sein. Gültige Typen sind .asf, .asx, .wma, .wax, .wmv und .wvx.

Weitere Informationen zur Verwendung des Response-Objekts in ASP finden Sie im Platform SDK.

Dieses Element kann an einer beliebigen Stelle innerhalb des ASX-Elements angezeigt werden. Wenn mehrere EVENT-Elemente innerhalb eines ASX-Elements identische Werte für ihre NAME-Attribute aufweisen, verwendet Windows Medienwiedergabe das erste Vorkommen innerhalb des ASX-Elements und ignoriert alle anderen Elemente. Wenn EVENT-Elemente über unterschiedliche NAME-Attribute verfügen, spielt ihre Reihenfolge innerhalb des ASX-Elements keine Rolle.

Windows Medienwiedergabe verwirft Ereignisse, die beim Verarbeiten eines anderen Ereignisses empfangen werden. Das Schachteln von Ereignissen wird nicht unterstützt. Wenn Windows Medienwiedergabe sich im Vorschaumodus befindet, wird der Ereignisinhalt nicht durch das PREVIEWDURATION-Element eingeschränkt. Die gesamte Länge des Ereignisinhalts kann auch dann wiedergegeben werden, wenn die Vorschaudauer für das aktive ENTRY-Element vor dem Ende des Ereignisses abläuft.

Beispiele

Wenn Windows Medienwiedergabe in diesem Beispiel den Skriptbefehl EVENT und die Befehlszeichenfolge "Adlink" in den Streamingmedien empfängt, die es rendert, durchsucht es die Wiedergabeliste nach einem EVENTNAME "Adlink". Windows Medienwiedergabe wechselt aus dem gerenderten Stream und gibt den Inhalt wieder, auf den im EVENT "https://example.microsoft.com/adlink.htm"" verwiesen wird.

ENTRY-AttributCLIENTSKIP ist auf NO festgelegt, um zu verhindern, dass der EVENT-Clip übersprungen wird. Es muss gespielt werden.

Das Skript WHENDONE="RESUME" weist Windows Medienwiedergabe an, die Wiedergabe der vorherigen Medien fortzusetzen, von dem es gewechselt wurde, sobald Adlink.asf abgeschlossen ist.

<ASX VERSION="3.0">
<ENTRY CLIENTSKIP="NO">
   <REF HREF="https://example.microsoft.com/clip1.asf" />
</ENTRY>
<EVENT NAME="Adlink" WHENDONE="RESUME">
   <ENTRYREF HREF="https://example.microsoft.com/adlink.htm" 
       CLIENTSKIP="NO" />
</EVENT>
</ASX>

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe Version 7.0 oder höher

Siehe auch

Referenz zu Windows Media-Metadateielementen

Windows Media-Metadateireferenz

Windows Medienwiedergabe Objektmodell