MediaLibrary Class
Provides access to songs, playlists, and pictures in the device's media library.
Syntax
'Declaration
Public NotInheritable Class MediaLibrary
Implements IDisposable
public sealed class MediaLibrary : IDisposable
public ref class MediaLibrary sealed : IDisposable
Remarks
MediaLibrary provides the following properties that return media collections: Albums, Artists, Genres, Pictures, Playlists, and Songs. Each property returns a collection object that can be enumerated and indexed. The collection object represents all media of that type in the device's media library.
The media collections do not retrieve or instantiate all media objects immediately. Instead, you can use the collections when needed to retrieve individual media objects such as Song and Artist objects.
Best Practice |
---|
Because MediaLibrary implements the IDisposable interface, instantiation and use of the MediaLibrary object should be enclosed within a using block. |
Example
The following sample fragment demonstrates how to use MediaLibrary to retrieve and play a song.
using System;
using Microsoft.Xna.Framework;
using Microsoft.Xna.Framework.Input;
using Microsoft.Xna.Framework.Media;
namespace MobileSimpleSongPlay
{
static class Program
{
static void Main(string[] args)
{
using(MediaLibrary library = new MediaLibrary())
{
SongCollection songs = library.Songs;
Song song = songs[0];
MediaPlayer.Play(song);
}
while (!GamePad.GetState(PlayerIndex.One).IsButtonDown(Buttons.Back))
{ ; }
}
}
}
Note
You may get an exception when you try to play DRM protected music.
Requirements
Namespace: Microsoft.Xna.Framework.Media
Assembly: Microsoft.Xna.Framework (in microsoft.xna.framework.dll)
See Also
Tasks
Accessing Pictures from a Picture Album
Reference
MediaLibrary Members
Microsoft.Xna.Framework.Media Namespace
Platforms
Windows Phone