Playlist Playlist Playlist Playlist Class

Definition

public : sealed class Playlist : IPlaylistpublic sealed class Playlist : IPlaylistPublic NotInheritable Class Playlist Implements IPlaylist// You can use this class in JavaScript.

Attributes

ActivatableAttribute ContractVersionAttribute DualApiPartitionAttribute StaticAttribute ThreadingAttribute

Examples

This example is an excerpt from the Playlist sample. See the sample for the complete solution.

// App namespace.
var PlaylistSample = {};
// Create and save a playlist from a set of audio files.
function scenario1Create() {
    var picker = new Windows.Storage.Pickers.FileOpenPicker();
    picker.suggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.musicLibrary;
    picker.fileTypeFilter.replaceAll(["*"]);

    picker.pickMultipleFilesAsync().then(function (items) {
        PlaylistSample.list = new Windows.Media.Playlists.Playlist();

        items.forEach(function (/*@override*/item) { 
            PlaylistSample.list.files.append(item);
        });

        sdkSample.displayStatus("Playlist sample.wpl created. Choose save location.");
    }, function (error) {
        sdkSample.displayError("Error in picking files.");
    });
}

// Save created playlist.
function scenario1Save() {
    var folderpicker = new Windows.Storage.Pickers.FolderPicker();
    folderpicker.suggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.musicLibrary;
    folderpicker.fileTypeFilter.replaceAll(["*"]);

    folderpicker.pickSingleFolderAsync().then(function (folder) {
        PlaylistSample.list.saveAsAsync(folder, "sample", Windows.Storage.NameCollisionOption.replaceExisting,
                                        Windows.Media.Playlists.PlaylistFormat.windowsMedia).then(function (file) {
            sdkSample.displayStatus("Playlist sample.wpl saved to the " + folder.name + " folder.");
        });

    }, function (error) {
        sdkSample.displayError("Error in picking folder");
    });
}

// Pick playlist and display its contents.
function scenario2Display() {
    var picker = new Windows.Storage.Pickers.FileOpenPicker();
    picker.suggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.musicLibrary;
    picker.fileTypeFilter.replaceAll([".wpl", ".zpl", ".m3u"]);

    picker.pickSingleFileAsync().then(function (/*@override*/item) {
        Windows.Media.Playlists.Playlist.loadAsync(item).then(function (playlist) {
            // Print the name of the playlist.
            var output = "<p>Playlist content</p>";
            var outputdiv = id("scenario2Output");
            outputdiv.innerHTML = "";
            var promises = {};
            var promiseIndex = 0;
            var musicProperties;

            // Request music properties for each file in the playlist.
            playlist.files.forEach(function (file) {
                promises[promiseIndex] = file.properties.getMusicPropertiesAsync();
                promiseIndex++;
            });

            // Print the music properties for each file. Due to the asynchronous
            // nature of the call to retrieve music properties, the data may appear
            // in an order different than the one specified in the original playlist.
            // To guarantee the ordering we use Promise.join with an associative array
            // passed as a parameter, containing an index for each individual promise.
            WinJS.Promise.join(promises).then(function (results) {
                for (var resultIndex = 0; resultIndex < promiseIndex; resultIndex++) {
                    musicProperties = results[resultIndex];
                    output = output + "<p>Title: " + musicProperties.title + "<br/>";
                    output = output + "Album: " + musicProperties.album + "<br/>";
                    output = output + "Artist: " + musicProperties.artist + "</p>";
                    outputdiv.innerHTML = output;
                }
            });
        });

    }, function (error) {
        sdkSample.displayError("Error in picking file.");
    });
}

Remarks

This API is used to save and load playlist files to and from disk. For information about playing lists of media items, see Media items, playlists, and tracks.

public : Playlist()public Playlist()Public Sub New()// You can use this method in JavaScript.

public : IVector<StorageFile> Files { get; }public IList<StorageFile> Files { get; }Public ReadOnly Property Files As IList<StorageFile>// You can use this property in JavaScript.

public : static IAsyncOperation<Playlist> LoadAsync(IStorageFile file)public static IAsyncOperation<Playlist> LoadAsync(IStorageFile file)Public Static Function LoadAsync(file As IStorageFile) As IAsyncOperation( Of Playlist )// You can use this method in JavaScript.

public : IAsyncOperation<StorageFile> SaveAsAsync(IStorageFolder saveLocation, PlatForm::String desiredName, NameCollisionOption option)public IAsyncOperation<StorageFile> SaveAsAsync(IStorageFolder saveLocation, String desiredName, NameCollisionOption option)Public Function SaveAsAsync(saveLocation As IStorageFolder, desiredName As String, option As NameCollisionOption) As IAsyncOperation( Of StorageFile )// You can use this method in JavaScript.

public : IAsyncOperation<StorageFile> SaveAsAsync(IStorageFolder saveLocation, PlatForm::String desiredName, NameCollisionOption option, PlaylistFormat playlistFormat)public IAsyncOperation<StorageFile> SaveAsAsync(IStorageFolder saveLocation, String desiredName, NameCollisionOption option, PlaylistFormat playlistFormat)Public Function SaveAsAsync(saveLocation As IStorageFolder, desiredName As String, option As NameCollisionOption, playlistFormat As PlaylistFormat) As IAsyncOperation( Of StorageFile )// You can use this method in JavaScript.

public : IAsyncAction SaveAsync()public IAsyncAction SaveAsync()Public Function SaveAsync() As IAsyncAction// You can use this method in JavaScript.

See Also

• Playlist sample
• Playlists sample (Windows 10)