Call.update

Revision as of 12:45, 8 October 2012

Message sent to request or notify changes in parameters of channels having active calls. This message is usually dispatched synchronously and the receiver must handle it without delay.

Requests

Sent by a channel that requests a change in the call's parameters. A peer channel that supports the operation must handle the message with no further delay.

Notifies

A channel whose parameters have changed (possibly as a result of an earlier call.update message) dispatches this message with its new operating parameters. A peer channel that supports the operation must handle the message and adapt its own parameters.

Unhandled messages

If the message is not handled the dispatching channel's behaviour depends on technology and the specific parameters changed. If a mandatory update is not supported by the peer channel the call should be terminated.

Parameters

module

module name of sender channel

id

sender channel id.

peerid

current peer of the sender

targetid

id of the channel this message is targeted to

operation

what type of operation is performed by the message

mandatory

set to true if the sender channel will disconnect the call if the call update fails

mute

optional, requests or notifies that the media channel has been muted

hold

optional, requests or notifies that the call has been placed on hold

formats

optional, requests or notifies a change in the list of supported media formats

Other parameters are module dependent and may provide extra information about the new call parameters.