TpBaseCallChannel: telepathy-glib API Reference Manual

## TpBaseCallChannel TpBaseCallChannel — base class for TpSvcChannelTypeCall implementations |

## Functions

void | (*TpBaseCallChannelVoidFunc) ()
TpBaseCallContent * | (*TpBaseCallChannelAddContentFunc) ()
void | (*TpBaseCallChannelHangupFunc) ()
TpCallState | tp_base_call_channel_get_state ()
void | tp_base_call_channel_set_state ()
gboolean | tp_base_call_channel_has_initial_audio ()
gboolean | tp_base_call_channel_has_initial_video ()
gboolean | tp_base_call_channel_has_mutable_contents ()
GList * | tp_base_call_channel_get_contents ()
void | tp_base_call_channel_add_content ()
void | tp_base_call_channel_remove_content ()
void | tp_base_call_channel_update_member_flags ()
void | tp_base_call_channel_remove_member ()
GHashTable * | tp_base_call_channel_get_call_members ()
void | tp_base_call_channel_remote_accept ()
gboolean | tp_base_call_channel_is_accepted ()

## Properties

guint | call-flags | Read
GHashTable_guint+guint_* | call-members | Read
guint | call-state | Read
GHashTable_gchararray+GValue_* | call-state-details | Read
GValueArray_guint+guint+gchararray+gchararray_* | call-state-reason | Read
GPtrArray_DBusGObjectPath_ * | contents | Read
gboolean | hardware-streaming | Read
gboolean | initial-audio | Read / Write / Construct Only
gchar * | initial-audio-name | Read / Write / Construct Only
gchar * | initial-tones | Read / Write / Construct Only
guint | initial-transport | Read / Write / Construct Only
gboolean | initial-video | Read / Write / Construct Only
gchar * | initial-video-name | Read / Write / Construct Only
GHashTable_guint+gchararray_* | member-identifiers | Read
gboolean | mutable-contents | Read / Write / Construct Only

## Types and Values

struct | TpBaseCallChannel
struct | TpBaseCallChannelClass

## Object Hierarchy

        GObject
        ╰── TpBaseChannel
            ╰── TpBaseCallChannel
                ╰── TpBaseMediaCallChannel

## Implemented Interfaces

TpBaseCallChannel implements TpSvcDBusProperties, TpSvcChannel, TpChannelIface, TpExportableChannel, TpSvcChannelTypeCall and TpSvcChannelInterfaceDTMF.

## Includes

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

## Description

This base class makes it easier to write TpSvcChannelTypeCall implementations by implementing its properties, and some of its methods.

Subclasses should fill in TpBaseCallChannelClass.accept, TpBaseCallChannelClass.add_content and TpBaseCallChannelClass.hangup virtual function.

## Functions

### TpBaseCallChannelVoidFunc ()

    void
    (*TpBaseCallChannelVoidFunc) (TpBaseCallChannel *self);

Signature of an implementation of TpBaseCallChannelClass.set_ringing, TpBaseCallChannelClass.set_queued and TpBaseCallChannelClass.accept.

#### Parameters

self | a TpBaseCallChannel |

Since: 0.17.5

### TpBaseCallChannelAddContentFunc ()

    TpBaseCallContent *
    (*TpBaseCallChannelAddContentFunc) (TpBaseCallChannel *self,
                                        const gchar *name,
                                        TpMediaStreamType media,
                                        TpMediaStreamDirection initial_direction,
                                        GError **error);

Signature of an implementation of TpBaseCallChannelClass.add_content.

#### Parameters

self | a TpBaseCallChannel |
name | the name for the new content |
media | a TpMediaStreamType |
initial_direction | the desired initial direction of streams in the new content |
error | a GError to fill |

#### Returns

a borrowed TpBaseCallContent.

Since: 0.17.5

### TpBaseCallChannelHangupFunc ()

    void
    (*TpBaseCallChannelHangupFunc) (TpBaseCallChannel *self,
                                    TpCallStateChangeReason reason,
                                    const gchar *detailed_reason,
                                    const gchar *message);

