Attributes
General information about attributes
ID values: Radiccio follows the spec and uses integer IDs for music folders, and string IDs for all other types.
Integer ID values: Music folder IDs in Radiccio are non-sequential, and will continue to identify the same folder even after folders have been added, removed, or rearranged by the user. Your client should be able to handle a 32-bit integer (in the range 0 to 2_147_483_647). For your convenience, we limit it to the positive signed range even though we do not use negative numbers, so you can use a signed or unsigned, 32-bit or 64-bit integer. A 16-bit integer or smaller is not sufficient.
String ID values: String IDs in Radiccio contain non-numeric characters and therefore must not be converted to numeric values. Players must be able to handle IDs as such, and must provide the IDs in requests exactly as they were given in responses.
Empty strings: The spec says that servers should send blank values, such as the empty string, to indicate which properties they support, even if no data is present. Radiccio does not send empty strings under any circumstances (except to indicate when something like an ID3 tag is set to a literal empty string). Instead, we use extensions to indicate support, or absence of support, for various features.
Null values: Radiccio (both client and server) consider a null value as equivalent to the absence of a value, and makes no distinction between the two. Null values will typically be omitted from server responses.
starred: Radiccio does not keep track of when the user marked an item as favorite (starred). If an item is a favorite (starred), Radiccio always returns the date 1970-01-01T00:00:00Z. If the item is not a favorite, the value will be null or absent.
Extra attributes
These attributes are added to existing OpenSubsonic entities. When they have an extension associated with them, this is noted; not all of them have a corresponding extension.
NOTE: Radiccio’s extra attributes are available in JSON only, not XML. These will be absent from the XML.
subsonic-response
| Name | Type | Req. | Extension | Notes |
|---|---|---|---|---|
radiccio | RadiccioResponseMetadata | No | none |
MusicFolder
| Name | Type | Req. | Extension | Notes |
|---|---|---|---|---|
radiccio | RadiccioMusicFolderMetadata | No | none |
AlbumID3
| Name | Type | Req. | Extension | Notes |
|---|---|---|---|---|
radiccio | RadiccioAlbumMetadata | No | Various |
ArtistID3
| Name | Type | Req. | Extension | Notes |
|---|---|---|---|---|
radiccio | RadiccioArtistMetadata | No | Various |
Child (song)
| Name | Type | Req. | Extension | Notes |
|---|---|---|---|---|
radiccio | RadiccioSongMetadata | No | Various |
Playlist
| Name | Type | Req. | Extension | Notes |
|---|---|---|---|---|
radiccio | RadiccioPlaylistMetadata | Yes | nested |