Объект Player

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

Объект Player является корневым объектом для элемента управления Медиаплеер Windows. Он поддерживает свойства, методы и события, перечисленные в следующих таблицах.

Объект Player поддерживает следующие свойства. Свойства, помеченные звездочкой (*), недоступны для скинов.

Свойство	Описание
cdromCollection	Извлекает объект CdromCollection .
closedCaption	Извлекает объект ClosedCaption .
Элементы управления	Извлекает объект Controls .
currentMedia	Указывает или извлекает текущий объект Media .
currentPlaylist	Указывает или извлекает текущий объект списка воспроизведения .
Dvd	Извлекает объект DVD .
enableContextMenu *	Указывает или извлекает значение, указывающее, следует ли включить контекстное меню, которое появляется при нажатии правой кнопки мыши.
Включен *	Указывает или извлекает значение, указывающее, включен ли элемент управления Медиаплеер Windows.
error	Извлекает объект Error .
Полноэкранный *	Указывает или извлекает значение, указывающее, воспроизводится ли видеосодержимое в полноэкранном режиме.
isOnline	Извлекает значение, указывающее, подключен ли пользователь к сети.
isRemote *	Извлекает значение, указывающее, работает ли элемент управления Медиаплеер Windows в удаленном режиме.
mediaCollection	Извлекает объект MediaCollection .
network	Извлекает объект Network .
openState	Извлекает значение, указывающее состояние источника содержимого.
playerApplication *	Извлекает объект PlayerApplication при выполнении удаленного элемента управления Медиаплеер Windows.
playlistCollection	Извлекает объект PlaylistCollection .
playState	Извлекает значение, указывающее состояние операции Медиаплеер Windows.
параметры	Извлекает объект Settings .
status	Извлекает значение, указывающее текущее состояние Медиаплеер Windows.
stretchToFit *	Указывает или извлекает значение, указывающее, будет ли видео растянуться в соответствии с размером Медиаплеер Windows видеотрансляций элемента управления.
uiMode *	Указывает или извлекает значение, указывающее, какие элементы управления отображаются в пользовательском интерфейсе при внедрении Медиаплеер Windows на веб-страницу.
URL-адрес	Указывает или извлекает имя клипа для воспроизведения.
versionInfo	Извлекает строковое значение, указывающее версию Медиаплеер Windows.
windowlessVideo *	Указывает или извлекает значение, указывающее, отображает ли элемент управления Медиаплеер Windows видео в режиме без окон.

 

* Недоступно для скинов.

Объект Player поддерживает следующие методы.

Метод	Описание
close	Выпуски Медиаплеер Windows ресурсов.
launchURL	Отправляет URL-адрес в браузер пользователя по умолчанию для просмотра.
newMedia	Создает новый объект Media .
newPlaylist	Создает новый объект списка воспроизведения .
openPlayer	Открывает Медиаплеер Windows, используя указанный URL-адрес.

 

Объект Player поддерживает следующие события. События, отмеченные звездочкой (*), недоступны для скинов. Сведения об обработке событий мыши и клавиатуры в скинах см. в разделе Внешние события.

Событие	Описание
AudioLanguageChange	Происходит при изменении текущего языка звука.
ответов	Происходит, когда элемент управления Медиаплеер Windows начинает или заканчивает буферизацию.
CdromMediaChange	Происходит при вставке компакт-диска или DVD-диска в дисковод компакт-дисков или DVD-дисководе или извлечении из них.
Нажмите *	Происходит, когда пользователь нажимает кнопку мыши.
CurrentItemChange	Происходит при элементах управления. Изменения currentItem .
CurrentMediaItemAvailable	Происходит, когда элемент графических метаданных в текущем элементе мультимедиа становится доступным.
CurrentPlaylistChange	Происходит, когда что-то меняется в текущем списке воспроизведения.
CurrentPlaylistItemAvailable	Происходит, когда текущий элемент списка воспроизведения становится доступным.
Отключение	Зарезервировано для последующего использования.
DomainChange	Происходит при изменении домена DVD.
Doubleclick *	Происходит, когда пользователь дважды щелкает кнопку мыши.
DurationUnitChange	Зарезервировано для последующего использования.
EndOfStream	Зарезервировано для последующего использования.
Ошибка	Происходит, когда элемент управления Медиаплеер Windows имеет ошибку.
Keydown *	Вызывается при нажатии клавиши.
Keypress *	Происходит при нажатии и освобождении клавиши.
Keyup *	Вызывается при отпускании клавиши.
MarkerHit	Происходит при достижении маркера.
MediaChange	Происходит при изменении элемента мультимедиа.
MediaCollectionAttributeStringAdded	Происходит при добавлении значения атрибута в библиотеку.
MediaCollectionAttributeStringChanged	Происходит при изменении значения атрибута в библиотеке.
MediaCollectionAttributeStringRemoved	Происходит при удалении значения атрибута из библиотеки.
MediaCollectionChange	Происходит при изменении коллекции мультимедиа.
MediaCollectionMediaAdded	Происходит при добавлении элемента мультимедиа в локальную библиотеку.
MediaCollectionMediaRemoved	Происходит при удалении элемента мультимедиа из локальной библиотеки.
MediaError	Происходит, когда объект Media имеет условие ошибки.
ModeChange	Происходит при изменении режима Медиаплеер Windows.
Mousedown *	Происходит при нажатии кнопки мыши.
Mousemove *	Происходит при перемещении указателя мыши.
Mouseup *	Происходит при отпускании кнопки мыши.
NewStream	Зарезервировано для последующего использования.
OpenPlaylistSwitch	Происходит, когда начинается воспроизведение названия на DVD.
OpenStateChange	Происходит при изменении состояния элемента управления Медиаплеер Windows.
PlaylistChange	Происходит при изменении списка воспроизведения.
PlaylistCollectionChange	Происходит, когда что-то меняется в коллекции списков воспроизведения.
PlaylistCollectionPlaylistAdded	Происходит при добавлении списка воспроизведения в коллекцию списков воспроизведения.
PlaylistCollectionPlaylistRemoved	Происходит при удалении списка воспроизведения из коллекции списков воспроизведения.
PlaylistCollectionPlaylistSetAsDeleted	Зарезервировано для последующего использования.
PlayStateChange	Происходит при изменении состояния воспроизведения элемента управления Медиаплеер Windows.
PositionChange	Происходит при изменении текущей позиции элемента мультимедиа.
ScriptCommand	Происходит при получении синхронизированной команды или URL-адреса.
StatusChange	Происходит при изменении значения свойства состояния .
StringCollectionChange	Происходит при изменении коллекции строк.
Предупреждение	Зарезервировано для последующего использования.

 

* Недоступно для скинов. Сведения об обработке событий мыши и клавиатуры в обложках см. в разделе Обработчики событий окружения.

При внедрении на веб-страницу доступ к объекту Player можно получить с помощью значения идентификатора, указанного в теге OBJECT. В файле определения обложки доступ к нему осуществляется с помощью глобального атрибута проигрывателя . В целях иллюстрации проигрыватель будет использоваться в качестве идентификатора объекта в разделах синтаксиса ссылок.

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

Справочник по объектной модели для создания скриптов