Signature of an implementation of TpBaseCallChannelClass.hangup.

#### Parameters

self | a TpBaseCallChannel |
reason | the TpCallStateChangeReason of the change |
detailed_reason | a more specific reason for the call hangup, if one is available, or an empty string otherwise. |
message | a human-readable message to be sent to the remote contact(s). |

Since: 0.17.5

### tp_base_call_channel_get_state ()

    TpCallState
    tp_base_call_channel_get_state (TpBaseCallChannel *self);

#### Parameters

self | a TpBaseCallChannel |

#### Returns

the value of “call-state”

Since: 0.17.5

### tp_base_call_channel_set_state ()

    void
    tp_base_call_channel_set_state (TpBaseCallChannel *self,
                                    TpCallState state,
                                    guint actor_handle,
                                    TpCallStateChangeReason reason,
                                    const gchar *dbus_reason,
                                    const gchar *message);

Changes the call state and emit StateChanged signal with the new state.

#### Parameters

self | a TpBaseCallChannel |
state | the new TpCallState |
actor_handle | the contact responsible for the change, or 0 if no contact was responsible. |
reason | the TpCallStateChangeReason of the change |
dbus_reason | 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. |
message | an optional debug message, to expediate debugging the potentially many processes involved in a call. |

Since: 0.17.5

### tp_base_call_channel_has_initial_audio ()

    gboolean
    tp_base_call_channel_has_initial_audio
                                   (TpBaseCallChannel *self,
                                    const gchar **initial_audio_name);

#### Parameters

self | a TpBaseCallChannel |
initial_audio_name | a place to set the value of “initial-audio-name”. | [out][allow-none][transfer none]

#### Returns

the value of “initial-audio”

Since: 0.17.5

### tp_base_call_channel_has_initial_video ()

    gboolean
    tp_base_call_channel_has_initial_video
                                   (TpBaseCallChannel *self,
                                    const gchar **initial_video_name);

#### Parameters

self | a TpBaseCallChannel |
initial_video_name | a place to set the value of “initial-video-name”. | [out][allow-none][transfer none]

#### Returns

the value of “initial-video”

Since: 0.17.5

### tp_base_call_channel_has_mutable_contents ()

    gboolean
    tp_base_call_channel_has_mutable_contents
                                   (TpBaseCallChannel *self);

#### Parameters

self | a TpBaseCallChannel |

#### Returns

the value of “mutable-contents”

Since: 0.17.5

### tp_base_call_channel_get_contents ()

    GList *
    tp_base_call_channel_get_contents (TpBaseCallChannel *self);

Get the contents of this call. The GList and its elements must not be freed and should be copied before doing any modification.

#### Parameters

self | a TpBaseCallChannel |

#### Returns

a GList of TpBaseCallContent

Since: 0.17.5

### tp_base_call_channel_add_content ()

    void
    tp_base_call_channel_add_content (TpBaseCallChannel *self,
                                      TpBaseCallContent *content);

Add `content` to `self` . If `content` 's “disposition” is `TP_CALL_CONTENT_DISPOSITION_INITIAL`, also set “initial-audio” and “initial-audio-name” properties (or “initial-video” and “initial-video-name”). Note that it is not allowed to add INITIAL contents after having registered `self` on the bus.

#### Parameters

self | a TpBaseCallChannel |
content | a TpBaseCallContent to add |

Since: 0.17.5

### tp_base_call_channel_remove_content ()

    void
    tp_base_call_channel_remove_content (TpBaseCallChannel *self,
                                         TpBaseCallContent *content,
                                         TpHandle actor_handle,
                                         TpCallStateChangeReason reason,
                                         const gchar *dbus_reason,
                                         const gchar *message);

Remove `content` from `self` .

#### Parameters

