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 で導入)

例

この例は、 Playlist サンプルからの抜粋です。 完全なソリューションについては、サンプルを参照してください。

// 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 オブジェクトの新しいインスタンスを作成します。

プロパティ

Files

プレイリストを構成するメディア ファイルのセット。

メソッド

LoadAsync(IStorageFile)	ファイルをプレイリストに非同期的に読み込みます。
SaveAsAsync(IStorageFolder, String, NameCollisionOption)	プレイリストを指定したファイルとフォルダーに非同期的に保存します。
SaveAsAsync(IStorageFolder, String, NameCollisionOption, PlaylistFormat)	指定した形式で、指定したファイルとフォルダーにプレイリストを非同期的に保存します。
SaveAsync()	プレイリストを非同期的に保存します。

こちらもご覧ください

• プレイリストのサンプル