Объект мультимедиа

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

Объект Media позволяет указать или извлечь свойства элемента мультимедиа с помощью следующих свойств и методов.

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

Свойство	Описание
attributeCount	Извлекает количество атрибутов, которые можно запросить и (или) задать для элемента мультимедиа.
duration	Извлекает длительность текущего элемента мультимедиа в секундах.
durationString	Извлекает строковое значение, указывающее длительность текущего элемента мультимедиа в формате ЧЧ:ММ:СС.
error	Извлекает объект ErrorItem, если элемент мультимедиа имеет условие ошибки.
imageSourceHeight	Извлекает высоту текущего элемента мультимедиа в пикселях.
imageSourceWidth	Извлекает ширину текущего элемента мультимедиа в пикселях.
markerCount	Извлекает количество маркеров в элементе мультимедиа.
name	Указывает или извлекает имя элемента мультимедиа.
sourceURL	Извлекает URL-адрес элемента мультимедиа.

 

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

Метод	Описание
getAttributeCountByType	Извлекает количество атрибутов, связанных с указанным именем атрибута и языком.
getAttributeName	Извлекает имя атрибута, соответствующего указанному индексу.
getItemInfo	Извлекает значение указанного атрибута для элемента мультимедиа.
getItemInfoByAtom	Извлекает значение атрибута с указанным номером индекса.
getItemInfoByType	Извлекает значение атрибута, соответствующее указанному имени атрибута, языку и индексу.
getMarkerName	Извлекает имя маркера по указанному индексу.
getMarkerTime	Извлекает время маркера по указанному индексу.
isIdentical	Извлекает значение, указывающее, совпадает ли предоставленный объект с текущим.
isMemberOf	Извлекает значение, указывающее, является ли указанный элемент мультимедиа членом указанного списка воспроизведения.
isReadOnlyItem	Извлекает значение, указывающее, можно ли изменять атрибуты указанного элемента мультимедиа.
setItemInfo	Задает значение указанного атрибута для элемента мультимедиа.

 

Доступ к объекту Media осуществляется с помощью следующих свойств и методов.

Объект	Свойство или метод
Элементы управления	Currentitem
Игрок	currentMedia, newMedia
Список воспроизведения	Item

 

Так как это наиболее распространенный способ доступа, игрок. CurrentMedia используется для иллюстрации в разделах синтаксиса ссылок.

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

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