Método MediaCollection.getByAttribute

[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.]

O método getByAttribute recupera uma playlist de itens de mídia que contêm um valor especificado para um atributo especificado.

Sintaxe

retVal = MediaCollection.getByAttribute(
  attribute,
  value
)

Parâmetros

atributo [in]

Cadeia de caracteres que indica o nome do atributo a ser pesquisado. Para obter informações sobre os atributos compatíveis com Reprodutor Multimídia do Windows, consulte a Referência de atributo Reprodutor Multimídia do Windows.

value [in]

Cadeia de caracteres que indica o valor que o atributo deve ter.

Retornar valor

Esse método retorna um objeto Playlist .

Comentários

Esse método pode ser usado para criar uma consulta genérica para itens de mídia que correspondam a um valor de um atributo no banco de dados. Isso é útil no caso de atributos definidos pelo usuário. Se o atributo não existir, ocorrerá um erro.

Você pode usar esse método para recuperar todos os itens de mídia de um tipo específico. Use o nome do atributo "MediaType" e um dos seguintes valores:

Valor Descrição
áudio Música e outros itens somente áudio.
playlist Playlists representadas como objetos Media .
radio Itens da estação de rádio. Não usado pelo Reprodutor Multimídia do Windows 10.
video Itens de vídeo.
foto Itens de foto. Requer Reprodutor Multimídia do Windows 10.
other Outros itens, como arquivos ASF ou URLs para mídia de streaming.

Para usar esse método, o acesso de leitura à biblioteca é necessário. Para obter mais informações, consulte Acesso à biblioteca.

Exemplos

O exemplo de JScript a seguir usa MediaCollection. getByAttribute para reproduzir todo o conteúdo da biblioteca pelo artista chamado Triode 48. O objeto Player foi criado com ID = "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();

Requisitos

Requisito Valor
Versão
Reprodutor Multimídia do Windows versão 7.0 ou posterior.
DLL
Wmp.dll

Confira também

Objeto MediaCollection

Objeto Playlist

Settings.mediaAccessRights

Settings.requestMediaAccessRights