Retrieves an app maintained existing playlist or creates a new playlist when no playlist exists.
- iOS 9.3+
- Mac Catalyst 13.0+
- Media Player
The unique identifier for the playlist.
The metadata used when a new playlist is created. When a playlist already exists, this parameter is ignored.
A block that is called after the playlist has been retrieved or created.
Contains the playlist identified by the UUID or the newly created playlist.
If an error occurred, this parameter holds the error object that explains the error. Otherwise, the value of this parameter is
This function retrieves the playlist associated with the UUID. Create a static instance of the UUID using a previously generated UUID. Creating a new UUID using init(uuidString:) to retrieve a playlist does not guarantee that the playlist will be retrieved.
When there is no playlist associated with the UUID, a new playlist is created with the UUID and the creation metadata. The creation metadata parameter is ignored when the playlist already exists.