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 |
|
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: ao longo de 2024, vamos eliminar problemas do GitHub como o mecanismo de comentários para conteúdo e substituí-lo por um novo sistema de comentários. Para obter mais informações, consulte:Enviar e exibir comentários de