Erstellen von Metafile-Wiedergabelisten

  • Artikel

[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.]

Sie können eine Wiedergabeliste mit einem beliebigen Text-Editor erstellen, z. B. Microsoft Editor. Öffnen Sie den Text-Editor. Geben Sie die Skripteinträge ein, die Sie implementieren möchten. Nachdem Sie die Eingabe in Editor abgeschlossen haben, speichern Sie die Datei mit einem entsprechenden Dateinamen und einer entsprechenden Dateinamenerweiterung. Weitere Informationen zu Erweiterungen finden Sie unter Richtlinien für Metafileerweiterungen. In der Regel ist der Dateiname der Name der Windows Media-Datei oder des Windows Media-Streams, gefolgt von der Erweiterung .wax, .wvx oder .asx. Wenn es sich bei Ihrem Medieninhalt beispielsweise um eine Windows Media-Audiodatei mit der Erweiterung WMA handelt, verwenden Sie beim Benennen der Wiedergabeliste die Erweiterung .wax. Wiedergabelisten dürfen keine Formatierungscodes aus einer Textverarbeitung enthalten, z. B. Microsoft Word. Um sicherzustellen, dass keine Formatierungscodes in der Wiedergabeliste enthalten sind, speichern Sie die Datei als Nur-Text- oder ASCII-Datei.

Hinweis

Bei Elementen und Attributen wird die Groß-/Kleinschreibung nicht beachtet. Der Text, der in der Wiedergabeliste zum Definieren eines Elements oder Attributs verwendet wird, kann entweder Groß- oder Kleinbuchstaben oder eine Mischung aus beidem sein.

 

Wenn ein Element keine untergeordneten Elemente aufweist (solche, die ändern oder in einem anderen Element enthalten sind), kann anstelle eines schließenden Tags ein einzelner Schrägstrich (/) am Ende des öffnenden Tags direkt vor dem ">" verwendet werden. Untergeordnete Elemente eines Elements müssen zwischen dem öffnenden und schließenden Tag für dieses Element angezeigt werden. Andernfalls sind sie keine untergeordneten Elemente für dieses Element und werden ignoriert oder verursachen einen Fehler in der Syntax der Wiedergabeliste.

Die ersten vier Zeichen einer Wiedergabeliste müssen "<ASX" sein. Das ASX-Element wird in allen Wiedergabelisten verwendet, unabhängig davon, ob die Erweiterung .wax, .wvx oder .asx ist. Pro Wiedergabeliste darf nur ein ASX-Element vorhanden sein. Dieses Element identifiziert die Datei als Windows Media-Metadatei-Wiedergabeliste. Der Typ der Wiedergabeliste wird nicht angegeben.

Das ASX-Element verfügt über drei mögliche Attribute:

VERSION

Das VERSION-Attribut ist erforderlich und muss unmittelbar nach dem ASX-Element folgen, z. B. "<ASX version = "3.0">. Die aktuelle Versionsnummer ist 3.0. Windows Medienwiedergabe unterstützt alle früheren Versionen. Zulässige Werte für das VERSION-Attribut sind sowohl 3.0 als auch 3 (ohne Dezimaltrennzeichen).

PREVIEWMODE

Das PREVIEWMODE-Attribut ist optional. Es bietet einen weiteren Mechanismus, mit dem angegeben wird, wie lange ein Clip gerendert werden soll. Wenn der Wert des PREVIEWMODE-Attributs JA ist, rendert Windows Medienwiedergabe jeden Clip für die vom Element PREVIEWDURATION angegebene Dauer. Für jeden Clip kann eine PREVIEWDURATION angegeben werden.

BANNERLEISTE

Das optionale BANNERBAR-Attribut definiert, ob das Windows Medienwiedergabe-Steuerelement Platz für eine Bannergrafik reserviert. (Verwenden Sie das BANNER-Element, um die anzuzeigende Grafik anzugeben.) Wenn der Wert von BANNERBAR FIXED lautet, reserviert Windows Medienwiedergabe Bannerspeicherplatz für die Show und für jeden Clip, unabhängig davon, ob die Metadatei-Wiedergabeliste ein Banner für die Show oder den Clip angibt. Dadurch bleibt die Größe des Windows Medienwiedergabe-Fensters gleich (außer wenn sich die Videogröße ändert), unabhängig vom Fehlen oder Vorhandensein einer Bannergrafik. Wenn der Show oder dem Clip kein Banner zugeordnet ist, ist der reservierte Platz schwarz. Wenn der Wert des BANNERBAR-Attributs AUTO ist, reserviert Windows Medienwiedergabe nur Platz für das Banner, wenn die Show oder der Clip eins enthält.

<ASX version="3.0" BANNERBAR="AUTO" >

Weitere Informationen zu den drei Attributen des ASX-Elements finden Sie im Referenzeintrag für das ASX-Element.

Ein ASX-Element enthält untergeordnete ENTRY-Elemente , die Informationen zu den Mediendateien definieren, auf die zugegriffen werden soll. Jedes ENTRY-Element muss ein REF-Element enthalten, das den Pfad zu der zu streamenden Mediendatei angibt. Es muss mindestens ein ENTRY- oder ENTRYREF-Element in einem ASX-Element vorhanden sein.

Andere Elemente, die innerhalb des Bereichs des ASX-Elements definiert sind, z. B. TITLE und AUTHOR, sind den von Windows Medienwiedergabe angezeigten Metadaten zugeordnet.

Die einfachsten Wiedergabelisten werden erstellt, indem mehrere ENTRY-Elemente mit einem einzelnen REF-Element zu einer Metadatei hinzugefügt werden. Jedes ENTRY-Element in einer Metadatei-Wiedergabeliste wird in der Reihenfolge gerendert, in der es in der Datei angezeigt wird, als ob der Benutzer jeden Clip manuell geöffnet hätte.

Beispielcode

<ASX version = "3.0">
<!--A simple playlist with entries to be played in sequence.-->
    <Title>The Show Title</Title>
    <Entry>
        <Ref href = "mms://adventure-works.com/Path/title1.wma" />
    </Entry>
    <Entry>
        <Ref href = "mms://adventure-works.com/Path/title2.wma" />
    </Entry>
    <Entry>
        <Ref href = "mms://adventure-works.com/Path/title3.wma" />
    </Entry>
</ASX>

Stellen Sie sicher, dass die Wiedergabeliste funktioniert, indem Sie in Windows Explorer darauf doppelklicken. Windows Medienwiedergabe sollte geöffnet werden und mit dem Streaming des Medieninhalts beginnen. Nachdem Sie bestätigt haben, dass die Wiedergabeliste funktioniert, speichern Sie sie zusammen mit Ihren Webseiten auf Ihrem Webserver, und verknüpfen Sie sie mithilfe eines HREF-Elements, oder betten Sie sie mithilfe des Windows Medienwiedergabe OBJECT-Elements in eine Webseite ein.

Die folgenden Abschnitte enthalten weitere Informationen:

BANNER-Element

Beispiel-Wiedergabelisten

Referenz zu Windows Media-Metafile-Elementen

Windows Media-Metadateihandbuch