Share via


Sobre os objetos MediaCollection e Media

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

Os objetos MediaCollection e Media regem a coleção de mídia, que define os locais dos arquivos de mídia digital que Reprodutor Multimídia do Windows podem acessar. Você obtém o objeto MediaCollection da propriedade mediaCollection do objeto Player . A propriedade mediaCollection retorna o objeto MediaCollection . Você só pode acessar as propriedades do objeto MediaCollection depois de criá-lo. Por exemplo, para adicionar um objeto Media (uma música), use o seguinte código:

player.mediacollection.add('laure.wma');

Você adicionou o arquivo laure.wma à coleção de mídia.

Você pode obter o objeto Media atual usando a propriedade currentMedia do Player. Por exemplo, esse código obtém a propriedade de duração do objeto Media atual:

myduration = player.currentmedia.duration;

Há muitas maneiras de obter um objeto Media para que você possa acessar suas propriedades. Por exemplo, se você quiser acessar a propriedade de duração da mídia atual, cada uma das seguintes linhas de código poderá ser usada.

Para obter a duração da mídia que está sendo reproduzida no momento:

player.currentMedia.duration;

Para obter a duração da mídia atual em uma playlist:

player.controls.currentItem.duration;

Para obter a duração do terceiro item de mídia em uma playlist:

player.currentPlaylist.item(2).duration;

Para obter a duração do terceiro item de mídia em um gênero "Jazz":

player.mediaCollection.getByGenre("jazz").item(2).duration;

Para obter a duração do terceiro item de mídia na segunda playlist:

player.playlistCollection.getAll.item(1).item(2).duration; 

Objeto Media

Objeto MediaCollection

Modelo de objeto player para linguagens de script