Cisco Cisco TelePresence MCU 4510 Developer's Guide

Page of 223
Feedback
Cisco TelePresence MCU API 2.9
Page 14 of 223
Feedback
Feedback receivers
The API allows you to register your application as a feedback receiver. This means that the application
doesn't have to constantly poll the device if it wants to monitor activity.
The device publishes events when they occur. If the device knows that your application is listening for these
events, it will send XML-RPC messages to your application's interface when the events occur.
n
Use
to register a receiver to listen for one or more
n
Use
to return a list of receivers that are configured on the device.
n
Use
to change the configuration of an existing feedback receiver.
n
Use
to remove an existing feedback receiver.
After registering as a feedback receiver, the application will receive
on the specified
interface.
Feedback messages
The feedback messages follow the format used by the device for XML-RPC responses.
The messages contain two parameters:
n
sourceIdentifier is a string that identifies the device, which may have been set by
feedbackReceiver.configure or otherwise will be the device's MAC address.
n
events is an array of strings that contain the names of the feedback events that have occurred.
Example feedback message
<params>
<param>
<value>
<struct>
<member>
<name>sourceIdentifier</name>
<value><string>000D7C000C66</string></value>
</member>
<member>
<name>events</name>
<value>
<array>
<data>
<value><string>restart</string></value>
</data>
</array>
</value>
</member>
</struct>
</value>
</param>