| Top |  |  |  |  | 
| GPtrArray * | contents | Read | 
| guint | flags | Read | 
| gboolean | hardware-streaming | Read | 
| guint | hold-state | Read | 
| guint | hold-state-reason | Read | 
| gboolean | initial-audio | Read | 
| char * | initial-audio-name | Read | 
| gboolean | initial-video | Read | 
| char * | initial-video-name | Read | 
| gboolean | mutable-contents | Read | 
| guint | state | Read | 
| GHashTable * | state-details | Read | 
| TpCallStateReason * | state-reason | Read | 
| void | content-added | Run Last | 
| void | content-removed | Run Last | 
| void | members-changed | Run Last | 
| void | state-changed | Run Last | 
| struct | TpCallChannel | 
| struct | TpCallChannelClass | 
| #define | TP_CALL_CHANNEL_FEATURE_CORE | 
| struct | TpCallStateReason | 
GPtrArray *
tp_call_channel_get_contents (TpCallChannel *self);
the value of “contents”.
[transfer none][type GLib.PtrArray][element-type TelepathyGLib.CallContent]
Since: 0.17.5
TpCallState tp_call_channel_get_state (TpCallChannel *self,TpCallFlags *flags,GHashTable **details,TpCallStateReason **reason);
| self | ||
| flags | a place to set the value of “flags”. | [out][allow-none][transfer none] | 
| details | a place to set the value of “state-details”. | [out][allow-none][transfer none] | 
| reason | a place to set the value of “state-reason”. | [out][allow-none][transfer none] | 
Since: 0.17.5
gboolean
tp_call_channel_has_hardware_streaming
                               (TpCallChannel *self);
Since: 0.17.5
gboolean tp_call_channel_has_initial_audio (TpCallChannel *self,const gchar **initial_audio_name);
| self | ||
| initial_audio_name | a place to set the value of “initial-audio-name”. | [out][allow-none][transfer none] | 
Since: 0.17.5
gboolean tp_call_channel_has_initial_video (TpCallChannel *self,const gchar **initial_video_name);
| self | ||
| initial_video_name | a place to set the value of “initial-video-name”. | [out][allow-none][transfer none] | 
Since: 0.17.5
gboolean
tp_call_channel_has_mutable_contents (TpCallChannel *self);
Since: 0.17.5
GHashTable *
tp_call_channel_get_members (TpCallChannel *self);
Get the members of this call.
The TpContact objects are guaranteed to have all of the features
previously passed to tp_simple_client_factory_add_contact_features()
prepared.
GHashTable mapping TpContact to its new TpCallMemberFlags.
[transfer none][type GLib.HashTable][element-type TelepathyGLib.Contact uint]
Since: 0.17.5
gboolean
tp_call_channel_has_dtmf (TpCallChannel *self);
Whether or not self
 can send DTMF tones using
tp_call_channel_send_tones_async(). To be able to send DTMF tones, at least
one of self
's “contents” must implement
TP_IFACE_CALL_CONTENT_INTERFACE_DTMF interface.
Since: 0.17.5
gboolean
tp_call_channel_has_hold (TpCallChannel *self);
Whether or not self
 has the TP_IFACE_CHANNEL_INTERFACE_HOLD
