创建图元文件播放列表

  • 项目

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能，Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

可以使用任何文本编辑器（如 Microsoft 记事本）创建播放列表。 打开文本编辑器。 键入要实现的脚本条目。 在记事本中键入完成后，使用相应的文件名和文件扩展名保存文件。 有关扩展的详细信息，请参阅 图元文件扩展准则。 通常，文件名是 Windows Media 文件或流的名称，后跟 .wax、.wvx 或 .asx 扩展名。 例如，如果你的媒体内容是扩展名为 .wma 的 Windows Media 音频文件，请在命名播放列表时使用 .wax 扩展名。 播放列表不得包含来自字处理器的任何格式代码，例如 Microsoft Word。 若要确保播放列表中不包含任何格式代码，请将该文件保存为纯文本或 ASCII 文件。

注意

元素和属性不区分大小写。 播放列表中用于定义元素或属性的文本可以是大写或小写，也可以是两者的混合。

 

如果元素没有任何子元素 (修改或包含在另一个元素) 中的子元素，则可以在开始标记的末尾（就在“”>前面）使用单斜杠字符 (/) ，以代替结束标记。 元素的子元素必须出现在该元素的开始标记和结束标记之间;否则，它们不是该元素的子元素，将被忽略或导致播放列表语法错误。

播放列表的前四个字符必须是“<ASX”。 ASX 元素在所有播放列表中使用，无论其扩展名是 .wax、.wvx 还是 .asx。 每个播放列表必须只有一个 ASX 元素。 此元素将文件标识为 Windows Media 图元文件播放列表。 它未指定播放列表的类型。

ASX 元素有三个可能的属性：

VERSION

VERSION 属性是必需的，并且必须紧跟在 ASX 元素之后，例如“<ASX 版本 = ”3.0”。> 当前版本号为 3.0。 Windows 媒体播放器支持所有以前的版本。 VERSION 属性的可接受值包括 3.0 和 3 (，) 没有小数点。

PREVIEWMODE

PREVIEWMODE 属性是可选的。 它提供了另一种机制，用于指定呈现剪辑的时间长度。 如果 PREVIEWMODE 属性的值为 YES，Windows 媒体播放器将在元素 PREVIEWDURATION 指定的持续时间内呈现每个剪辑。 每个剪辑都可以指定 PREVIEWDURATION 。

横幅栏

可选的 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 元素范围内定义的其他元素（如 TITLE 和 AUTHOR）与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 媒体播放器应打开并开始流式传输媒体内容。 确认播放列表正常工作后，将其与网页一起保存到 Web 服务器，并通过 HREF 元素链接到它，或使用 Windows 媒体播放器 OBJECT 元素将其嵌入网页中。

以下部分包含详细信息：

BANNER 元素

示例播放列表

Windows Media 图元文件元素参考

Windows Media 图元文件指南