Share via

Свойство IWMPClosedCaption::SAMIFileName

  • Статья

[Функция, связанная с этой страницей, Медиаплеер Windows SDK, является устаревшей функцией. Он был заменен MediaPlayer. MediaPlayer оптимизирован для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует по возможности использовать MediaPlayer вместо пакета SDK для Медиаплеер Windows. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Свойство SAMIFileName получает или задает имя файла, содержащего сведения, необходимые для создания скрытых субтитров.

Синтаксис

public System.String SAMIFileName {get; set;}


Public Property SAMIFileName As System.String

Значение свойства

System.String, который является именем синхронизированного файла SAMI.

Комментарии

Файл SAMI должен использовать расширение SMI или SAMI.

Если значение не задано с помощью SAMIFileName, это свойство получает строку , содержащую имя файла или URL-адрес по умолчанию, связанный с текущим элементом мультимедиа. Эта связь может возникать, если файл SAMI указан с помощью параметра SAMI URL-адреса или автоматически, если файл SAMI имеет то же имя, что и файл цифрового носителя (за исключением расширения имени файла). Если с текущим носителем не связан файл SAMI по умолчанию, это свойство получает строку нулевой длины ("").

После задания значения с помощью SAMIFileName это значение сохраняется до тех пор, пока вы не задаете новое значение (или пока не откроется новый элемент мультимедиа с помощью параметра sami URL). Поэтому перед воспроизведением каждого нового элемента мультимедиа для этого свойства необходимо задать новое значение. Таким образом, новое значение SAMIFileName вступит в силу при открытии следующего элемента мультимедиа (или при вызове AxWindowsMediaPlayer.close ). Указание нового значения для SAMIFileName не влияет на текущий носитель.

Чтобы Медиаплеер Windows использовать файл SAMI по умолчанию, связанный с определенным элементом мультимедиа, задайте для SAMIFileName строку нулевой длины (""), прежде чем воспроизводить следующий элемент мультимедиа.

Требования

Требование Значение
Версия
 Медиаплеер Windows серии 9 или более поздней версии
Пространство имен
 WMPLib
Сборка
Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

См. также раздел

Добавление скрытых субтитров в цифровой носитель

AxWindowsMediaPlayer.close

Интерфейс IWMPClosedCaption (VB и C#)

Интерфейс IWMPClosedCaption2 (VB и C#)