System feedback, Feedback trackchange [on/off, Feedback trackchange – Qsonix Integration User Manual

Page 26: On/off

Advertising
background image

Qsonix Integration Guide

Page | 26

Genre

The genre associated with this album.

String(100)

Styles

This is a multi-valued field that returns a delimited list of all styles
associated with this album.

String(512)

Flags

This is a multi-valued field that returns a delimited list of all album flags
associated with this album. Examples of album flags include:

LIVE, INSTRUMENTAL, EXPLICIT LYRICS

String(512)

System Feedback

Qsonix systems are capable of sending a variety of feedback data including playback status, currently
playing track, etc. By default, sending of feedback is turned off and in order to enable data feedback, a
command must be sent specifying the type of feedback desired. Feedback data is divided by purpose into
message types and one or more feedback message types may be turned on simultaneously. Most types of
feedback messages are sent only when necessary (when the data changes). For example, the Playstate
feedback message will be sent whenever the play state of any zone changes. In addition, when a feedback
message type is enabled, a feedback message of each type that is currently enabled will be sent
immediately to report the state at that time. In order to poll the unit for a current status, you can simply re-
initialize the feedback message type again and this initial status message will be sent immediately. This is

convenient since the message will be formatted the same whether it is a response to a poll or is an
unsolicited response by the system as a result of a data change.

Feedback TrackChange

[On/Off]

DESCRIPTION

Enabling this type of feedback will cause feedback messages to be sent when the current track in the
now playing queue changes. Two types of messages will be sent by this type of feedback. One will
return the CURRENTTRACK information and the other will return the NEXTTRACK information. If there

is not a next track in the now playing queue when this feedback occurs, the NEXTTRACK message will
be omitted. In addition, one of each type of message will be sent for each playback zone on the
system. (See response types “CURRENTTRACK” and “NEXTTRACK” below).

PARAMETERS

On/Off

Specifies whether to turn the specified type of feedback on or off. Valid values
include: ON, OFF.

RESPONSE DEFINITIONS

FEEDBACKCURRENTTRACK[ZoneNumber][TrackID][TrackTitle][AlbumTitle][AlbumArtistName]

[SequenceNumber] 

FEEDBACKNEXTTRACK[ZoneNumber][TrackID][TrackTitle][AlbumTitle][AlbumArtistName]

[SequenceNumber] 

ZoneNumber

The number of the zone that this feedback applies to.

uInt8

TrackID

The track ID of the track being returned.

Int32

TrackTitle

The track title.

String(512)

AlbumTitle

The title of the album that the track belongs to.

String(100)

AlbumArtistName The name of the primary artist of the album that the track belongs to.

String(255)

Advertising