SAMI 文件示例

  • 项目

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

下面的示例代码是一个完整的 SAMI 文件，其中包含一组封闭的描述文字文本和多个针对文本样式和描述文字语言的类声明。

<SAMI>
<HEAD>
   <STYLE TYPE = "text/css">
   <!--
   /* P defines the basic style selector for closed caption paragraph text */
   P {font-family:sans-serif; color:white;}
   /* Source, Small, and Big define additional ID selectors for closed caption text */
   #Source {color: orange; font-family: arial; font-size: 12pt;}
   #Small {Name: SmallTxt; font-size: 8pt; color: yellow;}
   #Big {Name: BigTxt; font-size: 12pt; color: magenta;}
   /* ENUSCC and FRFRCC define language class selectors for closed caption text */
   .ENUSCC {Name: 'English Captions'; lang: en-US; SAMIType: CC;}
   .FRFRCC {Name: 'French Captions'; lang: fr-FR; SAMIType: CC;}
   -->
   </STYLE>
</HEAD>
<BODY>
   <!<entity type="mdash"/>- The closed caption text displays at 1000 milliseconds. -->
   <SYNC Start = 1000>
      <!-- English closed captions -->
      <P Class = ENUSCC ID = Source>Narrator
      <P Class = ENUSCC>Great reason to visit Seattle, brought to you by two out-of-staters.
      <!-- French closed captions -->
      <P Class = FRFRCC ID = Source>Narrateur
      <P Class = FRFRCC>Deux personnes ne venant la r&eacute;gion vous donnent de bonnes raisons de visiter Seattle.
</BODY>
</SAMI>

在 SAMI 文件中定义的样式符合元素、类和 ID 的标准 CSS 选择器语法。 在 BODY 元素中，所有 P 元素都具有为 STYLE 元素中的 P 元素选择器定义的样式。 元素的 class 属性指定 STYLE 元素中的类选择器定义的该元素的语言， (以句点) 开头的选择器。 类选择器指定的语言名称可以是任何字符串。 指定了 ID 属性的元素应用了其他样式，如 STYLE 元素中的 ID 选择器 () 带有 # 字符前缀的选择器所示。

与 Windows 媒体播放器 对象模型结合使用时，类选择器对应于 ClosedCaption。SAMILang 属性，可用于指定标题的语言。 ID 选择器对应于 ClosedCaption。SAMIStyle 属性，可用于指定标题的显示样式。

有关创建 SAMI 文件的详细信息，请参阅 Microsoft 网站上的了解 SAMI 1.0。

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