Playlist 클래스

정의

네임스페이스:

Windows.Media.Playlists

미디어 재생 목록에 대한 액세스를 제공합니다.

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

상속

Object Platform::Object IInspectable Playlist

특성

ActivatableAttribute ContractVersionAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows Desktop Extension SDK (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Media.Playlists.PlaylistsContract (v1.0에서 도입되었습니다.)

예제

이 예제는 재생 목록 샘플에서 발췌한 것입니다. 전체 솔루션은 샘플을 참조하세요.

// 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;
    }
}

설명

이 API는 디스크에서 재생 목록 파일을 저장하고 로드하는 데 사용됩니다. 미디어 항목 목록을 재생하는 방법에 대한 자세한 내용은 미디어 항목, 재생 목록 및 트랙을 참조하세요.

생성자

Playlist()

Playlist 개체의 새 instance 만듭니다.

속성

Files

재생 목록을 구성하는 미디어 파일 집합입니다.

메서드

LoadAsync(IStorageFile)	파일을 재생 목록에 비동기적으로 로드합니다.
SaveAsAsync(IStorageFolder, String, NameCollisionOption)	재생 목록을 지정된 파일 및 폴더에 비동기적으로 저장합니다.
SaveAsAsync(IStorageFolder, String, NameCollisionOption, PlaylistFormat)	재생 목록을 지정된 파일 및 폴더에 지정된 형식으로 비동기적으로 저장합니다.
SaveAsync()	재생 목록을 비동기적으로 저장합니다.

추가 정보

• 재생 목록 샘플