Group Level [grp]

This request returns the current level of a specified channel group.

URL:

/get.cgi?req=grp&id=<groupID>&p=<playback>

Parameters:

  • id=<groupID>
    • 0 to 99999 specifies the group ID (number).

  • p=<playback> (optional)
    • 0 specifies that the CueServer’s output should be used to query the group’s channels.
    • 1 to 32 specifies that a specific playback should be used to query the group’s channels.
    • If this parameter is omitted, the CueServer’s output will be used to query the group’s channels.

Response:

A 16-bit signed value (in network-byte order) is always returned from this request.

If every channel in the group is set to the same level, that level is returned from zero (0x0000) to 100% (0x00FF).

If the group’s channels have mixed values, then -1 (0xFFFF) is returned.

Errors:

If an error occurs during the processing of the request, the meaning of the returned value is explained in the following table:

Error Value Description
-2 An internal shared memory error occurred.
-3 An invalid parameter was specified.