self | a TpBaseCallChannel |
content | a TpBaseCallContent to remove |
actor_handle | the contact responsible for the change, or 0 if no contact was responsible. |
reason | the TpCallStateChangeReason of the change |
dbus_reason | 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. |
message | an optional debug message, to expediate debugging the potentially many processes involved in a call. |

Since: 0.17.5

### tp_base_call_channel_update_member_flags ()

    void
    tp_base_call_channel_update_member_flags
                                   (TpBaseCallChannel *self,
                                    TpHandle contact,
                                    TpCallMemberFlags new_flags,
                                    TpHandle actor_handle,
                                    TpCallStateChangeReason reason,
                                    const gchar *dbus_reason,
                                    const gchar *message);

Add or update `contact` call member with `flags` flags.

#### Parameters

self | a TpBaseCallChannel |
contact | the contact to update |
new_flags | the new TpCallMemberFlags of `contact` |
actor_handle | the contact responsible for the change, or 0 if no contact was responsible. |
reason | the TpCallStateChangeReason of the change |
dbus_reason | 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. |
message | an optional debug message, to expediate debugging the potentially many processes involved in a call. |

Since: 0.17.5

### tp_base_call_channel_remove_member ()

    void
    tp_base_call_channel_remove_member (TpBaseCallChannel *self,
                                        TpHandle contact,
                                        TpHandle actor_handle,
                                        TpCallStateChangeReason reason,
                                        const gchar *dbus_reason,
                                        const gchar *message);

Remove `contact` from call members.

#### Parameters

self | a TpBaseCallChannel |
contact | the contact to remove |
actor_handle | the contact responsible for the change, or 0 if no contact was responsible. |
reason | the TpCallStateChangeReason of the change |
dbus_reason | 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. |
message | an optional debug message, to expediate debugging the potentially many processes involved in a call. |

Since: 0.17.5

### tp_base_call_channel_get_call_members ()

    GHashTable *
    tp_base_call_channel_get_call_members (TpBaseCallChannel *self);

#### Parameters

self | a TpBaseCallChannel |

#### Returns

the value of “call-members”.

Since: 0.17.5

### tp_base_call_channel_remote_accept ()

    void
    tp_base_call_channel_remote_accept (TpBaseCallChannel *self);

Must be called when the remote contact accepted the call. “call-state” must be either `TP_CALL_STATE_INITIALISED` or `TP_CALL_STATE_INITIALISING` and will then change to `TP_CALL_STATE_ACCEPTED`.

Must be used only for outgoing calls.

#### Parameters

self | a TpBaseCallChannel |

Since: 0.17.5

### tp_base_call_channel_is_accepted ()

    gboolean
    tp_base_call_channel_is_accepted (TpBaseCallChannel *self);

#### Parameters

self | a TpBaseCallChannel |

#### Returns

Whether or not the call has been remotely accepted.

Since: 0.17.5

## Types and Values

### struct TpBaseCallChannel

    struct TpBaseCallChannel;

A base class for call channel implementations

Since: 0.17.5

### struct TpBaseCallChannelClass

    struct TpBaseCallChannelClass {
      TpBaseCallChannelVoidFunc set_ringing;
      TpBaseCallChannelVoidFunc set_queued;
      TpBaseCallChannelVoidFunc accept;
      TpBaseCallChannelAddContentFunc add_content;
      TpBaseCallChannelHangupFunc hangup;
    };

The class structure for TpBaseCallChannel

#### Members

TpBaseCallChannelVoidFunc `set_ringing`; | Notify members that client is ringing. |
TpBaseCallChannelVoidFunc `set_queued`; | Notify members that call is queued. |
TpBaseCallChannelVoidFunc `accept`; | accept the call. Note that TpBaseMediaCallChannel subclasses should not override this virtual method, but TpBaseMediaCallChannelClass.accept instead. |
TpBaseCallChannelAddContentFunc `add_content`; | add content to the call. Implementation must call `tp_base_call_channel_add_content()`. Can be `NULL` if “mutable-contents” is `FALSE`. |
TpBaseCallChannelHangupFunc `hangup`; | hangup the call. |

