Parameters for artwork.getMetadata.
Read the album-level tags of a track, plus whether the file embeds any picture and whether it carries a lyrics tag. The tags come from the host's cached track info when complete; a local file it has not read is read from disk, and a remote or unrecognised path keeps whatever the cache has, which can be blank. Without path the playing track is used; with nothing playing the call fails with NO_ACTIVE_ITEM. A path no track can be made for fails with NOT_FOUND, a local file that cannot be read with OPERATION_FAILED. Invalid UTF-8 in returned tag values is replaced with U+FFFD without changing the file. A file that is only in the cloud and not yet downloaded is not opened for the picture check, so hasEmbedded is false.
Parameters for
artwork.getMetadata. Read the album-level tags of a track, plus whether the file embeds any picture and whether it carries a lyrics tag. The tags come from the host's cached track info when complete; a local file it has not read is read from disk, and a remote or unrecognised path keeps whatever the cache has, which can be blank. Withoutpaththe playing track is used; with nothing playing the call fails withNO_ACTIVE_ITEM. A path no track can be made for fails withNOT_FOUND, a local file that cannot be read withOPERATION_FAILED. Invalid UTF-8 in returned tag values is replaced with U+FFFD without changing the file. A file that is only in the cloud and not yet downloaded is not opened for the picture check, sohasEmbeddedisfalse.