OptionalautoPlay playIndex; false only focuses it.
The new content: files, folders or URLs.
OptionalplayRow to play, or to focus with autoPlay false; past the last row, the first one. The rows follow the order of paths: when every path is one track, this is the index of the path to play. A path that expands to several tracks (a folder, a cue sheet) takes that many rows, and a skipped path takes none.
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.
OptionalstopStop playback first, when something is playing.
Parameters for
playlist.replaceAllAndPlay. Replace the whole content of a playlist and play it: stop playback, clear the playlist (saving an undo point), add the paths in the given order asplaylist.addPathsSequentialdoes, make the playlist active and play or focusplayIndex. Unlikeplaylist.addPaths, duplicates are kept and the user's incoming-item order is not applied. Entries longer than 2048 characters, and entries that resolve to nothing, are skipped. When nothing could be added the call fails withNOT_FOUND, and the playlist stays empty. A locked playlist fails withLOCKEDbefore anything changes. The paths are resolved after the clear, as inplaylist.addPaths: a playlist moved meanwhile is still the one filled and played; one removed meanwhile fails withOPERATION_FAILED, and one locked meanwhile fails withLOCKEDand stays empty.