31
Control
T
HIRD
-P
ARTY
C
ONTROL
D
RIVERS
AND
P
LUGINS
Various third party control drivers and plugins, such as QSC, Symetrix, Crestron, AMX, etc., are available. Please
contact
for details.
API C
ONTROL
The MV4 IP Multiviewer is capable of being controlled from a variety of third-party manufacturers, supported systems include
Crestron, Extron, AMX, RTI, QSC and Symterix. The API is a human readable key value pair accessible via, HTTP GET/POST, UDP
unicast, and UDP multicast. Please note that although most of the HTTP examples below are shown as GET for simplicity, use of
POST for HTTP API is recommended. UDP API is more efficient if your control system supports it.
When using the API, it is important to keep in mind that all changes are volatile. This means that without a save, changes will be
lost upon reboot!
All commands start with CMD=START and end with CMD=END to allow multiple key value pairs per command sequence. All keys
and values are case sensitive.
Architecture:
Key Value System
Port/IP Address
Notes
HTTP
Port 80
UDP Socket
Port 8000
Will listen on unicast and multicast
Multicast Address
226.0.0.19
HTTP GET
Port 80
Queries
HTTP POST
Port 80
Set values
&
Separates Key Value Pairs
=
Separates Keys and Values
CMD=START
Start of all commands
CMD=END
End of all commands
HTTP GET:
Require authentication (Default: username=admin, password=admin)
Example Quer
y http://admin:[email protected]/cgibin/wapi.cgi?CMD=START&QUERY.ALL=TRUE&CMD=END
HTTP POST:
Example
: Set decoder to connect to the encoder at 192.168.8.101 and display the stream
1.
URL: http://192.168.8.101/cgi-bin/wapi.cgi
2.
Request Header: "Content-Type", "application/x-www-form-urlencoded"
3.
Request Header: “Authorization”, “Basic “ + Base64EncodedString(“admin:admin”) this evaluates to “Basic
YWRtaW46YWRtaW4=”
4.
Post Data: “CMD=START&UNIT.ID=ALL&STREAM.HOST=192.168.8.101&STREAM.CONNECT=TRUE&CMD=END”
Example
: Flash Unit LEDs
GET:
http://admin:[email protected]/cgi-
bin/wapi.cgi?CMD=START&UNIT.ID=ALL&UNIT.FU=TRUE&CMD=END
