Channel Call content interfaces: telepathy-glib API Reference Manual

Channel Call content interfaces

Channel Call content interfaces — client-side wrappers for call contents

Functions

TpProxyPendingCall *	tp_cli_call_content_call_remove ()
void	(*tp_cli_call_content_callback_for_remove) ()
TpProxySignalConnection *	tp_cli_call_content_connect_to_streams_added ()
TpProxySignalConnection *	tp_cli_call_content_connect_to_streams_removed ()
void	(*tp_cli_call_content_signal_callback_streams_added) ()
void	(*tp_cli_call_content_signal_callback_streams_removed) ()
TpProxyPendingCall *	tp_cli_call_content_interface_media_call_acknowledge_dtmf_change ()
TpProxyPendingCall *	tp_cli_call_content_interface_media_call_fail ()
TpProxyPendingCall *	tp_cli_call_content_interface_media_call_update_local_media_description ()
void	(*tp_cli_call_content_interface_media_callback_for_acknowledge_dtmf_change) ()
void	(*tp_cli_call_content_interface_media_callback_for_fail) ()
void	(*tp_cli_call_content_interface_media_callback_for_update_local_media_description) ()
TpProxySignalConnection *	tp_cli_call_content_interface_media_connect_to_dtmf_change_requested ()
TpProxySignalConnection *	tp_cli_call_content_interface_media_connect_to_local_media_description_changed ()
TpProxySignalConnection *	tp_cli_call_content_interface_media_connect_to_media_description_offer_done ()
TpProxySignalConnection *	tp_cli_call_content_interface_media_connect_to_media_descriptions_removed ()
TpProxySignalConnection *	tp_cli_call_content_interface_media_connect_to_new_media_description_offer ()
TpProxySignalConnection *	tp_cli_call_content_interface_media_connect_to_remote_media_descriptions_changed ()
void	(*tp_cli_call_content_interface_media_signal_callback_dtmf_change_requested) ()
void	(*tp_cli_call_content_interface_media_signal_callback_local_media_description_changed) ()
void	(*tp_cli_call_content_interface_media_signal_callback_media_description_offer_done) ()
void	(*tp_cli_call_content_interface_media_signal_callback_media_descriptions_removed) ()
void	(*tp_cli_call_content_interface_media_signal_callback_new_media_description_offer) ()
void	(*tp_cli_call_content_interface_media_signal_callback_remote_media_descriptions_changed) ()
TpProxySignalConnection *	tp_cli_call_content_interface_video_control_connect_to_bitrate_changed ()
TpProxySignalConnection *	tp_cli_call_content_interface_video_control_connect_to_framerate_changed ()
TpProxySignalConnection *	tp_cli_call_content_interface_video_control_connect_to_key_frame_requested ()
TpProxySignalConnection *	tp_cli_call_content_interface_video_control_connect_to_mtu_changed ()
TpProxySignalConnection *	tp_cli_call_content_interface_video_control_connect_to_video_resolution_changed ()
void	(*tp_cli_call_content_interface_video_control_signal_callback_bitrate_changed) ()
void	(*tp_cli_call_content_interface_video_control_signal_callback_framerate_changed) ()
void	(*tp_cli_call_content_interface_video_control_signal_callback_key_frame_requested) ()
void	(*tp_cli_call_content_interface_video_control_signal_callback_mtu_changed) ()
void	(*tp_cli_call_content_interface_video_control_signal_callback_video_resolution_changed) ()
TpProxyPendingCall *	tp_cli_call_content_interface_audio_control_call_report_input_volume ()
TpProxyPendingCall *	tp_cli_call_content_interface_audio_control_call_report_output_volume ()
void	(*tp_cli_call_content_interface_audio_control_callback_for_report_input_volume) ()
void	(*tp_cli_call_content_interface_audio_control_callback_for_report_output_volume) ()
TpProxyPendingCall *	tp_cli_call_content_interface_dtmf_call_multiple_tones ()
TpProxyPendingCall *	tp_cli_call_content_interface_dtmf_call_start_tone ()
TpProxyPendingCall *	tp_cli_call_content_interface_dtmf_call_stop_tone ()
void	(*tp_cli_call_content_interface_dtmf_callback_for_multiple_tones) ()
void	(*tp_cli_call_content_interface_dtmf_callback_for_start_tone) ()
void	(*tp_cli_call_content_interface_dtmf_callback_for_stop_tone) ()
TpProxySignalConnection *	tp_cli_call_content_interface_dtmf_connect_to_sending_tones ()
TpProxySignalConnection *	tp_cli_call_content_interface_dtmf_connect_to_stopped_tones ()
TpProxySignalConnection *	tp_cli_call_content_interface_dtmf_connect_to_tones_deferred ()
void	(*tp_cli_call_content_interface_dtmf_signal_callback_sending_tones) ()
void	(*tp_cli_call_content_interface_dtmf_signal_callback_stopped_tones) ()
void	(*tp_cli_call_content_interface_dtmf_signal_callback_tones_deferred) ()

Includes

#include <telepathy-glib/telepathy-glib-dbus.h>

Description

Represents the contents of a call.

Functions

tp_cli_call_content_call_remove ()

TpProxyPendingCall *
tp_cli_call_content_call_remove (TpCallContent *proxy,
                                 gint timeout_ms,
                                 tp_cli_call_content_callback_for_remove callback,
                                 gpointer user_data,
                                 GDestroyNotify destroy,
                                 GObject *weak_object);

