telepathy-glib API Reference Manual | ||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties | Signals |
Synopsis
#include <telepathy-glib/telepathy-glib.h> TpCallContent; struct TpCallContentClass; void tp_call_content_init_known_interfaces (void
); #define TP_CALL_CONTENT_FEATURE_CORE TpCallContentDisposition tp_call_content_get_disposition (TpCallContent *self
); TpMediaStreamType tp_call_content_get_media_type (TpCallContent *self
); const gchar * tp_call_content_get_name (TpCallContent *self
); GPtrArray * tp_call_content_get_streams (TpCallContent *self
); void tp_call_content_remove_async (TpCallContent *self
,GAsyncReadyCallback callback
,gpointer user_data
); gboolean tp_call_content_remove_finish (TpCallContent *self
,GAsyncResult *result
,GError **error
); void tp_call_content_send_tones_async (TpCallContent *self
,const gchar *tones
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
); gboolean tp_call_content_send_tones_finish (TpCallContent *self
,GAsyncResult *result
,GError **error
);
Properties
"channel" TpCallChannel* : Read / Write / Construct Only "connection" TpConnection* : Read / Write / Construct Only "disposition" guint : Read "media-type" guint : Read "name" gchar* : Read "streams" GPtrArray* : Read
Description
TpCallContent is a sub-class of TpProxy providing convenient API to represent TpCallChannel's content.
Details
TpCallContent
typedef struct _TpCallContent TpCallContent;
Data structure representing a TpCallContent.
Since 0.17.5
tp_call_content_init_known_interfaces ()
void tp_call_content_init_known_interfaces
(void
);
Ensure that the known interfaces for TpCallContent have been set up.
This is done automatically when necessary, but for correct
overriding of library interfaces by local extensions, you should
call this function before calling
tp_proxy_or_subclass_hook_on_interface_add()
with first argument
TP_TYPE_CALL_CONTENT
.
Since 0.17.5
TP_CALL_CONTENT_FEATURE_CORE
#define TP_CALL_CONTENT_FEATURE_CORE
Expands to a call to a function that returns a quark for the "core" feature on a TpCallContent.
One can ask for a feature to be prepared using the tp_proxy_prepare_async()
function, and waiting for it to trigger the callback.
tp_call_content_get_disposition ()
TpCallContentDisposition tp_call_content_get_disposition
(TpCallContent *self
);
|
a TpCallContent |
Returns : |
the value of "disposition" |
Since 0.17.5
tp_call_content_get_media_type ()
TpMediaStreamType tp_call_content_get_media_type (TpCallContent *self
);
|
a TpCallContent |
Returns : |
the value of "name" |
Since 0.17.5
tp_call_content_get_name ()
const gchar * tp_call_content_get_name (TpCallContent *self
);
|
a TpCallContent |
Returns : |
the value of "name" |
Since 0.17.5
tp_call_content_get_streams ()
GPtrArray * tp_call_content_get_streams (TpCallContent *self
);
|
a TpCallContent |
Returns : |
the value of "streams". [transfer none][type GLib.PtrArray][element-type TelepathyGLib.CallStream] |
Since 0.17.5
tp_call_content_remove_async ()
void tp_call_content_remove_async (TpCallContent *self
,GAsyncReadyCallback callback
,gpointer user_data
);
Remove the content from the call. This will cause "removed" to be emitted.
|
a TpCallContent |
|
a callback to call when the operation finishes |
|
data to pass to callback
|
Since 0.17.5
tp_call_content_remove_finish ()
gboolean tp_call_content_remove_finish (TpCallContent *self
,GAsyncResult *result
,GError **error
);
Finishes tp_call_content_remove_async()
.
|
a TpCallContent |
|
a GAsyncResult |
|
a GError to fill |
Since 0.17.5
tp_call_content_send_tones_async ()
void tp_call_content_send_tones_async (TpCallContent *self
,const gchar *tones
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Send tones
DTMF code on self
content. self
must have the
TP_IFACE_CALL_CONTENT_INTERFACE_DTMF
interface.
If DTMF tones are already being played, this request is queued.
|
a TpCallContent |
|
a string representation of one or more DTMF events. |
|
optional GCancellable object, NULL to ignore |
|
a callback to call when the operation finishes |
|
data to pass to callback
|
Since 0.17.5
tp_call_content_send_tones_finish ()
gboolean tp_call_content_send_tones_finish (TpCallContent *self
,GAsyncResult *result
,GError **error
);
Finishes tp_call_content_send_tones_async()
.
|
a TpCallContent |
|
a GAsyncResult |
|
a GError to fill |
Returns : |
TRUE on success, FALSE otherwise. |
Since 0.17.5
Property Details
The "channel"
property
"channel" TpCallChannel* : Read / Write / Construct Only
The parent TpCallChannel of the content.
Since 0.17.6
The "connection"
property
"connection" TpConnection* : Read / Write / Construct Only
The TpConnection of the call.
Since 0.17.5
The "disposition"
property
"disposition" guint : Read
The disposition of this content, from TpCallContentDisposition.
Default value: 0
Since 0.17.5
The "media-type"
property
"media-type" guint : Read
The media type of this content, from TpMediaStreamType.
Default value: 0
Since 0.17.5
The "streams"
property
"streams" GPtrArray* : Read
GPtrArray of TpCallStream objects. The list of stream objects that are part of this content.
It is NOT guaranteed that TP_CALL_STREAM_FEATURE_CORE
is prepared on
those objects.
Since 0.17.5
Signal Details
The "removed"
signal
void user_function (TpCallContent *self,
gpointer user_data) : Run Last
The ::removed signal is emitted when self
is removed from
a TpCallChannel.
|
the TpCallContent |
|
user data set when the signal handler was connected. |
Since 0.17.5
The "streams-added"
signal
void user_function (TpCallContent *self,
GPtrArray *streams,
gpointer user_data) : Run Last
The ::streams-added signal is emitted whenever
TpCallStream are added to self
.
It is NOT guaranteed that TP_CALL_STREAM_FEATURE_CORE
is prepared on
stream objects.
|
the TpCallContent |
|
a GPtrArray of newly added TpCallStream. [type GLib.PtrArray][element-type TelepathyGLib.CallStream] |
|
user data set when the signal handler was connected. |
Since 0.17.5
The "streams-removed"
signal
void user_function (TpCallContent *self,
GPtrArray *streams,
TpCallStateReason *reason,
gpointer user_data) : Run Last
The ::streams-removed signal is emitted whenever
TpCallStreams are removed from self
.
It is NOT guaranteed that TP_CALL_STREAM_FEATURE_CORE
is prepared on
stream objects.
|
the TpCallContent |
|
a GPtrArray of newly removed TpCallStream. [type GLib.PtrArray][element-type TelepathyGLib.CallStream] |
|
a TpCallStateReason |
|
user data set when the signal handler was connected. |
Since 0.17.5