Since: 0.17.5

## Property Details

### The `“call-flags”` property

      “call-flags”               guint

The flags of this call.

Owner: TpBaseCallChannel

Flags: Read

Default value: 0

Since: 0.17.5

### The `“call-members”` property

      “call-members”             GHashTable_guint+guint_*

GHashTable mapping TpHandle of each call member to their TpCallMemberFlags.

Owner: TpBaseCallChannel

Flags: Read

Since: 0.17.5

### The `“call-state”` property

      “call-state”               guint

The state of this call.

Owner: TpBaseCallChannel

Flags: Read

Default value: 0

Since: 0.17.5

### The `“call-state-details”` property

      “call-state-details”       GHashTable_gchararray+GValue_*

Details on the call state.

Owner: TpBaseCallChannel

Flags: Read

Since: 0.17.5

### The `“call-state-reason”` property

      “call-state-reason”        GValueArray_guint+guint+gchararray+gchararray_*

The reason for last call state change.

Owner: TpBaseCallChannel

Flags: Read

Since: 0.17.5

### The `“contents”` property

      “contents”                 GPtrArray_DBusGObjectPath_ *

GPtrArray of object-paths of the TpBaseCallContent objects.

Owner: TpBaseCallChannel

Flags: Read

Since: 0.17.5

### The `“hardware-streaming”` property

      “hardware-streaming”       gboolean

Indicate to clients whether or not this Connection Manager has hardware streaming.

Owner: TpBaseCallChannel

Flags: Read

Default value: FALSE

Since: 0.17.5

### The `“initial-audio”` property

      “initial-audio”            gboolean

If set to `TRUE` on a requested channel, subclass should immediately attempt to establish an audio stream to the remote contact.

Owner: TpBaseCallChannel

Flags: Read / Write / Construct Only

Default value: FALSE

Since: 0.17.5

### The `“initial-audio-name”` property

      “initial-audio-name”       gchar *

Name to use to create the audio TpBaseCallContent if “initial-audio” is set to `TRUE`.

Owner: TpBaseCallChannel

Flags: Read / Write / Construct Only

Default value: "audio"

Since: 0.17.5

### The `“initial-tones”` property

      “initial-tones”            gchar *

DTMF Tones to be played on the channel created.

Owner: TpBaseCallChannel

Flags: Read / Write / Construct Only

Default value: ""

Since: 0.17.5

### The `“initial-transport”` property

      “initial-transport”        guint

If set to `TRUE` on a requested channel, this indicates the transport that should be used for this call.

Owner: TpBaseCallChannel

Flags: Read / Write / Construct Only

Default value: 0

Since: 0.17.5

### The `“initial-video”` property

      “initial-video”            gboolean

If set to `TRUE` on a requested channel, subclass should immediately attempt to establish a video stream to the remote contact.

Owner: TpBaseCallChannel

Flags: Read / Write / Construct Only

Default value: FALSE

Since: 0.17.5

### The `“initial-video-name”` property

      “initial-video-name”       gchar *

Name to use to create the video TpBaseCallContent if “initial-video” is set to `TRUE`.

Owner: TpBaseCallChannel

Flags: Read / Write / Construct Only

Default value: "video"

Since: 0.17.5

### The `“member-identifiers”` property

      “member-identifiers”       GHashTable_guint+gchararray_*

GHashTable mapping TpHandle of each call member to their identifiers.

Owner: TpBaseCallChannel

Flags: Read

Since: 0.17.5

### The `“mutable-contents”` property

      “mutable-contents”         gboolean

Indicate to clients whether or not they can add/remove contents.

Owner: TpBaseCallChannel

Flags: Read / Write / Construct Only

Default value: FALSE

Since: 0.17.5

## See Also

TpSvcChannelTypeCall, TpBaseCallContent and TpBaseCallStream