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 元素向内容添加横幅。) 如果 BANNERBAR 的值已固定，Windows 媒体播放器会为每个媒体内容保留横幅空间，无论媒体内容是否具有横幅。 如果一段媒体内容没有与之关联的横幅，则为其中一个内容保留的空间为黑色。 如果 BANNERBAR 属性的值为 AUTO，Windows 媒体播放器仅在媒体内容包含一个时为横幅保留空间。

如果创建包含多个剪辑的图元文件 (ENTRY 或 ENTRYREF 元素) 并将 BANNERBAR 属性的值设置为 AUTO，Windows 媒体播放器可能会调整大小以允许一个剪辑的横幅图形空间，然后在下一个剪辑不包含横幅图形时再次调整大小。 如果希望窗口大小保持相同的 (，除非视频大小) 更改，请使用 BANNERBAR 属性的 FIXED 值。

为横幅图形保留的空间为 32 像素高 x 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 图元文件参考