Metodo MediaCollection.getByAttribute

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stato sostituito da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer invece di Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il metodo getByAttribute recupera una playlist di elementi multimediali che contengono un valore specificato per un attributo specificato.

Sintassi

retVal = MediaCollection.getByAttribute(
  attribute,
  value
)

Parametri

attributo [in]

Stringa che indica il nome dell'attributo da cercare. Per informazioni sugli attributi supportati da Lettore multimediale Windows, vedere riferimento all'attributo Lettore multimediale Windows.

value [in]

Stringa che indica il valore che l'attributo deve avere.

Valore restituito

Questo metodo restituisce un oggetto Playlist .

Commenti

Questo metodo può essere usato per creare una query generica per gli elementi multimediali che corrispondono a un valore per un attributo nel database. Ciò è utile nel caso di attributi definiti dall'utente. Se l'attributo non esiste, verrà restituito un errore.

È possibile utilizzare questo metodo per recuperare tutti gli elementi multimediali di un tipo specifico. Usare il nome dell'attributo "MediaType" e uno dei valori seguenti:

Valore	Descrizione
Audio	Musica e altri elementi solo audio.
Playlist	Playlist rappresentate come oggetti Multimediali .
radio	Elementi della stazione radio. Non utilizzato da Lettore multimediale Windows 10.
Video	Elementi video.
Foto	Elementi fotografici. Richiede Lettore multimediale Windows 10.
altro	Altri elementi, ad esempio file ASF o URL per lo streaming multimediale.

Per usare questo metodo, è necessario l'accesso in lettura alla libreria. Per altre informazioni, vedere Accesso alla libreria.

Esempio

L'esempio JScript seguente usa MediaCollection. getByAttribute per riprodurre tutto il contenuto della raccolta dall'artista di nome Triode 48. L'oggetto Player è stato creato con 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();

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows versione 7.0 o successiva.
DLL	Wmp.dll

Vedi anche

Oggetto MediaCollection

Oggetto Playlist

Settings.mediaAccessRights

Settings.requestMediaAccessRights