TpCallContent

TpCallContent — proxy object for a call content

Functions

Properties

TpCallChannel * channel Read / Write / Construct Only
TpConnection * connection Read / Write / Construct Only
guint disposition Read
guint media-type Read
gchar * name Read
GPtrArray * streams Read

Signals

void removed Run Last
void streams-added Run Last
void streams-removed Run Last

Types and Values

Object Hierarchy

    GObject
    ╰── TpProxy
        ╰── TpCallContent

Includes

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

Description

TpCallContent is a sub-class of TpProxy providing convenient API to represent TpCallChannel's content.

Functions

tp_call_content_get_disposition ()

TpCallContentDisposition
tp_call_content_get_disposition (TpCallContent *self);

Parameters

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);

Parameters

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);

Parameters

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);

Parameters

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.

Parameters

self

a TpCallContent

 

callback

a callback to call when the operation finishes

 

user_data

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().

Parameters

self

a TpCallContent

 

result

a GAsyncResult

 

error

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.

Parameters

self

a TpCallContent

 

tones

a string representation of one or more DTMF events.

 

cancellable

optional GCancellable object, NULL to ignore

 

callback

a callback to call when the operation finishes

 

user_data

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().

Parameters

self

a TpCallContent

 

result

a GAsyncResult

 

error

a GError to fill

 

Returns

TRUE on success, FALSE otherwise.

Since 0.17.5

Types and Values

TpCallContent

typedef struct _TpCallContent TpCallContent;

Data structure representing a TpCallContent.

Since 0.17.5


struct TpCallContentClass

struct TpCallContentClass {
};

The class of a TpCallContent.

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.

Property Details

The “channel” property

  “channel”                  TpCallChannel *

The parent TpCallChannel of the content.

Flags: Read / Write / Construct Only

Since 0.17.6


The “connection” property

  “connection”               TpConnection *

The TpConnection of the call.

Flags: Read / Write / Construct Only

Since 0.17.5


The “disposition” property

  “disposition”              guint

The disposition of this content, from TpCallContentDisposition.

Flags: Read

Default value: 0

Since 0.17.5


The “media-type” property

  “media-type”               guint

The media type of this content, from TpMediaStreamType.

Flags: Read

Default value: 0

Since 0.17.5


The “name” property

  “name”                     gchar *

The name of this content.

Flags: Read

Default value: ""

Since 0.17.5


The “streams” property

  “streams”                  GPtrArray *

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.

Flags: Read

Since 0.17.5

Signal Details

The “removed” signal

void
user_function (TpCallContent *self,
               gpointer       user_data)

The ::removed signal is emitted when self is removed from a TpCallChannel.

Parameters

self

the TpCallContent

 

user_data

user data set when the signal handler was connected.

 

Flags: Run Last

Since 0.17.5


The “streams-added” signal

void
user_function (TpCallContent *self,
               GPtrArray     *streams,
               gpointer       user_data)

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.

Parameters

self

the TpCallContent

 

streams

a GPtrArray of newly added TpCallStream.

[type GLib.PtrArray][element-type TelepathyGLib.CallStream]

user_data

user data set when the signal handler was connected.

 

Flags: Run Last

Since 0.17.5


The “streams-removed” signal

void
user_function (TpCallContent     *self,
               GPtrArray         *streams,
               TpCallStateReason *reason,
               gpointer           user_data)

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.

Parameters

self

the TpCallContent

 

streams

a GPtrArray of newly removed TpCallStream.

[type GLib.PtrArray][element-type TelepathyGLib.CallStream]

reason

a TpCallStateReason

 

user_data

user data set when the signal handler was connected.

 

Flags: Run Last

Since 0.17.5