TpBaseMediaCallContent

TpBaseMediaCallContent — base class for TpSvcCallContentInterfaceMedia implementations

Synopsis

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

                    TpBaseMediaCallContent;
struct              TpBaseMediaCallContentClass;
GHashTable *        tp_base_media_call_content_get_local_media_description
                                                        (TpBaseMediaCallContent *self,
                                                         TpHandle contact);
void                tp_base_media_call_content_offer_media_description_async
                                                        (TpBaseMediaCallContent *self,
                                                         TpCallContentMediaDescription *md,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);
gboolean            tp_base_media_call_content_offer_media_description_finish
                                                        (TpBaseMediaCallContent *self,
                                                         GAsyncResult *result,
                                                         GError **error);

Object Hierarchy

  GObject
   +----TpBaseCallContent
         +----TpBaseMediaCallContent

Implemented Interfaces

TpBaseMediaCallContent implements TpSvcDBusProperties, TpSvcCallContent, TpSvcCallContentInterfaceDTMF and TpSvcCallContentInterfaceMedia.

Properties

  "current-dtmf-event"       guchar                : Read
  "current-dtmf-state"       guint                 : Read
  "local-media-descriptions" GHashTable_guint+GHashTable_gchararray+GValue__*  : Read
  "media-description-offer"  GValueArray_DBusGObjectPath+GHashTable_gchararray+GValue__*  : Read
  "packetization"            guint                 : Read / Write / Construct Only
  "remote-media-descriptions" GHashTable_guint+GHashTable_gchararray+GValue__*  : Read

Signals

  "local-media-description-updated"                : Run Last

Description

This base class makes it easier to write TpSvcCallContentInterfaceMedia implementations by implementing its properties and methods.

Subclasses must still implement TpBaseCallContent's virtual methods.

Details

TpBaseMediaCallContent

typedef struct _TpBaseMediaCallContent TpBaseMediaCallContent;

A base class for media call content implementations

Since 0.17.5


struct TpBaseMediaCallContentClass

struct TpBaseMediaCallContentClass {
};

The class structure for TpBaseMediaCallContent

Since 0.17.5


tp_base_media_call_content_get_local_media_description ()

GHashTable *        tp_base_media_call_content_get_local_media_description
                                                        (TpBaseMediaCallContent *self,
                                                         TpHandle contact);

Get the media description used to stream to contact.

self :

a TpBaseMediaCallContent

contact :

the contact

Returns :

borrowed GHashTable mapping iface propery string to GValue.

Since 0.17.5


tp_base_media_call_content_offer_media_description_async ()

void                tp_base_media_call_content_offer_media_description_async
                                                        (TpBaseMediaCallContent *self,
                                                         TpCallContentMediaDescription *md,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);

Offer md for media description negociation.

self :

a TpBaseMediaCallContent

md :

a TpCallContentMediaDescription

callback :

a callback to call when the operation finishes

user_data :

data to pass to callback

Since 0.17.5


tp_base_media_call_content_offer_media_description_finish ()

gboolean            tp_base_media_call_content_offer_media_description_finish
                                                        (TpBaseMediaCallContent *self,
                                                         GAsyncResult *result,
                                                         GError **error);

Finishes tp_base_media_call_content_offer_media_description_async().

self :

a TpBaseMediaCallContent

result :

a GAsyncResult

error :

a GError to fill

Since 0.17.5

Property Details

The "current-dtmf-event" property

  "current-dtmf-event"       guchar                : Read

The currently being played TpDTMFEvent if any

Allowed values: <= 15

Default value: 0

Since 0.17.5


The "current-dtmf-state" property

  "current-dtmf-state"       guint                 : Read

The TpSendingState of the dtmf events

Allowed values: <= 3

Default value: 0

Since 0.17.5


The "local-media-descriptions" property

  "local-media-descriptions" GHashTable_guint+GHashTable_gchararray+GValue__*  : Read

GHashTable{contact TpHandle, properties GHashTable} The map of contacts to local media descriptions.

Since 0.17.5


The "media-description-offer" property

  "media-description-offer"  GValueArray_DBusGObjectPath+GHashTable_gchararray+GValue__*  : Read

GValueArray{object-path, contact TpHandle, properties GHashTable}. The current media description offer if any.

Since 0.17.5


The "packetization" property

  "packetization"            guint                 : Read / Write / Construct Only

The TpCallContentPacketizationType of this content.

Default value: 0

Since 0.17.5


The "remote-media-descriptions" property

  "remote-media-descriptions" GHashTable_guint+GHashTable_gchararray+GValue__*  : Read

GHashTable{contact TpHandle, properties GHashTable} The map of contacts to remote media descriptions.

Since 0.17.5

Signal Details

The "local-media-description-updated" signal

void                user_function                      (TpBaseMediaCallContent *self,
                                                        guint                   contact,
                                                        GHashTable             *properties,
                                                        gpointer                user_data)       : Run Last

The ::local-media-description-changed signal is emitted whenever the local media description changes for a remote contact.

self :

the TpCallChannel

contact :

the remote contact

properties :

the new media description properties asv

user_data :

user data set when the signal handler was connected.

Since 0.17.5

See Also

TpSvcCallContentInterfaceMedia, TpBaseCallChannel, TpBaseCallContent and TpBaseCallStream