Событие ScriptCommand объекта AxWindowsMediaPlayer

  • Статья

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

Событие ScriptCommand возникает при получении синхронизированной команды или URL-адреса.

[C#]
private void player_ScriptCommand(
  object sender,
  _WMPOCXEvents_ScriptCommandEvent e
)

[Visual Basic]
Private Sub player_ScriptCommand(  
  sender As Object, 
  e As _WMPOCXEvents_ScriptCommandEvent
) Handles player.ScriptCommand

Данные о событиях

Обработчик, связанный с этим событием, имеет тип AxWMPLib._WMPOCXEvents_ScriptCommandEventHandler. Этот обработчик получает аргумент типа AxWMPLib._WMPOCXEvents_ScriptCommandEvent, который содержит следующие свойства, связанные с этим событием.

Свойство Описание
scType System.StringSpecififing тип команды скрипта.
param System.StringSpecififing команда скрипта.

Комментарии

Команды можно внедрять в звуки и изображения файла Или потока Windows Media. Команды представляют собой пару строк Юникода, связанных с назначенным временем в потоке. Когда поток достигает времени, связанного с командой, элемент управления Медиаплеер Windows отправляет событие ScriptCommand с двумя параметрами. Один параметр указывает тип отправляемой команды, а другой — команду. Тип параметра используется для определения способа обработки параметра команды. Любой тип команды можно внедрить в файл или поток для обработки событием ScriptCommand .

В следующей таблице перечислены типы команд скрипта, которые автоматически обрабатываются Медиаплеер Windows.

Тип Описание
CAPTION Элемент управления отображает связанный текст в элементе HTML, заданном параметром IWMPClosedCaption. captioningId.
СОБЫТИЕ Элемент управления выполняет инструкции, определенные для указанного события.
ИМЕНИ ФАЙЛА Элемент управления сбрасывает свойство URL-адреса , пытается открыть указанный файл и немедленно начинает воспроизведение нового потока.
OPENEVENT Буферизует связанную команду типа EVENT для своевременного выполнения скрипта EVENT.
SYNCHRONIZEDLYRICLYRIC Параметр param содержит синхронизированный текст лирики. Медиаплеер Windows отображает текст лирики в закрытой области подпись функции "Воспроизводимый".
TEXT Элемент управления отображает связанный текст в элементе HTML, заданном параметром IWMPClosedCaption. captioningId.
URL-адрес Элемент управления автоматически открывает URL-адрес, указанный в браузере по умолчанию, если используется IWMPSettings. Свойство invokeURLs имеет значение true.

Вы можете внедрить любой другой тип команды, если вы предоставляете код для обработки команды. Хотя неизвестные команды игнорируются элементом управления Медиаплеер Windows, они по-прежнему передаются в событие ScriptCommand.

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

Команды URL-адресов, полученные элементом управления Медиаплеер Windows, автоматически вызываются в веб-браузере по умолчанию, если используется IWMPSettings.Свойство invokeURLs имеет значение true. Можно использовать IWMPSettings. Свойство defaultFrame , указывающее целевой кадр, в котором отображается веб-страница.

URL-адрес, отправляемый Медиаплеер Windows, обрабатывается относительно базового URL-адреса, указанного в IWMPSettings.свойство baseURL. Базовый URL-адрес объединяется с относительным URL-адресом, что приводит к полному указанию URL-адреса, передаваемого в качестве параметра команды событием ScriptCommand .

Элемент управления Медиаплеер Windows всегда обрабатывает входящие команды URL-адреса следующим образом:

  1. Получена команда типа URL-адреса.
  2. IWMPSettings. BaseURL используется для создания полного URL-адреса из относительного URL-адреса, указанного в команде скрипта.
  3. Вызывается ScriptCommand .
  4. После возврата ScriptCommand IWMPSettings. Флажок invokeURLs установлен.
  5. If IWMPSettings. Параметр invokeURLs имеет значение true, а команда является командой URL-адреса, вызывается указанный URL-адрес. If IWMPSettings. Параметр invokeURLs имеет значение false, или если команда не является командой URL-адреса, команда игнорируется.

При создании файла Windows Media можно указать, в каком кадре отображается новый URL-адрес, сцепляя два амперсанда и имя кадра в поле параметра. В следующем примере показаны типичные параметры ScriptCommand . Он указывает, что URL-адрес mypage должен быть запущен в фрейме myframe .

scType = "URL"
Param = https://myweb/mypage.html&&myframe

Событие ScriptCommand не вызывается, если файл сканируется (переадресовываются или перенаправываются повторно).

Требования

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

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

Объект AxWindowsMediaPlayer (VB и C#)

AxWindowsMediaPlayer.URL (VB и C#)

IWMPClosedCaption.captioningId (VB и C#)

IWMPSettings.baseURL (VB и C#)

IWMPSettings.defaultFrame (VB и C#)

IWMPSettings.invokeURLs (VB и C#)