Метод MediaCollection.getByAttribute

Статья
06/21/2023

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

Метод getByAttribute извлекает список воспроизведения элементов мультимедиа, содержащих указанное значение для указанного атрибута.

Синтаксис

retVal = MediaCollection.getByAttribute(
  attribute,
  value
)

Параметры

attribute [in]: Строка , указывающая имя атрибута для поиска. Сведения об атрибутах, поддерживаемых Медиаплеер Windows, см. в справочнике по атрибутам Медиаплеер Windows.
value [in]: Строка , указывающая значение, которое должен иметь атрибут.

Возвращаемое значение

Этот метод возвращает объект playlist .

Этот метод можно использовать для создания универсального запроса к элементам мультимедиа, которые соответствуют значению атрибута в базе данных. Это полезно в случае определяемых пользователем атрибутов. Если атрибут не существует, возникает ошибка.

Этот метод можно использовать для извлечения всех элементов мультимедиа определенного типа. Используйте имя атрибута MediaType и одно из следующих значений:

Значение	Описание
звук	Музыка и другие звуковые элементы.
список воспроизведения	Списки воспроизведения, представленные в виде объектов Мультимедиа .
radio	Элементы радиостанции. Не используется Медиаплеер Windows 10.
видео	Элементы видео.
фотография	Элементы фотографий. Требуется Медиаплеер Windows 10.
иное	Другие элементы, такие как ФАЙЛЫ ASF или URL-адреса для потоковой передачи мультимедиа.

Для использования этого метода требуется доступ на чтение к библиотеке. Дополнительные сведения см. в разделе Доступ к библиотеке.

Примеры

В следующем примере JScript используется MediaCollection. getByAttribute для воспроизведения всего содержимого из библиотеки художником с именем Triode 48. Объект Player был создан с идентификатором " Player".

// Get a playlist object filled with media items by a 
// particular artist.
var pl = Player.mediaCollection.getByAttribute("Artist", "Triode 48");

// Make the new playlist the current one.
Player.currentPlaylist = pl;

// Start Windows Media Player.
Player.controls.play();

Требования

Требование	Значение
Версия	Медиаплеер Windows версии 7.0 или более поздней.
DLL	Wmp.dll

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

Объект MediaCollection
Объект списка воспроизведения
Settings.mediaAccessRights
Settings.requestMediaAccessRights