Start a Remove method call.

Remove the content from the call. This will cause <tp:dbus-ref namespace="ofdT.Channel.Type">Call1.ContentRemoved</tp:dbus-ref>((self_handle, <tp:value-ref type="Call_State_Change_Reason">User_Requested</tp:value-ref>, "", "")) to be emitted.

Parameters

proxy	the TpProxy
timeout_ms	the timeout in milliseconds, or -1 to use the default
callback	called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
user_data	user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
destroy	called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
weak_object	If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`

Returns

a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

tp_cli_call_content_callback_for_remove ()

void
(*tp_cli_call_content_callback_for_remove)
                               (TpCallContent *proxy,
                                const GError *error,
                                gpointer user_data,
                                GObject *weak_object);

Signature of the callback called when a Remove method call succeeds or fails.

Parameters

proxy	the proxy on which the call was made
error	`NULL` on success, or an error on failure
user_data	user-supplied data
weak_object	user-supplied object

tp_cli_call_content_connect_to_streams_added ()

TpProxySignalConnection *
tp_cli_call_content_connect_to_streams_added
                               (TpCallContent *proxy,
                                tp_cli_call_content_signal_callback_streams_added callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object,
                                GError **error);

Connect a handler to the signal StreamsAdded.

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Emitted when streams are added to a call.

Parameters

proxy	A TpCallContent or subclass
callback	Callback to be called when the signal is received
user_data	User-supplied data for the callback
destroy	Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
weak_object	A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
error	If not `NULL`, used to raise an error if `NULL` is returned

Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or NULL if the proxy does not have the desired interface or has become invalid.

tp_cli_call_content_connect_to_streams_removed ()

TpProxySignalConnection *
tp_cli_call_content_connect_to_streams_removed
                               (TpCallContent *proxy,
                                tp_cli_call_content_signal_callback_streams_removed callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object,
                                GError **error);

Connect a handler to the signal StreamsRemoved.

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Emitted when streams are removed from a call

Parameters

proxy	A TpCallContent or subclass
callback	Callback to be called when the signal is received
user_data	User-supplied data for the callback
destroy	Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
weak_object	A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
error	If not `NULL`, used to raise an error if `NULL` is returned

Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or NULL if the proxy does not have the desired interface or has become invalid.

tp_cli_call_content_signal_callback_streams_added ()

void
(*tp_cli_call_content_signal_callback_streams_added)
                               (TpCallContent *proxy,
                                const GPtrArray *arg_Streams,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal StreamsAdded.

Parameters

proxy	The proxy on which `tp_cli_call_content_connect_to_streams_added()` was called
arg_Streams	The <tp:dbus-ref namespace="ofdT.Call1">Stream</tp:dbus-ref>s which were added.
user_data	User-supplied data
weak_object	User-supplied weakly referenced object

tp_cli_call_content_signal_callback_streams_removed ()

void
(*tp_cli_call_content_signal_callback_streams_removed)
                               (TpCallContent *proxy,
                                const GPtrArray *arg_Streams,
                                const GValueArray *arg_Reason,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal StreamsRemoved.

Parameters

proxy	The proxy on which `tp_cli_call_content_connect_to_streams_removed()` was called
arg_Streams	The <tp:dbus-ref namespace="ofdT.Call1">Stream</tp:dbus-ref>s which were removed.
arg_Reason	Why the content was removed.
user_data	User-supplied data
weak_object	User-supplied weakly referenced object

tp_cli_call_content_interface_media_call_acknowledge_dtmf_change ()

TpProxyPendingCall *
tp_cli_call_content_interface_media_call_acknowledge_dtmf_change
                               (TpCallContent *proxy,
                                gint timeout_ms,
                                guchar in_Event,
                                guint in_State,
                                tp_cli_call_content_interface_media_callback_for_acknowledge_dtmf_change callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a AcknowledgeDTMFChange method call.

Called by the streaming implementation in response to <tp:member-ref>DTMFChangeRequested</tp:member-ref> to confirm that it has started or stopped sending the event in question.

Parameters

proxy	the TpProxy
timeout_ms	the timeout in milliseconds, or -1 to use the default
in_Event	Used to pass an 'in' argument: The event referred to in the corresponding <tp:member-ref>DTMFChangeRequested</tp:member-ref> signal.
in_State	Used to pass an 'in' argument: Either <tp:value-ref type="Sending_State">Sending</tp:value-ref> or <tp:value-ref type="Sending_State">None</tp:value-ref>. (TpSendingState)
callback	called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
user_data	user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
destroy	called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
weak_object	If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`

Returns

a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

tp_cli_call_content_interface_media_call_fail ()

