OptionalcueSubsong index that wins over a suffix in path; negative values are ignored.
Track path; a |subsong:N suffix or a trailing #N selects a subsong.
Tags to change, keyed by name. Names are upper-cased, so keys that differ only in case name the same tag. null, an empty string or an empty array removes the tag. A non-empty string array replaces all values of the tag, preserving order, duplicates and whitespace without splitting commas or semicolons. Every array element must be a non-empty string without NUL; an invalid element fails this track with INVALID_PARAMS before any of its tags are queued, with the tag name and zero-based element index in the error. A scalar string is written as it is; an integer or a fraction is written as its decimal text (2.5 becomes 2.500000). Boolean and object values are ignored. File formats and tag writers may limit multivalue support; the completion event reports the final write result.
Parameters for
metadata.write. Queue a tag write to one track and return at once. foobar2000 writes the file in the background and reports the outcome asmetadata:writeComplete, broadcast to every window. A request that leaves nothing to write succeeds without dispatching. A WAV file that would hold non-ASCII tag text after the write is refused withNOT_SUPPORTED(details.reasoniswavInfoNonAscii) and left untouched, because foobar2000 stores WAV tag text as ASCII in the RIFF INFO chunk and turns every other character into?.