Метод MediaCollection.getByAlbum

Статья
06/21/2023

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

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

Синтаксис

retVal = MediaCollection.getByAlbum(
  album
)

Параметры

album [in]: Строка , содержащая имя альбома.

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

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

Примеры

В следующем примере используется MediaCollection. getByAlbum для получения списка воспроизведения элементов мультимедиа. Список воспроизведения содержит элементы с альбомом, указанным пользователем в элементе ввода HTML TEXT с именем GetAlbum. Объект Player был создан с идентификатором " Player".

<!-- Use an HTML BUTTON element to create the playlist and 
then play the digital media items. -->
<INPUT TYPE = "BUTTON"
       NAME = "PlayAlbum" 
       ID = "PlayAlbum"  
       VALUE = "Play Album"

onClick = "
    /* Retrieve the album title text from the user. */
    var album = GetAlbum.value;

    /* Create the playlist using getByAlbum. */
    var pl = Player.mediaCollection.getByAlbum(album);

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

    /* Play the media in the new playlist. */
    Player.controls.play();
">

Требования

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

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

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