建立中繼檔播放清單

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

您可以使用任何文字編輯器建立播放清單,例如 Microsoft 記事本。 開啟文字編輯器。 輸入您想要實作的腳本專案。 在記事本中輸入完成之後,請使用適當的檔案名和副檔名儲存檔案。 如需延伸模組的詳細資訊,請參閱 中繼檔延伸模組指導方針。 檔案名通常是 Windows 媒體檔案或資料流程的名稱,後面接著副檔名為 .power、.wvx 或 .asx。 例如,如果您的媒體內容是副檔名為 .wma 的 Windows 媒體音訊檔案,請在命名播放清單時使用 .escape 副檔名。 播放清單不得包含任何來自字處理器的格式代碼,例如 Microsoft Word。 若要確定播放清單中未包含任何格式代碼,請將檔案儲存為純文字或 ASCII 檔案。

注意

元素和屬性不區分大小寫。 播放清單中用來定義專案或屬性的文字可以是大寫或小寫,或是兩者的混合。

 

如果專案沒有任何子專案 (修改或包含在另一個元素) 內,則可以在開頭標記結尾使用單一斜線字元 (/) ,在 '' 前面 > ,取代結束記號。 元素的子專案必須出現在該專案的開頭和結束記號之間;否則,它們不是該元素的子專案,而且會忽略或造成播放清單語法中的錯誤。

播放清單的前四個字元必須是 「 < ASX」。 ASX元素會用於所有播放清單中,不論其副檔名為 .element、.wvx 或 .asx。 每個播放清單只能有一個 ASX 元素。 這個專案會將檔案識別為 Windows Media 中繼檔播放清單。 它不會指定播放清單的類型。

ASX元素有三個可能的屬性:

VERSION

VERSION屬性是必要的,而且必須緊接在 ASX元素之後,例如 「 < ASX version = 」3.0」。 > 目前的版本號碼為 3.0。 Windows 媒體播放機支援所有舊版。 VERSION屬性可接受的值包括 3.0 和 3 (,且沒有小數點) 。

PREVIEWMODE

PREVIEWMODE屬性是選擇性的。 它提供另一種機制來指定轉譯剪輯的時間長度。 如果PREVIEWMODE屬性的值是 YES,Windows 媒體播放機將會在元素 PREVIEWDURATION所指定的期間轉譯每個剪輯。 每個剪輯都可以指定 PREVIEWDURATION

BANNERBAR

選擇性的 BANNERBAR屬性會定義Windows 媒體播放機控制項是否保留橫幅圖形的空間。 (使用BANNER元素指定要顯示的圖形。) 如果BANNERBAR的值是 FIXED,Windows 媒體播放機保留顯示和每個剪輯的橫幅空間,不論中繼檔播放清單是否指定顯示或剪輯的橫幅。 這會將Windows 媒體播放機視窗的大小維持在相同的 (,除非視訊大小變更) ,而不論橫幅圖形是否存在。 如果顯示或剪輯沒有與其相關聯的橫幅,保留給一個的空間會是黑色。 如果BANNERBAR屬性的值是 AUTO,Windows 媒體播放機只有在顯示或剪輯包含橫幅時,才會保留橫幅的空間。

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

如需 ASX 元素之三個屬性的詳細資訊,請參閱 ASX 元素的參考專案。

ASX元素包含ENTRY子項目,可定義要存取之媒體檔案的相關資訊。 每個 ENTRY 元素都必須包含 REF 元素,指定要串流處理之媒體檔案的路徑。 ASX元素內必須至少有一個ENTRY 或 ENTRYREF元素。

ASX元素範圍內定義的其他元素,例如TITLEAUTHOR,會與Windows 媒體播放機所顯示的中繼資料相關聯。

最簡單的播放清單是藉由將具有單一REF元素的多個ENTRY元素新增至中繼檔來建立。 中繼檔播放清單中的每個 ENTRY 元素都會依檔案中顯示的順序轉譯,就像使用者手動開啟每個剪輯一樣。

範例程式碼

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

請確定播放清單在 Windows 檔案總管中按兩下即可運作。 Windows 媒體播放機應該會開啟並開始串流媒體內容。 確認播放清單可運作之後,請將它連同網頁一起儲存到網頁伺服器,並透過HREF元素連結至該播放清單,或使用 Windows 媒體播放機OBJECT元素將它內嵌在網頁中。

下列各節包含詳細資訊:

BANNER 元素

範例播放清單

Windows Media 中繼檔元素參考

Windows Media 中繼檔指南