OptionalplaylistPlaylist index; omitted, the active playlist.
OptionalplaylistPersistent unique identifier of a playlist (bracketed GUID, case-insensitive), used in place of a mutable index. Mutually exclusive with playlist; passing both or an invalid format fails with INVALID_PARAMS. Fails with NOT_FOUND if the playlist does not exist, never falling back. Invalid-format and not-found failures return the given GUID in details.playlistGuid.
foobar2000 query, as in the Media Library search; SORT BY is refused.
Parameters for
playlist.getMatchingRows. The rows of a playlist whose tracks match a foobar2000 query, in playlist order, in one call however long the playlist is; read the rows themselves withplaylist.getTracksAt. The query takes the Media Library search syntax withoutSORT BY. A query the parser rejects fails withINVALID_PARAMSanddetails.paramquery, and so does one carryingSORT BY; many malformed queries are not rejected but simply match nothing. An index past the last playlist fails withINVALID_INDEX, aplaylistGuidno playlist has withNOT_FOUND, and with both omitted and no active playlist the call fails withNO_ACTIVE_ITEM. The answer is a snapshot taken on the main thread: editing the playlist or a track's tags can change it, and so can the passing of time for a query such as%added% DURING LAST 2 WEEKS, which no event announces.