Files, folders, URLs or playlist files; a |subsong:N suffix selects a subsong.
OptionalplaylistIndex of the playlist; omitted, the active playlist. An index past the last playlist fails with INVALID_INDEX; with this omitted and no active playlist the call fails with NO_ACTIVE_ITEM.
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.
Parameters for
playlist.addPathsAsync. Start appending paths to a playlist without waiting: the call returns a receipt, andplaylist:addCompletewith the sameoperationIdreports the outcome. Plain files and URLs are added before the call returns; playlist files (.pls,.m3u,.cueand the like) are expanded in the background. Entries that are empty or longer than 2048 characters are counted ininvalidCount; when no entry is left the call fails withINVALID_PARAMS. A locked playlist fails withLOCKED. The expanded tracks go into the same playlist even if it was moved meanwhile; if it was removed or locked meanwhile they are dropped.