REF-Element

Artikel
06/21/2023

[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 REF-Element gibt eine URL für digitale Medieninhalte an.

<REF
   HREF = "URL"
>
</REF>

Attribute

HREF (erforderlich)

URL zu medienbezogenen Inhalten, die von Windows Medienwiedergabe unterstützt werden.

Übergeordnete/untergeordnete Elemente

Hierarchy	Elemente
Übergeordnete Elemente	EINTRAG
Untergeordnete Elemente	DURATION, ENDMARKER, PREVIEWDURATION, STARTMARKER, STARTTIME

Bemerkungen

Dieses Element gibt eine URL für einen Medieninhalt an. Die URL kann auf jeden unterstützten Medientyp verweisen, wobei ein beliebiges Protokoll verwendet wird, das von Windows Medienwiedergabe unterstützt wird.

Zu den unterstützten Medientypen gehören Standbilder wie .gif und .jpg Bilder und Flash-Dateien mit der Dateinamenerweiterung ".swf". Diese Medientypen sind nützlich, um Werbeinhalte in eine Wiedergabeliste einzuordnen. Bei Bilddateien und Flashdateien, die in einer Schleife wiedergegeben werden, müssen Sie auch die Zeitspanne zum Anzeigen des Medienelements angeben, indem Sie ein DURATION-Element in das REF-Element einschließen. Wenn ein Bild weiterhin angezeigt werden soll, während der nächste Eintrag in der Wiedergabeliste gepuffert wird, schließen Sie ein PARAM-Element in das ENTRY-Element ein, legen Sie dessen name-Attribut auf ShowWhileBuffering fest, und legen Sie dessen value-Attribut auf true fest.

Um auf Inhalte auf einer CD oder dvd zu verweisen, die dies zulässt, werden die Protokolle wmpcd und wmpdvd bereitgestellt. Wenn Sie beispielsweise das HREF-Attribut auf "wmpdvd://f/5/3" festlegen, wird Kapitel 3 von Titel 5 auf einer DVD wiedergegeben, aber nur, wenn die DVD erstellt wurde, um sie zuzulassen.

Anwendungen, die digitale Medien hinter einer Firewall öffnen, haben eine bessere Leistung beim Öffnen der Medienelemente, wenn die Adresse mithilfe des DNS-Namens (Domain Name Server) anstelle der IP-Adresse angegeben wird.

Dieses Element wird am häufigsten für den URL-Rollover verwendet. Wenn Windows Medienwiedergabe ein in einem REF-Element definiertes Medienelement nicht öffnen kann, versucht es die URL im nächsten REF-Element. Sobald Windows Medienwiedergabe Medieninhalte aus einer URL öffnet, die innerhalb des Bereichs eines ENTRY-Elements definiert ist, werden nachfolgende REF-Tags innerhalb dieses ENTRY-Elements ignoriert. Nachdem die Wiedergabe des Inhalts abgeschlossen ist, wechselt Windows Medienwiedergabe zum nächsten ENTRY-Element, falls vorhanden.

Wichtig Sobald Windows Medienwiedergabe eine Verbindung mit einem Inhalt herstellt, auf den verwiesen wird, werden alle anderen REF-Elemente in diesem ENTRY ignoriert, unabhängig davon, ob die Verbindung normal oder ungewöhnlich beendet wird.

Wenn das Medienelement, auf das verwiesen wird, eine Bilddatei ist, muss das DURATION-Element verwendet werden, um die Anzeigezeit für das Bild anzugeben.

Hinweis

Der Versuch, Flash-Medien mit Sound mit dem ersten Frame wiederzugeben, kann zu unerwarteten Ergebnissen führen. Sie sollten Flash-Inhalte erstellen, um Sound nicht vor dem zweiten Frame wiederzugeben.

Beispiele

<ASX VERSION="3.0">
   <ENTRY>
   <TITLE>Example Clip</TITLE>
      <REF HREF="mms://example.microsoft.com/selection1.asf" />
      <REF HREF="mms://sample.microsoft.com/mirror/selection1.asf" />
   </ENTRY>
</ASX>

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe Version 7.0 oder höher

Siehe auch

Unterstützte Protokolle und Dateitypen
Referenz zu Windows Media-Metafile-Elementen
Windows Media-Metadateireferenz

Share via