TpProxyPendingCall *
tp_cli_call_content_interface_media_call_fail
                               (TpCallContent *proxy,
                                gint timeout_ms,
                                const GValueArray *in_Reason,
                                tp_cli_call_content_interface_media_callback_for_fail callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a Fail method call.

Signal an unrecoverable error for this content, and remove it.

Parameters

proxy	the TpProxy
timeout_ms	the timeout in milliseconds, or -1 to use the default
in_Reason	Used to pass an 'in' argument: A reason struct describing the error.
callback	called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
user_data	user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
destroy	called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
weak_object	If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`

Returns

a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

tp_cli_call_content_interface_media_call_update_local_media_description ()

TpProxyPendingCall *
tp_cli_call_content_interface_media_call_update_local_media_description
                               (TpCallContent *proxy,
                                gint timeout_ms,
                                GHashTable *in_MediaDescription,
                                tp_cli_call_content_interface_media_callback_for_update_local_media_description callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a UpdateLocalMediaDescription method call.

Update the local codec mapping and other interfaces of the MediaDescription. This method should only be used during an existing call to update the local media description. This may trigger a re-negotiation which may result in new new MediaDescriptionOffers if the "FurtherNegotiationRequired" property is TRUE. Otherwise, only parameters which strictly describe the media being sent can be changed.

Parameters

proxy	the TpProxy
timeout_ms	the timeout in milliseconds, or -1 to use the default
in_MediaDescription	Used to pass an 'in' argument: The updated media description that the local side wants to use.
callback	called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
user_data	user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
destroy	called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
weak_object	If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`

Returns

a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

tp_cli_call_content_interface_media_callback_for_acknowledge_dtmf_change ()

void
(*tp_cli_call_content_interface_media_callback_for_acknowledge_dtmf_change)
                               (TpCallContent *proxy,
                                const GError *error,
                                gpointer user_data,
                                GObject *weak_object);

Signature of the callback called when a AcknowledgeDTMFChange method call succeeds or fails.

Parameters

proxy	the proxy on which the call was made
error	`NULL` on success, or an error on failure
user_data	user-supplied data
weak_object	user-supplied object

tp_cli_call_content_interface_media_callback_for_fail ()

void
(*tp_cli_call_content_interface_media_callback_for_fail)
                               (TpCallContent *proxy,
                                const GError *error,
                                gpointer user_data,
                                GObject *weak_object);

Signature of the callback called when a Fail method call succeeds or fails.

Parameters

proxy	the proxy on which the call was made
error	`NULL` on success, or an error on failure
user_data	user-supplied data
weak_object	user-supplied object

tp_cli_call_content_interface_media_callback_for_update_local_media_description ()

void
(*tp_cli_call_content_interface_media_callback_for_update_local_media_description)
                               (TpCallContent *proxy,
                                const GError *error,
                                gpointer user_data,
                                GObject *weak_object);

Signature of the callback called when a UpdateLocalMediaDescription method call succeeds or fails.

Parameters

proxy	the proxy on which the call was made
error	`NULL` on success, or an error on failure
user_data	user-supplied data
weak_object	user-supplied object

tp_cli_call_content_interface_media_connect_to_dtmf_change_requested ()

TpProxySignalConnection *
tp_cli_call_content_interface_media_connect_to_dtmf_change_requested
                               (TpCallContent *proxy,
                                tp_cli_call_content_interface_media_signal_callback_dtmf_change_requested callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object,
                                GError **error);

Connect a handler to the signal DTMFChangeRequested.

Used by the CM to relay instructions from <tp:dbus-ref namespace="ofdT">Channel.Interface.DTMF</tp:dbus-ref> to the streaming implementation. If any contact in this call supports the telephone-event codec in their MediaDescription, this event should be sent as outlined in RFC 4733. Otherwise, it should be sent as an audible tone.

Parameters

proxy	A TpCallContent or subclass
callback	Callback to be called when the signal is received
user_data	User-supplied data for the callback
destroy	Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
weak_object	A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
error	If not `NULL`, used to raise an error if `NULL` is returned

Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or NULL if the proxy does not have the desired interface or has become invalid.

tp_cli_call_content_interface_media_connect_to_local_media_description_changed ()

TpProxySignalConnection *
tp_cli_call_content_interface_media_connect_to_local_media_description_changed
                               (TpCallContent *proxy,
                                tp_cli_call_content_interface_media_signal_callback_local_media_description_changed callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object,
                                GError **error);

Connect a handler to the signal LocalMediaDescriptionChanged.

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Change notification for <tp:dbus-ref namespace="ofdT.Call1.Content.Interface.Media">LocalMediaDescriptions</tp:dbus-ref>

Parameters

proxy	A TpCallContent or subclass
callback	Callback to be called when the signal is received
user_data	User-supplied data for the callback
destroy	Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
weak_object	A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
error	If not `NULL`, used to raise an error if `NULL` is returned

Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or NULL if the proxy does not have the desired interface or has become invalid.

tp_cli_call_content_interface_media_connect_to_media_description_offer_done ()

TpProxySignalConnection *
tp_cli_call_content_interface_media_connect_to_media_description_offer_done
                               (TpCallContent *proxy,
                                tp_cli_call_content_interface_media_signal_callback_media_description_offer_done callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object,
                                GError **error);

Connect a handler to the signal MediaDescriptionOfferDone.

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Emitted when a <tp:dbus-ref namespace="ofdT.Call1.Content">MediaDescription</tp:dbus-ref> has been handled. Emission of this signal indicates that the <tp:member-ref>MediaDescriptionOffer</tp:member-ref> property has changed to <code>("/", 0, {})</code>.

Parameters

proxy	A TpCallContent or subclass
callback	Callback to be called when the signal is received
user_data	User-supplied data for the callback
destroy	Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
weak_object	A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
error	If not `NULL`, used to raise an error if `NULL` is returned

Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or NULL if the proxy does not have the desired interface or has become invalid.

tp_cli_call_content_interface_media_connect_to_media_descriptions_removed ()

TpProxySignalConnection *
tp_cli_call_content_interface_media_connect_to_media_descriptions_removed
                               (TpCallContent *proxy,
                                tp_cli_call_content_interface_media_signal_callback_media_descriptions_removed callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object,
                                GError **error);

Connect a handler to the signal MediaDescriptionsRemoved.

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Removal notification for <tp:dbus-ref namespace="ofdT.Call1.Content.Interface.Media">RemoteMediaDescriptions</tp:dbus-ref> and <tp:dbus-ref namespace="ofdT.Call1.Content.Interface.Media">LocalMediaDescriptions</tp:dbus-ref>

Parameters

proxy	A TpCallContent or subclass
callback	Callback to be called when the signal is received
user_data	User-supplied data for the callback
destroy	Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
weak_object	A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
error	If not `NULL`, used to raise an error if `NULL` is returned

Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or NULL if the proxy does not have the desired interface or has become invalid.

tp_cli_call_content_interface_media_connect_to_new_media_description_offer ()

TpProxySignalConnection *
tp_cli_call_content_interface_media_connect_to_new_media_description_offer
                               (TpCallContent *proxy,
                                tp_cli_call_content_interface_media_signal_callback_new_media_description_offer callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object,
                                GError **error);

Connect a handler to the signal NewMediaDescriptionOffer.

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Emitted when a new <tp:dbus-ref namespace="ofdT.Call1.Content">MediaDescription</tp:dbus-ref> appears. The streaming >implementation MUST respond by calling the <tp:dbus-ref namespace="ofdT.Call1.Content.MediaDescription">Accept</tp:dbus-ref> or <tp:dbus-ref namespace="ofdT.Call1.Content.MediaDescription">Reject</tp:dbus-ref> method on the description object appeared. Emission of this signal indicates that the <tp:member-ref>MediaDescriptionOffer</tp:member-ref> property has changed to <code>(Description, Contact, MediaDescriptionProperties)</code>. When the MediaDescriptionOffer has been dealt with then <tp:dbus-ref namespace="ofdT.Call1.Content.Interface.Media">MediaDescriptionOfferDone</tp:dbus-ref> must be emitted before <tp:dbus-ref namespace="ofdT.Call1.Content.Interface.Media">NewMediaDescriptionOffer</tp:dbus-ref> is emitted again.

Parameters

proxy	A TpCallContent or subclass
callback	Callback to be called when the signal is received
user_data	User-supplied data for the callback
destroy	Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
weak_object	A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
error	If not `NULL`, used to raise an error if `NULL` is returned

Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or NULL if the proxy does not have the desired interface or has become invalid.

tp_cli_call_content_interface_media_connect_to_remote_media_descriptions_changed ()

TpProxySignalConnection *
tp_cli_call_content_interface_media_connect_to_remote_media_descriptions_changed
                               (TpCallContent *proxy,
                                tp_cli_call_content_interface_media_signal_callback_remote_media_descriptions_changed callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object,
                                GError **error);

Connect a handler to the signal RemoteMediaDescriptionsChanged.

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Change notification for <tp:dbus-ref namespace="ofdT.Call1.Content.Interface.Media">RemoteMediaDescriptions</tp:dbus-ref>

Parameters

proxy	A TpCallContent or subclass
callback	Callback to be called when the signal is received
user_data	User-supplied data for the callback
destroy	Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
weak_object	A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
error	If not `NULL`, used to raise an error if `NULL` is returned

Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or NULL if the proxy does not have the desired interface or has become invalid.

tp_cli_call_content_interface_media_signal_callback_dtmf_change_requested ()

void
(*tp_cli_call_content_interface_media_signal_callback_dtmf_change_requested)
                               (TpCallContent *proxy,
                                guchar arg_Event,
                                guint arg_State,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal DTMFChangeRequested.

Parameters

proxy	The proxy on which `tp_cli_call_content_interface_media_connect_to_dtmf_change_requested()` was called
arg_Event	The event to send (or stop sending).
arg_State	Either <tp:value-ref type="Sending_State">Pending_Send</tp:value-ref> or <tp:value-ref type="Sending_State">Pending_Stop_Sending</tp:value-ref>. (TpSendingState)
user_data	User-supplied data
weak_object	User-supplied weakly referenced object

tp_cli_call_content_interface_media_signal_callback_local_media_description_changed ()

void
(*tp_cli_call_content_interface_media_signal_callback_local_media_description_changed)
                               (TpCallContent *proxy,
                                GHashTable *arg_Updated_Media_Description,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal LocalMediaDescriptionChanged.

Parameters

proxy	The proxy on which `tp_cli_call_content_interface_media_connect_to_local_media_description_changed()` was called
arg_Updated_Media_Description	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The local content description that was updated</p>
user_data	User-supplied data
weak_object	User-supplied weakly referenced object

tp_cli_call_content_interface_media_signal_callback_media_description_offer_done ()

void
(*tp_cli_call_content_interface_media_signal_callback_media_description_offer_done)
                               (TpCallContent *proxy,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal MediaDescriptionOfferDone.

Parameters

proxy	The proxy on which `tp_cli_call_content_interface_media_connect_to_media_description_offer_done()` was called
user_data	User-supplied data
weak_object	User-supplied weakly referenced object

tp_cli_call_content_interface_media_signal_callback_media_descriptions_removed ()

void
(*tp_cli_call_content_interface_media_signal_callback_media_descriptions_removed)
                               (TpCallContent *proxy,
                                const GArray *arg_Removed_Media_Descriptions,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal MediaDescriptionsRemoved.

Parameters

proxy	The proxy on which `tp_cli_call_content_interface_media_connect_to_media_descriptions_removed()` was called
arg_Removed_Media_Descriptions	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The local and remote content descriptions that are no longer part of this content</p>
user_data	User-supplied data
weak_object	User-supplied weakly referenced object

tp_cli_call_content_interface_media_signal_callback_new_media_description_offer ()

void
(*tp_cli_call_content_interface_media_signal_callback_new_media_description_offer)
                               (TpCallContent *proxy,
                                const gchar *arg_Media_Description,
                                GHashTable *arg_Properties,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal NewMediaDescriptionOffer.

Parameters

proxy	The proxy on which `tp_cli_call_content_interface_media_connect_to_new_media_description_offer()` was called
arg_Media_Description	The object path of the new media description. This replaces any previous media description.
arg_Properties	The immutable properties of the remote media description. <tp:rationale> Having all the MediaDescription properties here saves a D-Bus round-trip - it shouldn't be necessary to get the properties from the MediaDescription object, in practice. </tp:rationale>
user_data	User-supplied data
weak_object	User-supplied weakly referenced object

tp_cli_call_content_interface_media_signal_callback_remote_media_descriptions_changed ()

void
(*tp_cli_call_content_interface_media_signal_callback_remote_media_descriptions_changed)
                               (TpCallContent *proxy,
                                GHashTable *arg_Updated_Media_Descriptions,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal RemoteMediaDescriptionsChanged.

Parameters

proxy	The proxy on which `tp_cli_call_content_interface_media_connect_to_remote_media_descriptions_changed()` was called
arg_Updated_Media_Descriptions	<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>The remote content descriptions that were updated</p>
user_data	User-supplied data
weak_object	User-supplied weakly referenced object

tp_cli_call_content_interface_video_control_connect_to_bitrate_changed ()

TpProxySignalConnection *
tp_cli_call_content_interface_video_control_connect_to_bitrate_changed
                               (TpCallContent *proxy,
                                tp_cli_call_content_interface_video_control_signal_callback_bitrate_changed callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object,
                                GError **error);

Connect a handler to the signal BitrateChanged.

The desired bitrate has changed

Parameters

proxy	A TpCallContent or subclass
callback	Callback to be called when the signal is received
user_data	User-supplied data for the callback
destroy	Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
weak_object	A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
error	If not `NULL`, used to raise an error if `NULL` is returned

Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or NULL if the proxy does not have the desired interface or has become invalid.

tp_cli_call_content_interface_video_control_connect_to_framerate_changed ()

TpProxySignalConnection *
tp_cli_call_content_interface_video_control_connect_to_framerate_changed
                               (TpCallContent *proxy,
                                tp_cli_call_content_interface_video_control_signal_callback_framerate_changed callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object,
                                GError **error);

Connect a handler to the signal FramerateChanged.

The desired framerate has changed

Parameters

proxy	A TpCallContent or subclass
callback	Callback to be called when the signal is received
user_data	User-supplied data for the callback
destroy	Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
weak_object	A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
error	If not `NULL`, used to raise an error if `NULL` is returned

Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or NULL if the proxy does not have the desired interface or has become invalid.

tp_cli_call_content_interface_video_control_connect_to_key_frame_requested ()

TpProxySignalConnection *
tp_cli_call_content_interface_video_control_connect_to_key_frame_requested
                               (TpCallContent *proxy,
                                tp_cli_call_content_interface_video_control_signal_callback_key_frame_requested callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object,
                                GError **error);

Connect a handler to the signal KeyFrameRequested.

Request that the video encoder produce a new key frame as soon as possible.

Parameters

proxy	A TpCallContent or subclass
callback	Callback to be called when the signal is received
user_data	User-supplied data for the callback
destroy	Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
weak_object	A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
error	If not `NULL`, used to raise an error if `NULL` is returned

Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or NULL if the proxy does not have the desired interface or has become invalid.

tp_cli_call_content_interface_video_control_connect_to_mtu_changed ()

TpProxySignalConnection *
tp_cli_call_content_interface_video_control_connect_to_mtu_changed
                               (TpCallContent *proxy,
                                tp_cli_call_content_interface_video_control_signal_callback_mtu_changed callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object,
                                GError **error);

Connect a handler to the signal MTUChanged.

The Maximum Transmission Unit has changed

Parameters

proxy	A TpCallContent or subclass
callback	Callback to be called when the signal is received
user_data	User-supplied data for the callback
destroy	Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
weak_object	A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
error	If not `NULL`, used to raise an error if `NULL` is returned

Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or NULL if the proxy does not have the desired interface or has become invalid.

tp_cli_call_content_interface_video_control_connect_to_video_resolution_changed ()

TpProxySignalConnection *
tp_cli_call_content_interface_video_control_connect_to_video_resolution_changed
                               (TpCallContent *proxy,
                                tp_cli_call_content_interface_video_control_signal_callback_video_resolution_changed callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object,
                                GError **error);

Connect a handler to the signal VideoResolutionChanged.

The desired video resolution has changed.

Parameters

proxy	A TpCallContent or subclass
callback	Callback to be called when the signal is received
user_data	User-supplied data for the callback
destroy	Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
weak_object	A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
error	If not `NULL`, used to raise an error if `NULL` is returned

Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or NULL if the proxy does not have the desired interface or has become invalid.

tp_cli_call_content_interface_video_control_signal_callback_bitrate_changed ()

void
(*tp_cli_call_content_interface_video_control_signal_callback_bitrate_changed)
                               (TpCallContent *proxy,
                                guint arg_NewBitrate,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal BitrateChanged.

Parameters

proxy	The proxy on which `tp_cli_call_content_interface_video_control_connect_to_bitrate_changed()` was called
arg_NewBitrate	.	[Undocumented]
user_data	User-supplied data
weak_object	User-supplied weakly referenced object

tp_cli_call_content_interface_video_control_signal_callback_framerate_changed ()

void
(*tp_cli_call_content_interface_video_control_signal_callback_framerate_changed)
                               (TpCallContent *proxy,
                                guint arg_NewFramerate,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal FramerateChanged.

Parameters

proxy	The proxy on which `tp_cli_call_content_interface_video_control_connect_to_framerate_changed()` was called
arg_NewFramerate	.	[Undocumented]
user_data	User-supplied data
weak_object	User-supplied weakly referenced object

tp_cli_call_content_interface_video_control_signal_callback_key_frame_requested ()

void
(*tp_cli_call_content_interface_video_control_signal_callback_key_frame_requested)
                               (TpCallContent *proxy,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal KeyFrameRequested.

Parameters

proxy	The proxy on which `tp_cli_call_content_interface_video_control_connect_to_key_frame_requested()` was called
user_data	User-supplied data
weak_object	User-supplied weakly referenced object

tp_cli_call_content_interface_video_control_signal_callback_mtu_changed ()

void
(*tp_cli_call_content_interface_video_control_signal_callback_mtu_changed)
                               (TpCallContent *proxy,
                                guint arg_NewMTU,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal MTUChanged.

Parameters

proxy	The proxy on which `tp_cli_call_content_interface_video_control_connect_to_mtu_changed()` was called
arg_NewMTU	.	[Undocumented]
user_data	User-supplied data
weak_object	User-supplied weakly referenced object

tp_cli_call_content_interface_video_control_signal_callback_video_resolution_changed ()

void
(*tp_cli_call_content_interface_video_control_signal_callback_video_resolution_changed)
                               (TpCallContent *proxy,
                                const GValueArray *arg_NewResolution,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal VideoResolutionChanged.

Parameters

proxy	The proxy on which `tp_cli_call_content_interface_video_control_connect_to_video_resolution_changed()` was called
arg_NewResolution	.	[Undocumented]
user_data	User-supplied data
weak_object	User-supplied weakly referenced object

tp_cli_call_content_interface_audio_control_call_report_input_volume ()

TpProxyPendingCall *
tp_cli_call_content_interface_audio_control_call_report_input_volume
                               (TpCallContent *proxy,
                                gint timeout_ms,
                                gint in_Volume,
                                tp_cli_call_content_interface_audio_control_callback_for_report_input_volume callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a ReportInputVolume method call.

Report to the CM that the Content input volume has been changed by the client. It is the client's responsibility to change the input volume used for the content. However, the client MUST call this whenever it changes input volume for the content.

Parameters

proxy	the TpProxy
timeout_ms	the timeout in milliseconds, or -1 to use the default
in_Volume	Used to pass an 'in' argument: Report the input volume level as set by the client.
callback	called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
user_data	user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
destroy	called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
weak_object	If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`

Returns

a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

tp_cli_call_content_interface_audio_control_call_report_output_volume ()

TpProxyPendingCall *
tp_cli_call_content_interface_audio_control_call_report_output_volume
                               (TpCallContent *proxy,
                                gint timeout_ms,
                                gint in_Volume,
                                tp_cli_call_content_interface_audio_control_callback_for_report_output_volume callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a ReportOutputVolume method call.

Report to the CM that the content output volume has been changed by the client. It is the client's responsibility to change the output volume used for the content. However, the client MUST call this whenever it changes output volume for the content.

Parameters

proxy	the TpProxy
timeout_ms	the timeout in milliseconds, or -1 to use the default
in_Volume	Used to pass an 'in' argument: Report the output volume level as set by the client.
callback	called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
user_data	user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
destroy	called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
weak_object	If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`

Returns

a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

tp_cli_call_content_interface_audio_control_callback_for_report_input_volume ()

void
(*tp_cli_call_content_interface_audio_control_callback_for_report_input_volume)
                               (TpCallContent *proxy,
                                const GError *error,
                                gpointer user_data,
                                GObject *weak_object);

Signature of the callback called when a ReportInputVolume method call succeeds or fails.

Parameters

proxy	the proxy on which the call was made
error	`NULL` on success, or an error on failure
user_data	user-supplied data
weak_object	user-supplied object

tp_cli_call_content_interface_audio_control_callback_for_report_output_volume ()

void
(*tp_cli_call_content_interface_audio_control_callback_for_report_output_volume)
                               (TpCallContent *proxy,
                                const GError *error,
                                gpointer user_data,
                                GObject *weak_object);

Signature of the callback called when a ReportOutputVolume method call succeeds or fails.

Parameters

proxy	the proxy on which the call was made
error	`NULL` on success, or an error on failure
user_data	user-supplied data
weak_object	user-supplied object

tp_cli_call_content_interface_dtmf_call_multiple_tones ()

TpProxyPendingCall *
tp_cli_call_content_interface_dtmf_call_multiple_tones
                               (TpCallContent *proxy,
                                gint timeout_ms,
                                const gchar *in_Tones,
                                tp_cli_call_content_interface_dtmf_callback_for_multiple_tones callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a MultipleTones method call.

Send multiple DTMF events to all eligible streams in the channel. Each tone will be played for an implementation-defined number of milliseconds (typically 250ms), followed by a gap before the next tone is played (typically 100ms). The duration and gap are defined by the protocol or connection manager. <tp:rationale> In cases where the client knows in advance the tone sequence it wants to send, it's easier to use this method than manually start and stop each tone in the sequence. The tone and gap lengths may need to vary for interoperability, according to the protocol and other implementations' ability to recognise tones. At the time of writing, GStreamer uses a minimum of 250ms tones and 100ms gaps when playing in-band DTMF in the normal audio stream, or 70ms tones and 50ms gaps when encoding DTMF as <code>audio/telephone-event</code>. </tp:rationale> Tone overlaping or queueing is not supported, so this method can only be called if no DTMF tones are already being played.

Parameters

proxy	the TpProxy
timeout_ms	the timeout in milliseconds, or -1 to use the default
in_Tones	Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>A string representation of one or more DTMF events. Implementations of this method MUST support all of the following characters in this string:</p> <ul> <li>the digits 0-9, letters A-D and a-d, and symbols '*' and '#' correspond to the members of <tp:type>DTMF_Event</tp:type></li> <li>any of 'p', 'P', 'x', 'X' or ',' (comma) results in an implementation-defined pause, typically for 3 seconds</li> <li>'w' or 'W' waits for the user to continue, by stopping interpretation of the string, and if there is more to be played, emitting the <tp:member-ref>TonesDeferred</tp:member-ref> signal with the rest of the string as its argument: see that signal for details</li> </ul>
callback	called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
user_data	user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
destroy	called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
weak_object	If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`

Returns

a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

tp_cli_call_content_interface_dtmf_call_start_tone ()

TpProxyPendingCall *
tp_cli_call_content_interface_dtmf_call_start_tone
                               (TpCallContent *proxy,
                                gint timeout_ms,
                                guchar in_Event,
                                tp_cli_call_content_interface_dtmf_callback_for_start_tone callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a StartTone method call.

Start sending a DTMF tone to all eligible streams in the channel. Where possible, the tone will continue until <tp:member-ref>StopTone</tp:member-ref> is called. On certain protocols, it may only be possible to send events with a predetermined length. In this case, the implementation MAY emit a fixed-length tone, and the StopTone method call SHOULD return NotAvailable. <tp:rationale> The client may wish to control the exact duration and timing of the tones sent as a result of user's interaction with the dialpad, thus starting and stopping the tone sending explicitly. </tp:rationale> Tone overlaping or queueing is not supported, so this method can only be called if no DTMF tones are already being played.

Parameters

proxy	the TpProxy
timeout_ms	the timeout in milliseconds, or -1 to use the default
in_Event	Used to pass an 'in' argument: A numeric event code from the DTMF_Event enum.
callback	called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
user_data	user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
destroy	called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
weak_object	If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`

Returns

a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

tp_cli_call_content_interface_dtmf_call_stop_tone ()

TpProxyPendingCall *
tp_cli_call_content_interface_dtmf_call_stop_tone
                               (TpCallContent *proxy,
                                gint timeout_ms,
                                tp_cli_call_content_interface_dtmf_callback_for_stop_tone callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a StopTone method call.

Stop sending any DTMF tones which have been started using the <tp:member-ref>StartTone</tp:member-ref> or <tp:member-ref>MultipleTones</tp:member-ref> methods. If there is no current tone, this method will do nothing. If MultipleTones was used, the client should not assume the sending has stopped immediately; instead, the client should wait for the StoppedTones signal. <tp:rationale> On some protocols it might be impossible to cancel queued tones immediately. </tp:rationale>

Parameters

proxy	the TpProxy
timeout_ms	the timeout in milliseconds, or -1 to use the default
callback	called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
user_data	user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
destroy	called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
weak_object	If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`

Returns

a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

tp_cli_call_content_interface_dtmf_callback_for_multiple_tones ()

void
(*tp_cli_call_content_interface_dtmf_callback_for_multiple_tones)
                               (TpCallContent *proxy,
                                const GError *error,
                                gpointer user_data,
                                GObject *weak_object);

Signature of the callback called when a MultipleTones method call succeeds or fails.

Parameters

proxy	the proxy on which the call was made
error	`NULL` on success, or an error on failure
user_data	user-supplied data
weak_object	user-supplied object

tp_cli_call_content_interface_dtmf_callback_for_start_tone ()

void
(*tp_cli_call_content_interface_dtmf_callback_for_start_tone)
                               (TpCallContent *proxy,
                                const GError *error,
                                gpointer user_data,
                                GObject *weak_object);

Signature of the callback called when a StartTone method call succeeds or fails.

Parameters

proxy	the proxy on which the call was made
error	`NULL` on success, or an error on failure
user_data	user-supplied data
weak_object	user-supplied object

tp_cli_call_content_interface_dtmf_callback_for_stop_tone ()

void
(*tp_cli_call_content_interface_dtmf_callback_for_stop_tone)
                               (TpCallContent *proxy,
                                const GError *error,
                                gpointer user_data,
                                GObject *weak_object);

Signature of the callback called when a StopTone method call succeeds or fails.

Parameters

proxy	the proxy on which the call was made
error	`NULL` on success, or an error on failure
user_data	user-supplied data
weak_object	user-supplied object

tp_cli_call_content_interface_dtmf_connect_to_sending_tones ()

TpProxySignalConnection *
tp_cli_call_content_interface_dtmf_connect_to_sending_tones
                               (TpCallContent *proxy,
                                tp_cli_call_content_interface_dtmf_signal_callback_sending_tones callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object,
                                GError **error);

Connect a handler to the signal SendingTones.

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> DTMF tone(s)are being sent to all eligible streams in the channel. The signal is provided to indicating the fact that the streams are currently being used to send one or more DTMF tones, so any other media input is not getting through to the audio stream. It also serves as a cue for the <tp:member-ref>StopTone</tp:member-ref> method.

Parameters

proxy	A TpCallContent or subclass
callback	Callback to be called when the signal is received
user_data	User-supplied data for the callback
destroy	Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
weak_object	A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
error	If not `NULL`, used to raise an error if `NULL` is returned

Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or NULL if the proxy does not have the desired interface or has become invalid.

tp_cli_call_content_interface_dtmf_connect_to_stopped_tones ()

TpProxySignalConnection *
tp_cli_call_content_interface_dtmf_connect_to_stopped_tones
                               (TpCallContent *proxy,
                                tp_cli_call_content_interface_dtmf_signal_callback_stopped_tones callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object,
                                GError **error);

Connect a handler to the signal StoppedTones.

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> DTMF tones have finished playing on streams in this channel.

Parameters

proxy	A TpCallContent or subclass
callback	Callback to be called when the signal is received
user_data	User-supplied data for the callback
destroy	Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
weak_object	A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
error	If not `NULL`, used to raise an error if `NULL` is returned

Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or NULL if the proxy does not have the desired interface or has become invalid.

tp_cli_call_content_interface_dtmf_connect_to_tones_deferred ()

TpProxySignalConnection *
tp_cli_call_content_interface_dtmf_connect_to_tones_deferred
                               (TpCallContent *proxy,
                                tp_cli_call_content_interface_dtmf_signal_callback_tones_deferred callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object,
                                GError **error);

Connect a handler to the signal TonesDeferred.

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Emitted when 'w' or 'W', indicating "wait for the user to continue", is encountered while playing a DTMF string queued by <tp:member-ref>MultipleTones</tp:member-ref>. Any queued DTMF events after the 'w', which have not yet been played, are placed in the <tp:member-ref>DeferredTones</tp:member-ref> property and copied into this signal's argument. When the channel handler is ready to continue, it MAY pass the value of <tp:member-ref>DeferredTones</tp:member-ref> to <tp:member-ref>MultipleTones</tp:member-ref>, to resume sending. Alternatively, it MAY ignore the deferred tones, or even play different tones instead. Any deferred tones are discarded the next time a tone is played. This signal SHOULD NOT be emitted if there is nothing left to play, i.e. if the 'w' was the last character in the DTMF string.

Parameters

proxy	A TpCallContent or subclass
callback	Callback to be called when the signal is received
user_data	User-supplied data for the callback
destroy	Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
weak_object	A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
error	If not `NULL`, used to raise an error if `NULL` is returned

Returns

a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or NULL if the proxy does not have the desired interface or has become invalid.

tp_cli_call_content_interface_dtmf_signal_callback_sending_tones ()

void
(*tp_cli_call_content_interface_dtmf_signal_callback_sending_tones)
                               (TpCallContent *proxy,
                                const gchar *arg_Tones,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal SendingTones.

Parameters

proxy	The proxy on which `tp_cli_call_content_interface_dtmf_connect_to_sending_tones()` was called
arg_Tones	DTMF string (one or more events) that is to be played.
user_data	User-supplied data
weak_object	User-supplied weakly referenced object

tp_cli_call_content_interface_dtmf_signal_callback_stopped_tones ()

void
(*tp_cli_call_content_interface_dtmf_signal_callback_stopped_tones)
                               (TpCallContent *proxy,
                                gboolean arg_Cancelled,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal StoppedTones.

Parameters

proxy	The proxy on which `tp_cli_call_content_interface_dtmf_connect_to_stopped_tones()` was called
arg_Cancelled	True if the DTMF tones were actively cancelled via <tp:member-ref>StopTone</tp:member-ref>.
user_data	User-supplied data
weak_object	User-supplied weakly referenced object

tp_cli_call_content_interface_dtmf_signal_callback_tones_deferred ()

void
(*tp_cli_call_content_interface_dtmf_signal_callback_tones_deferred)
                               (TpCallContent *proxy,
                                const gchar *arg_Tones,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal TonesDeferred.

Parameters

proxy	The proxy on which `tp_cli_call_content_interface_dtmf_connect_to_tones_deferred()` was called
arg_Tones	The new non-empty value of <tp:member-ref>DeferredTones</tp:member-ref>.
user_data	User-supplied data
weak_object	User-supplied weakly referenced object