Xacli – special commands – xfeedback (ii) – TANDBERG 6000MXP User Manual
Page 58
58
D 13887.08
MAY 2008
TANDBERG 3000
MXP
&
6000
MXP
REFERENCE GUIDE FOR SYSTEM INTEGRATORS
XACLI – Special Commands – xfeedback (II)
About the TANDBERG API
EXAMPLE.
User wants to know when calls are connected
and when calls are disconnected, without monitoring any
call data changes when the call is active:
This can be done by registering feedback on the events:
CallSuccessful
•
CallDisconnected
•
xfeedback register event/callsuccessful
OK
xfeedback register event/calldisconnected
OK
xcommand dial number:558458
*r Result (status=OK):
CallRef: 1
LogTag: 8
*r/end
OK
CONNECT
*e CallSuccessful:
CallRef: 1
LogTag: 8
Protocol: H323
Direction: Outgoing
CallRate: 768
RemoteNumber: “558458”
Encryption:
Incoming: Off
Outgoing: Off
*e/end
xcommand disconnectcall call:1
*r Result (status=OK): /
*r/end
OK
NO CARRIER
*e CallDisconnected:
CallRef: 1
LogTag: 8
*e/end
EXAMPLE.
This example shows status for a call that is beeing
disconnected. The user has registered a feedback expression to
monitor all call changes (xfeedback register status/call).
When the call is active the Call element contains a large sub-struc-
ture. When the call is disconnected this status tree collapses, i.e.
the only information availible for a disconnected call is a Cause
element. All sub-elements that are being removed in this transition
are marked with a
ghost=True
attribute when feedback is issued,
see below.
xstatus call 1
*s Call 1 (status=Synced, type=Vtlph,
protocol=H323, direction=Outgoing, logTag=30):
CallRate: 768
RemoteNumber: “558458”
Mute: Off
Microphone: Off
Duration: 62
MuteOutgoing: Off
Channels 1 (type=Incoming):
Rate: 768
Restrict: Off
Encryption (status=On):
Type: AES-128
CheckCode: “C6D478F231E09A04”
Audio (status=Active):
Protocol: G722
Rate: 64
Video 1 (status=Active):
Protocol: H264
Resolution: CIF
Rate: 704
Video 2 (status=Inactive): /
Data (status=Inactive): /
Channels 2 (type=Outgoing):
Rate: 768
Restrict: Off
Encryption (status=On):
Type: AES-128
CheckCode: “C6D478F231E09A04”
Audio (status=Active):
Protocol: G722
Rate: 64
Video 1 (status=Active):
Protocol: H264
Resolution: CIF
Rate: 704
Video 2 (status=Inactive): /
Data (status=Inactive): /
*s/end
OK
xcommand disconnect
*r Result (status=OK): /
*r/end
OK
*s Call 1 (status=ClearOut, type=Vtlph,
protocol=H323, direction=Outgoing, logTag=30):
*s/end
NO CARRIER
*s Call 1 (status=Disconnected, type=NA,
protocol=NA, direction=NA, logTag=NA):
Cause: 16
CallRate (ghost=True): /
RemoteNumber (ghost=True): /
Mute (ghost=True): /
Microphone (ghost=True): /
Duration (ghost=True): /
MuteOutgoing (ghost=True): /
Channels 1 (ghost=True): /
Channels 2 (ghost=True): /
*s/end
xstatus call 1
*s Call 1 (status=Disconnected, type=NA,
protocol=NA, direction=NA, logTag=NA):
Cause: 16
*s/end
OK
NOTE!
If sub-elements are removed from a status structure between transitions, the removed elements will be notified with an attribute
ghost=True
when feedback is issued. This allows for an external control system to be completely synchronised with the codec.