Table of Contents
Advertisement
Integrator's Reference Manual for Polycom HDX Systems
camera near 1 <CR>API command
returns
camera near 1<CR><LF>API acknowledgement
notification:vidsourcechange:near:1:Main:people<CR><LF>
API registration response
When your system is registered for notifications, always use the API registration response for status.
Command Response Syntax
When you send a command, the system returns responses using the syntax described in the following
sections, where <CR> indicates a carriage return and <LF> indicates a line feed.
When Not Registered to Receive Notifications
When your system is not registered to receive any notifications and you send an API command, an API echo
and API acknowledgement are returned.
For example:
● camera near 2 <CR>API command
returns
camera near 2<LF><CR>API echo
camera near 2<CR><LF>API acknowledgement
When your system is not registered for notifications, always use the API acknowledgement (<CR><LF>),
which indicates that the command was sent, accepted, and processed. Never use the API echo
(<LF><CR>), which only indicates that you sent an API command but does not indicate whether the API
command you sent was actually processed. For example, you receive an API echo even if you send an
invalid API command. In this case, the API echo responds by echoing the invalid API command that you
attempted to send.
When Registered to Receive Notifications
Registering for notifications adds extra line responses in the form of API registration responses. When your
system is already registered to receive notifications and you send an API command that affects a
notification, an API echo, API acknowledgement, and API registration response are returned. You may
receive multiple API registration responses if you are registered for multiple notifications that are affected
by the API command you are currently sending.
For example, after your system has already been registered to receive camera notifications (the notify
vidsourcechanges API command enables these notifications), the following responses are returned when
you change the camera source using the camera near 1 API command:
● camera near 1 <CR>API command
returns
camera near 1<LF><CR>API echo
camera near 1<CR><LF>API acknowledgement
notification:vidsourcechange:near:1:Main:people<CR><LF>
API registration response
Polycom, Inc.
The end of line (EOL) character for the echo is different for serial and LAN
responses. The feedback examples below and elsewhere in the Integrator's
Reference Manual are based on the serial response.
System Commands
110
Advertisement
Table of Contents
