SOUND4 Plugin Host Library [1.0.2]
JSON syntax

JSON protocol to configure the process

Commands

{ "get" : `object` }

get values.
If object is null, get all parameters, and so show the possibilities

{ "set" : `object` }

set values.
object can be any subpart, only those will be changed

{ "change" : `object` }

like get, but shows only changes since last request.
If object is null, get all changes.
Each call resets the state for this connection to current.

See also JSON syntax for internal setup

Answers

Answer is also a JSON object, starting with the command for get and change.

{ "get" : ... }
{ "change" : ... }

For other commands, if there is no error the answer is

{ "OK" : {"command" : "original command" } }

If there is an error, answer has the syntax

{ "ERROR" : {"command" : "faulty command", "message" : "explaining"} }

and may have more properties. The message may be empty.

Examples

Get status

{"get":{"status":null}}

answer:

{"get":{"status":{"preset_changed":false,"license_valid":true,"version":"1.1.19"}}}

Get all changes since last request

{"change":null}

answer:

{"change":{
"processorname":"Best Radio of the world",
"settings":{"general":{"operate":true},...},
"preset":{"setup": {"gate_on": true, ...},...},
"vu":{"setup": null,"in":{...}},
...
}

Set Processor name

{"set":{"processorname":"Best Radio of the world"}}

answer:

{"OK":"set"}

Set input gain

{"set":{"settings":{"gain":{"in":-3.0}}}}

answer:

{"OK":"set"}

Set bypass

{"set":{"settings":{"general":{"operate":false}}}}

answer:

{"OK":"set"}