ClosedCaption.SAMILang

  • 项目

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

SAMILang 属性指定或检索为隐藏式字幕显示的语言。

player.closedCaption.SAMILang

可能的值

此属性是读/写 字符串。

备注

SAMI 文件可以包含一种或多种语言的文本。 可用于隐藏字幕的语言在 SAMI 文件中的 <STYLE> 和 标记之间定义。 语言标识符使用唯一的字母数字字符串指定，该字符串前面有句点 (.) 。 为语言指定的名称可以是任何字符串。 例如，以下内容可用于定义美国英语：

.ENUSCC {Name:'English Captions' lang: en-US; SAMIType:CC;}

如果未指定 SAMI 语言，则默认使用 SAMI 文件中定义的第一种语言。

使用 ClosedCaption 传递的值。SAMILang 必须与语言说明符中的 Name 属性匹配。

Windows 媒体播放器 10 Mobile：此属性为只读，并且始终返回空字符串。

示例

以下 JScript 示例使用 ClosedCaption。HTML SELECT 元素中的 SAMILang，用于指定闭合描述文字语言。 创建的 Player 对象 ID 为“Player”。

<!-- Create the SELECT element. -->
<SELECT ID = CCLANG  NAME = "CCLANG"  LANGUAGE = "JScript"

     /* Set the closed caption language when the SELECT element changes. */
        onChange = "Player.closedCaption.SAMILang = CCLANG.value;
        ">

        /* Fill in the SELECT element options. */
           <OPTION VALUE = "'Spanish Captions'">Spanish
           <OPTION VALUE = "'Japanese Captions'">Japanese
           <OPTION VALUE = "'English Captions'">English
           <OPTION VALUE = "'French Captions'">French
           <OPTION VALUE = "'German Captions'" SELECTED>German
</SELECT>

要求

要求 值
版本
 Windows 媒体播放器版本 7.0 或更高版本。
DLL
Wmp.dll

另请参阅

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

ClosedCaption 对象