REF 元素

  • 發行項

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 它已被 MediaPlayer 取代。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer，而不是Windows 媒體播放機 SDK。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]

REF元素會指定數位媒體內容的 URL。

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

屬性

需要 HREF ()

Windows 媒體播放機所支援之任何媒體內容的 URL。

父元素/子項目

階層 元素
父元素 進入
子元素 DURATION、 ENDMARKER、 PREVIEWDURATION、 STARTMARKER、 STARTTIME

備註

此元素會指定媒體內容的 URL。 URL 可以使用Windows 媒體播放機支援的任何通訊協定，指向任何支援的媒體類型。

支援的媒體類型仍包含影像，例如.gif和.jpg影像，以及副檔名為 ..jpg的 Flash 檔案。 這些媒體類型適用于在播放清單中包含廣告內容。 使用在迴圈中播放的影像檔和 Flash 檔案，您也必須指定在REF元素中包含DURATION元素來顯示媒體專案的時間量。 如果您想要在緩衝處理播放清單中的下一個專案時繼續顯示影像，請在ENTRY元素中包含PARAM元素、將其名稱屬性設定為 ShowWhileBuffering，並將其value屬性設定為 true。

若要參考 CD 或 DVD 上允許它的內容，則會提供 wmpcd 和 wmpmc 通訊協定。 例如，將 HREF 屬性設定為 「wmpdvd://f/5/3」 會在 DVD 上播放標題 5 的第 3 章，但只有當 DVD 已撰寫允許它時。

如果使用功能變數名稱伺服器指定位址， (DNS) 名稱而非 IP 位址，開啟媒體專案時，從防火牆後方開啟數位媒體的應用程式將會有較佳的效能。

此元素最常見的用法是用於 URL 變換。 如果Windows 媒體播放機無法開啟REF元素中定義的媒體片段，它會嘗試下一個REF元素中的 URL。 一旦Windows 媒體播放機從一個ENTRY元素範圍內定義的 URL 開啟媒體內容，它會忽略該ENTRY元素內的後續REF標籤。 完成播放內容之後，如果有的話，Windows 媒體播放機移至下一個 ENTRY元素。

  • 重要一旦Windows 媒體播放機建立與參考內容片段的連線，它會忽略該ENTRY中所有其他REF元素，不論連接正常還是異常終止。

如果參考的媒體專案是影像檔，則必須使用 DURATION 元素來指定影像的顯示時間。

注意

嘗試播放包含第一個畫面的音效的 Flash 媒體可能會產生非預期的結果。 您應該撰寫 Flash 內容，以播放第二個畫面之前不早的音效。

範例

<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>

規格需求

需求 值
版本
 Windows 媒體播放機 7.0 版或更新版本

另請參閱

支援的通訊協定和檔案類型

Windows Media 中繼檔元素參考

Windows Media 中繼檔參考