Share via


reference 元素 (已被取代)

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

本主題記載了目前版本的 Windows 媒體中繼檔不再使用的功能。

reference元素包含 URL 的參考清單。 清單中的每個專案都有 Ref XXURL格式,其中XX = 是整數,而 URL是進階系統格式的 URL (ASF) 檔案。

語法

[reference]
RefXX = URL
RefXX = URL
   
<entity type="hellip"/>

以 XX表示的整數必須以遞增順序表示。 也就是說,每一行中的整數必須大於前一行的整數。

當用戶端程式讀取參考專案時,它會嘗試連線到清單中第一個 URL 所代表的媒體檔案。 如果失敗,用戶端程式會嘗試連線到清單中下一個 URL 所代表的檔案。 用戶端程式會繼續向下清單,直到它成功連線或到達清單結尾為止。 請注意,如果用戶端程式成功連線,它就不會讀取清單中任何後續 URL。

範例程式碼

在下列範例中,用戶端程式會先嘗試連線到 mms URL 所代表的檔案。 如果失敗,用戶端程式會嘗試連線到 HTTP URL 所代表的檔案。

[reference]
Ref01 = mms://example.com/MusicFile.wma
Ref02 = https://example.com/MusicFile.wma

備註

ASF 檔案格式包含各種不同的媒體類型,包括音訊和視訊。 ASF 檔案也會使用數個不同的副檔名,包括 .wma 和 .wmv。

以 XX表示的整數必須以遞增順序表示。 也就是說,每一行中的整數必須大於前一行的整數。

當用戶端程式讀取參考專案時,它會嘗試連線到清單中第一個 URL 所代表的媒體檔案。 如果失敗,用戶端程式會嘗試連線到清單中下一個 URL 所代表的檔案。 用戶端程式會繼續向下清單,直到它成功連線或到達清單結尾為止。 請注意,如果用戶端程式成功連線,它就不會讀取清單中任何後續 URL。

舊版 Windows Media 中繼檔 (已被取代)