When the context input is a
playlist, mm-renderer creates additional PPS objects in the context
directory. These PPS objects specify the currently playing item and the items in front
of and behind the current item, up to a preconfigured maximum; this information is
collectively known as the playlist window.
The following PPS objects represent the playlist window:
- p#
- Contains the track parameters for a playlist entry. There is one p#
object for each playlist entry, where the # token is the position of
the track in the playlist (starting from 1). Each such object contains the
latest parameters passed into mmr_track_parameters() for the
corresponding track.
- play-queue
- Represents the size of the playlist window. The play-queue object has
the following attributes:
- start
- The index of the first p# item in the window.
- end
- The index of the last p# item in the window.
- total
- The total number of items in the playlist; this is set whenever the full
length of the playlist is known.
Note:
If you seek to a track outside of the playlist window, the indexes of the first and last
items may retain stale values for a short time after the seek command is issued.
This is because these attributes are updated asynchronously.