关于 SAMI 文件

  • 项目

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

SAMI 文件是文件扩展名为 .smi 或 .sami 的文本文件。 它们包含用于同步隐藏式字幕、副标题和音频说明的文本字符串。 它们还指定Windows 媒体播放器控件用于将关闭描述文字文本与音频或视频内容同步的计时参数。 当数字媒体文件达到 SAMI 文件中指定的时间时，文本会在网页的关闭描述文字显示区域中相应地更改。

除了简单的文本编辑器 (（如 Microsoft 记事本) ），创建 SAMI 文件不需要特殊软件。 SAMI 和 HTML 共享通用元素，例如 和 <BODY> 标记。 与 HTML 中一样，SAMI 文件中使用的标记必须始终成对使用。 例如，BODY 元素以 <BODY> 标记开头，并且必须始终以 </BODY> 标记结尾。

基本 SAMI 文件需要三个基本标记： <SAMI>、 <HEAD>和 <BODY>。

标记 <SAMI> 将文档标识为 SAMI 文档，以便其他应用程序可以识别其文件格式。

在 <HEAD> 和 </HEAD> 标记之间，定义 SAMI 文档的基本准则和其他格式信息，例如文档标题、常规信息和隐藏式字幕的样式属性。 与 HTML 一样，在 HEAD 元素中声明的内容不会显示为输出。

在 和 </BODY> 标记之间<BODY>定义的元素和属性显示用户看到的内容。 在 SAMI 中，BODY 元素包含同步参数和用于隐藏字幕的文本字符串。

STYLE 元素在 HEAD 元素中定义，提供 SAMI 中的附加功能。 在 <STYLE> 和 </STYLE> 标记之间，可以定义多个级联样式表 (CSS) 样式和布局选择器。 可以自定义字体、大小和对齐方式等样式属性，以提供丰富的用户体验，同时提升辅助功能。 例如，定义大文本字体样式类可以提高难以阅读小文本的用户的可读性。 此外，通过定义多个不同的语言类，可以帮助国际用户更好地了解数字媒体内容。

向数字媒体添加隐藏式字幕