ASX-Element

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

Das ASX-Element definiert eine Datei als Metadatei.

<ASX
   VERSION = "number"
   PREVIEWMODE = "YES" | "NO"
   BANNERBAR = "AUTO" | "FIXED"
>
</ASX>

Attribute

VERSION (erforderlich)

Dezimalzahl, die die Versionsnummer der Syntax für die Metadatei darstellt. Legen Sie auf 3 oder 3.0 fest.

PREVIEWMODE (optional)

Wert, der angibt, ob Windows Medienwiedergabe vor der Wiedergabe des ersten Clips in den Vorschaumodus wechselt.

Dabei muss es sich um einen der folgenden Werte handeln.

Wert	BESCHREIBUNG
YES	Windows Medienwiedergabe wechselt in den Vorschaumodus, bevor der erste Clip wiedergegeben wird.
Nein	Der Standardwert. Windows Medienwiedergabe wechselt nicht in den Vorschaumodus, bevor der erste Clip wiedergegeben wird.

BANNERBAR (optional)

Wert, der angibt, ob Windows Medienwiedergabe Platz für eine Bannergrafik reserviert.

Dabei muss es sich um einen der folgenden Werte handeln.

Wert	BESCHREIBUNG
AUTO	Der Standardwert. Windows Medienwiedergabe reserviert nur Platz für die Bannerleiste, wenn ein Inhalt einen enthält.
FIXED	Windows Medienwiedergabe reserviert einen festen Platz für eine Bannergrafik für jeden wiedergegebenen Inhalt, unabhängig davon, ob ein zugehöriges Banner vorhanden ist.

Übergeordnete/untergeordnete Elemente

Hierarchy	Elemente
Übergeordnete Elemente	Keine. Das ASX-Element muss das erste Element in jeder Metadatei sein.
Untergeordnete Elemente	ABSTRACT, AUTHOR, BANNER, BASE, COPYRIGHT, ENTRY, ENTRYREF, EVENT, MOREINFO, PREVIEWDURATION, PARAM, REPEAT, TITLE

Bemerkungen

Die ersten vier Zeichen einer Metadatei-Wiedergabeliste müssen "<ASX" sein. Andere Elemente, die innerhalb des Bereichs des ASX-Elements definiert sind, z. B. TITLE und AUTHOR, sind den von Windows Medienwiedergabe angezeigten Showinformationen zugeordnet.

Für Windows Medienwiedergabe lautet die Syntaxversionsnummer 3.0. Windows Medienwiedergabe unterstützt alle früheren Versionen der Metadateisyntax. Zulässige Werte für das VERSION-Attribut sind sowohl 3.0 als auch 3 (ohne Dezimaltrennzeichen).

Wenn der Wert des PREVIEWMODE-Attributs JA ist, wechselt Windows Medienwiedergabe sofort in den Vorschaumodus, bevor der erste Clip wiedergegeben wird. Wenn Windows Medienwiedergabe in den Vorschaumodus wechselt, wird jeder Clip, auf den in der Metadatei verwiesen wird, in der Vorschau angezeigt. Das PREVIEWDURATION-Element bestimmt die Dauer jeder Vorschau.

Das BANNERBAR-Attribut definiert, ob Windows Medienwiedergabe Platz für eine Bannergrafik reserviert. Ein Banner ist eine Grafik, die im Videoanzeigebereich angezeigt wird, während Medieninhalte wiedergegeben werden. (Verwenden Sie das BANNER-Element, um dem Inhalt ein Banner hinzuzufügen.) Wenn der Wert von BANNERBAR FIXED lautet, reserviert Windows Medienwiedergabe Bannerspeicherplatz für jeden Medieninhalt, unabhängig davon, ob der Medieninhalt ein Banner enthält. Wenn einem Medieninhalt kein Banner zugeordnet ist, ist der reservierte Speicherplatz schwarz. Wenn der Wert des BANNERBAR-Attributs AUTO ist, reserviert Windows Medienwiedergabe nur Dann Speicherplatz für das Banner, wenn der Medieninhalt einen enthält.

Wenn Sie eine Metadatei mit mehreren Clips (ENTRY- oder ENTRYREF-Elemente) erstellen und den Wert des BANNERBAR-Attributs auf AUTO festlegen, kann Windows Medienwiedergabe die Größe ändern, um Platz für eine Bannergrafik für einen Clip zuzulassen, und dann die Größe erneut ändern, wenn der nächste Clip keine Bannergrafik enthält. Wenn die Größe des Fensters gleich bleiben soll (außer wenn sich die Videogröße ändert), verwenden Sie den FIXED-Wert für das BANNERBAR-Attribut .

Der für eine Bannergrafik reservierte Platz ist 32 Pixel hoch und 194 Pixel breit. Der reservierte Platz wird unter allen gerenderten Videoinhalten und 6 Pixeln über dem unteren Rand des Videobereichs angezeigt, sodass Platz für den Rahmen des 6-Pixel-Videobereichs möglich ist. Der reservierte Bannerbereich wird horizontal zentriert.

Windows Medienwiedergabe rendert die Grafik beginnend im äußersten linken Pixel des Bannerbereichs. Wenn die Grafik den gesamten Raum ausfüllt, wird sie horizontal zentriert angezeigt. Andernfalls gibt es nachgestellten Speicherplatz. Beachten Sie, dass die Mindestbreite von Windows Medienwiedergabe immer größer als die Größe des Videoclips ist, unabhängig vom Wert des BANNERBAR-Attributs.

Beispiele

<ASX VERSION="3.0" PREVIEWMODE="YES" BANNERBAR="auto"  >
   <ENTRY HREF="https://sample.microsoft.com/sample1.ASX" />
</ASX>

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe Version 70 oder höher

Siehe auch

Referenz zu Windows Media-Metafile-Elementen

Windows Media-Metadateireferenz