ASX 元素

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

ASX元素會將檔案定義為中繼檔。

<ASX
   VERSION = "number"
   PREVIEWMODE = "YES" | "NO"
   BANNERBAR = "AUTO" | "FIXED"
>
</ASX>

屬性

VERSION (必要)

十進位數，代表中繼檔語法的版本號碼。 設定為 3 或 3.0。

PREVIEWMODE (選擇性)

值，指出Windows 媒體播放機是否在播放第一個剪輯之前進入預覽模式。

必須是下列其中一個值。

值	描述
YES	Windows 媒體播放機在播放第一個剪輯之前進入預覽模式。
否	預設值。 Windows 媒體播放機播放第一個剪輯之前，不會進入預覽模式。

BANNERBAR (選擇性)

值，指出Windows 媒體播放機是否保留橫幅圖形的空間。

必須是下列其中一個值。

值	描述
AUTO	預設值。 Windows 媒體播放機只有在內容片段包含一個時，才會保留橫幅列的空間。
FIXED	Windows 媒體播放機會保留橫幅圖形的固定空間，以供播放的每個內容片段使用，不論是否有相關聯的橫幅。

父元素/子項目

階層	元素
父元素	無。 ASX元素必須是每個中繼檔中的第一個專案。
子元素	ABSTRACT， AUTHOR， BANNER， BASE， COPYRIGHT， ENTRY， ENTRYREF， EVENT， MOREINFO， PREVIEWDURATION， PARAM， REPEAT， TITLE

備註

中繼檔播放清單的前四個字元必須是 「 < ASX」。 ASX元素範圍中定義的其他元素，例如TITLE和AUTHOR，會與顯示資訊相關聯，Windows 媒體播放機。

針對Windows 媒體播放機，語法版本號碼為 3.0。 Windows 媒體播放機支援所有舊版中繼檔語法。 VERSION屬性可接受的值包括 3.0 和 3 (，且沒有小數點) 。

如果PREVIEWMODE屬性的值是 YES，Windows 媒體播放機會在播放第一個剪輯之前立即進入預覽模式。 當Windows 媒體播放機進入預覽模式時，它會預覽中繼檔中所參考的每個剪輯。 PREVIEWDURATION元素會決定每個預覽的持續時間。

BANNERBAR屬性會定義Windows 媒體播放機是否保留橫幅圖形的空間。 橫幅是在播放媒體內容時顯示在視訊顯示區域中的圖形。 (使用BANNER元素將橫幅新增至 content。) 如果BANNERBAR的值是 FIXED，Windows 媒體播放機保留每個媒體內容的橫幅空間，媒體內容是否有橫幅。 如果某個媒體內容沒有與其相關聯的橫幅，保留給一個內容的空間會是黑色。 如果BANNERBAR屬性的值是 AUTO，Windows 媒體播放機只有在媒體內容包含一個時，才會保留橫幅的空間。

如果您建立多個剪輯的中繼檔 (ENTRY 或 ENTRYREF元素) ，並將BANNERBAR屬性的值設定為 AUTO，Windows 媒體播放機可能會調整大小以允許一個剪輯的橫幅圖形空間，然後在下一個剪輯不包含橫幅圖形時再次調整大小。 如果您希望視窗的大小維持在相同的 (，除非視訊大小變更) ，請使用 BANNERBAR 屬性的 FIXED 值。

保留給橫幅圖形的空間高度為 32 圖元高 194 圖元。 保留空間會出現在任何轉譯的視訊內容下方，而 6 圖元高於視訊區域的下邊緣，允許 6 圖元視訊區域框線的空間。 保留的橫幅空間會水準置中。

Windows 媒體播放機會呈現從橫幅空間最左邊圖元開始的圖形。 如果圖形填滿整個空間，則會以水準方式置中顯示。 否則，將會有尾端空格。 請注意，不論BANNERBAR屬性的值為何，Windows 媒體播放機的最小寬度一律大於視訊剪輯的大小。

範例

<ASX VERSION="3.0" PREVIEWMODE="YES" BANNERBAR="auto"  >
   <ENTRY HREF="https://sample.microsoft.com/sample1.ASX" />
</ASX>

規格需求

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

另請參閱

Windows Media 中繼檔元素參考

Windows Media 中繼檔參考