Playlist Clase

Definición

Espacio de nombres:

Windows.Media.Playlists

Proporciona acceso a una lista de reproducción multimedia.

public ref class Playlist sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Media.Playlists.PlaylistsContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Media.Playlists.PlaylistsContract")]
class Playlist final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Media.Playlists.PlaylistsContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Media.Playlists.PlaylistsContract")]
public sealed class Playlist

function Playlist()

Public NotInheritable Class Playlist

Herencia

Object Platform::Object IInspectable Playlist

Atributos

ActivatableAttribute ContractVersionAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows Desktop Extension SDK (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Media.Playlists.PlaylistsContract (se introdujo en la versión v1.0)

Ejemplos

Este ejemplo es un extracto del ejemplo de lista de reproducción. Consulte el ejemplo de la solución completa.

// Create and save a playlist from a set of audio files.
async private void PickAudioButton_Click(object sender, RoutedEventArgs e)
{
    FileOpenPicker picker = MainPage.CreateFilePicker(MainPage.audioExtensions);
    IReadOnlyList<StorageFile> files = await picker.PickMultipleFilesAsync();

    if (files.Count > 0)
    {
        Playlist playlist = new Playlist();

        foreach (StorageFile file in files)
        {
            playlist.Files.Add(file);
        }

        StorageFolder folder = KnownFolders.MusicLibrary;
        string name = "Sample";
        NameCollisionOption collisionOption = NameCollisionOption.ReplaceExisting;
        PlaylistFormat format = PlaylistFormat.WindowsMedia;

        try
        {
            StorageFile savedFile = await playlist.SaveAsAsync(folder, name, collisionOption, format);
            this.rootPage.NotifyUser(savedFile.Name + " was created and saved with " + files.Count + " files.", NotifyType.StatusMessage);
        }
        catch (Exception error)
        {
            rootPage.NotifyUser(error.Message, NotifyType.ErrorMessage);
        }
    }
    else
    {
        rootPage.NotifyUser("No files picked.", NotifyType.ErrorMessage);
    }
}

// Pick playlist and display its contents.
async private void PickPlaylistButton_Click(object sender, RoutedEventArgs e)
{
    Playlist playlist = await PickPlaylistAsync();

    if (playlist != null)
    {
        string result = "Songs in playlist: " + playlist.Files.Count.ToString() + "\n";

        foreach (StorageFile file in playlist.Files)
        {
            MusicProperties properties = await file.Properties.GetMusicPropertiesAsync();
            result += "\n";
            result += "File: " + file.Path + "\n";
            result += "Title: " + properties.Title + "\n";
            result += "Album: " + properties.Album + "\n";
            result += "Artist: " + properties.Artist + "\n";
        }

        this.OutputStatus.Text = result;
    }
}

private async Task<Playlist> PickPlaylistAsync()
{
    FileOpenPicker picker = CreateFilePicker(MainPage.playlistExtensions);
    StorageFile file = await picker.PickSingleFileAsync(); 

    if (file == null)
    {
        NotifyUser("No playlist picked.", NotifyType.ErrorMessage);
        return null;
    }

    try
    {
        return await Playlist.LoadAsync(file);
    }
    catch (Exception ex)
    {
        NotifyUser(ex.Message, NotifyType.ErrorMessage);
        return null;
    }
}

Comentarios

Esta API se usa para guardar y cargar archivos de lista de reproducción hacia y desde el disco. Para obtener información sobre cómo reproducir listas de elementos multimedia, consulta Elementos multimedia, listas de reproducción y pistas.

Constructores

Playlist()

Crea una nueva instancia de un objeto Playlist .

Propiedades

Files

Conjunto de archivos multimedia que componen la lista de reproducción.

Métodos

LoadAsync(IStorageFile)	Carga de forma asincrónica los archivos en una lista de reproducción.
SaveAsAsync(IStorageFolder, String, NameCollisionOption)	Guarda de forma asincrónica la lista de reproducción en un archivo y una carpeta especificados.
SaveAsAsync(IStorageFolder, String, NameCollisionOption, PlaylistFormat)	Guarda de forma asincrónica la lista de reproducción en un archivo y una carpeta especificados, en un formato especificado.
SaveAsync()	Guarda de forma asincrónica la lista de reproducción.

Consulte también

• Ejemplo de lista de reproducción