interfaces
Since: 0.17.6
void tp_call_channel_send_tones_async (TpCallChannel *self,const gchar *tones,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Send tones
 on every of self
's contents which have the
TP_IFACE_CALL_CONTENT_INTERFACE_DTMF interface.
For more details, see tp_call_content_send_tones_async().
| self | ||
| tones | a string representation of one or more DTMF events. | |
| cancellable | optional GCancellable object,  | |
| callback | a callback to call when the operation finishes | |
| user_data | data to pass to  | 
Since: 0.17.5
gboolean tp_call_channel_send_tones_finish (TpCallChannel *self,GAsyncResult *result,GError **error);
Finishes tp_call_channel_send_tones_async().
Since: 0.17.5
void tp_call_channel_set_ringing_async (TpCallChannel *self,GAsyncReadyCallback callback,gpointer user_data);
Indicate that the local user has been alerted about the incoming call.
| self | ||
| callback | a callback to call when the operation finishes | |
| user_data | data to pass to  | 
Since: 0.17.5
gboolean tp_call_channel_set_ringing_finish (TpCallChannel *self,GAsyncResult *result,GError **error);
Finishes tp_call_channel_set_ringing_async().
Since: 0.17.5
void tp_call_channel_set_queued_async (TpCallChannel *self,GAsyncReadyCallback callback,gpointer user_data);
Notifies the CM that the local user is already in a call, so this call has been put in a call-waiting style queue.
| self | ||
| callback | a callback to call when the operation finishes | |
| user_data | data to pass to  | 
Since: 0.17.5
gboolean tp_call_channel_set_queued_finish (TpCallChannel *self,GAsyncResult *result,GError **error);
Finishes tp_call_channel_set_queued_async().
Since: 0.17.5
void tp_call_channel_accept_async (TpCallChannel *self,GAsyncReadyCallback callback,gpointer user_data);
For incoming calls with “state” set to
TP_CALL_STATE_INITIALISED, accept the incoming call. This changes
“state” to TP_CALL_STATE_ACCEPTED.
For outgoing calls with “state” set to
TP_CALL_STATE_PENDING_INITIATOR, actually call the remote contact; this
changes “state” to
TP_CALL_STATE_INITIALISING.
| self | ||
| callback | a callback to call when the operation finishes | |
| user_data | data to pass to  | 
Since: 0.17.5
gboolean tp_call_channel_accept_finish (TpCallChannel *self,GAsyncResult *result,GError **error);
Finishes tp_call_channel_accept_async().
Since: 0.17.5
void tp_call_channel_hangup_async (TpCallChannel *self,TpCallStateChangeReason reason,const gchar *detailed_reason,const gchar *message,GAsyncReadyCallback callback,gpointer user_data);
Request that the call is ended. All contents will be removed from self
 so
that the “contents” property will be the empty list.
| self | ||
| reason | a TpCallStateChangeReason | |
| detailed_reason | a more specific reason for the call hangup, if one is
available, or an empty or  | |
| message | a human-readable message to be sent to the remote contact(s) | |
| callback | a callback to call when the operation finishes | |
| user_data | data to pass to  | 
Since: 0.17.5
gboolean tp_call_channel_hangup_finish (TpCallChannel *self,GAsyncResult *result,GError **error);
Finishes tp_call_channel_hangup_async().
Since: 0.17.5
void tp_call_channel_add_content_async (TpCallChannel *self,const gchar *name,TpMediaStreamType type,TpMediaStreamDirection initial_direction,GAsyncReadyCallback callback,gpointer user_data);
Request that a new Content of type type
 is added to self
. Callers should
check the value of the “mutable-contents” property before trying
to add another content as it might not be allowed.
| self | ||
| name | the suggested name of the content to add | |
| type | the media stream type of the content to be added to the call, from TpMediaStreamType | |
| initial_direction | The initial direction of the content | |
| callback | a callback to call when the operation finishes | |
| user_data | data to pass to  | 
Since: 0.17.5
TpCallContent * tp_call_channel_add_content_finish (TpCallChannel *self,GAsyncResult *result,GError **error);
Finishes tp_call_channel_add_content_async().
The returned TpCallContent is NOT guaranteed to have
TP_CALL_CONTENT_FEATURE_CORE prepared.
Since: 0.17.5
void tp_call_channel_request_hold_async (TpCallChannel *self,gboolean hold,GAsyncReadyCallback callback,gpointer user_data);
Requests that the connection manager holds or unholds the call. Watch “hold-state” property to know when the channel goes on hold or is unheld. Unholding may fail if the streaming implementation can not obtain all the resources needed to restart the call.
| self | ||
| hold | Whether to request a hold or a unhold | |
| callback | a callback to call when the operation finishes | |
| user_data | data to pass to  | 
Since: 0.17.6
gboolean tp_call_channel_request_hold_finish (TpCallChannel *self,GAsyncResult *result,GError **error);
Finishes tp_call_channel_request_hold_async
Since: 0.17.6
struct TpCallChannel;
Data structure representing a TpCallChannel.
Since: 0.17.5
struct TpCallChannelClass {
};
The class of a TpCallChannel.
Since: 0.17.5
#define TP_CALL_CHANNEL_FEATURE_CORE
Expands to a call to a function that returns a quark for the "core" feature on a TpCallChannel.
One can ask for a feature to be prepared using the tp_proxy_prepare_async()
function, and waiting for it to trigger the callback.
struct TpCallStateReason {
  TpHandle actor;
  TpCallStateChangeReason reason;
  gchar *dbus_reason;
  gchar *message;
};
Data structure representing the reason for a call state change.
| TpHandle  | the contact responsible for the change, or 0 if no contact was responsible | |
| TpCallStateChangeReason  | the reason for the change. If
TP_CALL_STATE_CHANGE_REASON_USER_REQUESTED then the  | |
| A specific reason for the change, which may be a D-Bus error in the Telepathy namespace, a D-Bus error in any other namespace (for implementation-specific errors), or the empty string to indicate that the state change was not an error | ||
| A developer readable debug message giving the reason for the state change. | 
Since: 0.17.5
“contents” property  “contents”                 GPtrArray *
GPtrArray of TpCallContent objects. The list of content objects that are part of this call.
It is NOT guaranteed that TP_CALL_CONTENT_FEATURE_CORE is prepared on
those objects.
Owner: TpCallChannel
Flags: Read
Since: 0.17.5
“flags” property  “flags”                    guint
A TpCallFlags specifying the flags of the call state.
Owner: TpCallChannel
Flags: Read
Default value: 0
Since: 0.17.5
“hardware-streaming” property  “hardware-streaming”       gboolean
Whether or not the streaming is done by dedicated hardware.
Owner: TpCallChannel
Flags: Read
Default value: FALSE
Since: 0.17.5
“hold-state” property  “hold-state”               guint
A TpLocalHoldState specifying if the Call is currently held
Owner: TpCallChannel
Flags: Read
Default value: 0
Since: 0.17.6
“hold-state-reason” property  “hold-state-reason”        guint
A TpLocalHoldStateReason specifying why the Call is currently held.
Owner: TpCallChannel
Flags: Read
Default value: 0
Since: 0.17.6
“initial-audio” property  “initial-audio”            gboolean
Whether or not the Call was started with audio.
Owner: TpCallChannel
Flags: Read
Default value: FALSE
Since: 0.17.5
“initial-audio-name” property  “initial-audio-name”       char *
If “initial-audio” is set to TRUE, then this property will
is the name of the intial audio content, NULL otherwise.
Owner: TpCallChannel
Flags: Read
Default value: NULL
Since: 0.17.5
“initial-video” property  “initial-video”            gboolean
Whether or not the Call was started with video.
Owner: TpCallChannel
Flags: Read
Default value: FALSE
Since: 0.17.5
“initial-video-name” property  “initial-video-name”       char *
If “initial-video” is set to TRUE, then this property will
is the name of the intial video content, NULL otherwise.
Owner: TpCallChannel
Flags: Read
Default value: NULL
Since: 0.17.5
“mutable-contents” property  “mutable-contents”         gboolean
Whether or not call contents can be added or removed.
Owner: TpCallChannel
Flags: Read
Default value: FALSE
Since: 0.17.5
“state” property  “state”                    guint
A TpCallState specifying the state of the call.
Owner: TpCallChannel
Flags: Read
Default value: 0
Since: 0.17.5
“state-details” property  “state-details”            GHashTable *
Detailed infoermation about “state”. It is a GHashTable mapping gchar*->GValue, it can be accessed using the tp_asv_* functions.
Owner: TpCallChannel
Flags: Read
Since: 0.17.5
“state-reason” property“state-reason” TpCallStateReason *
Reason why “state” last changed.
Owner: TpCallChannel
Flags: Read
Since: 0.17.5
“content-added” signalvoid user_function (TpCallChannel *self, GObject *content, gpointer user_data)
The ::content-added signal is emitted whenever a
TpCallContent is added to self
.
It is NOT guaranteed that TP_CALL_CONTENT_FEATURE_CORE is prepared on
content
.
| self | the TpCallChannel | |
| content | the newly added TpCallContent | |
| user_data | user data set when the signal handler was connected. | 
Flags: Run Last
Since: 0.17.5
“content-removed” signalvoid user_function (TpCallChannel *self, GObject *content, TpCallStateReason *reason, gpointer user_data)
The ::content-removed signal is emitted whenever a
TpCallContent is removed from self
.
It is NOT guaranteed that TP_CALL_CONTENT_FEATURE_CORE is prepared on
content
.
| self | the TpCallChannel | |
| content | the newly removed TpCallContent | |
| reason | ||
| user_data | user data set when the signal handler was connected. | 
Flags: Run Last
Since: 0.17.5
“members-changed” signalvoid user_function (TpCallChannel *self, GHashTable *updates, GPtrArray *removed, TpCallStateReason *reason, gpointer user_data)
The ::members-changed signal is emitted whenever the call's members changes.
The TpContact objects are guaranteed to have all of the features
previously passed to tp_simple_client_factory_add_contact_features()
prepared.
| self | the TpCallChannel | |
| updates | GHashTable mapping TpContact to its new TpCallMemberFlags. | [type GLib.HashTable][element-type TelepathyGLib.Contact uint] | 
| removed | GPtrArray of TpContact removed from the call members. | [type GLib.PtrArray][element-type TelepathyGLib.Contact] | 
| reason | the TpCallStateReason for the change | |
| user_data | user data set when the signal handler was connected. | 
Flags: Run Last
Since: 0.17.5
“state-changed” signalvoid user_function (TpCallChannel *self, guint state, guint flags, TpCallStateReason *reason, GHashTable *details, gpointer user_data)
The ::state-changed signal is emitted whenever the call state changes.
| self | the TpCallChannel | |
| state | the new TpCallState | |
| flags | the new TpCallFlags | |
| reason | the TpCallStateReason for the change | |
| details | additional details as a GHashTable readable using the tp_asv_* functions. | [element-type utf8 GObject.Value] | 
| user_data | user data set when the signal handler was connected. | 
Flags: Run Last
Since: 0.17.5