Share via

IWMPClosedCaption：：SAMIFileName 属性

  • 项目

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

SAMIFileName 属性获取或设置包含隐藏式字幕所需信息的文件的名称。

语法

public System.String SAMIFileName {get; set;}


Public Property SAMIFileName As System.String

属性值

System.String，是 SAMI) 文件 (同步可访问媒体交换的名称。

备注

SAMI 文件必须使用 .smi 或 .sami 文件扩展名。

如果不使用 SAMIFileName 设置值，此属性将获取包含与当前媒体项关联的默认文件名或 URL 的 字符串 。 使用 sami URL 参数 指定 SAMI 文件时，或者当 SAMI 文件与数字媒体文件同名时， (文件扩展名) 除外时，可能会自动发生此关联。 如果没有与当前媒体关联的默认 SAMI 文件，此属性将获取零长度字符串 (“”) 。

使用 SAMIFileName 设置值后，该值将一直保留，直到 (设置新值，或者直到使用 sami URL 参数) 打开新的媒体项。 因此，在播放每个新媒体项之前，必须为此属性设置一个新值。 这样，当 (打开下一个媒体项或) 调用 AxWindowsMediaPlayer.close 时，SAMIFileName 的新值将生效。 为 SAMIFileName 指定新值对当前媒体没有影响。

若要使Windows 媒体播放器使用与特定媒体项关联的默认 SAMI 文件，请在播放下一个媒体项之前，将 SAMIFileName 设置为零长度字符串 (“”) 。

要求

要求 值
版本
 Windows 媒体播放器 9 系列或更高版本
命名空间
 WMPLib
程序集
Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

另请参阅

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

AxWindowsMediaPlayer.close

IWMPClosedCaption 接口 (VB 和 C#)

IWMPClosedCaption2 接口 (VB 和 C#)