CallsCall

CallsCall — A call.

Functions

const char * calls_call_get_id ()
const char * calls_call_get_name ()
CallsCallState calls_call_get_state ()
gboolean calls_call_get_inbound ()
const char * calls_call_get_protocol ()
void calls_call_answer ()
void calls_call_hang_up ()
gboolean calls_call_can_dtmf ()
void calls_call_send_dtmf_tone ()
CallsBestMatch * calls_call_get_contact ()
void calls_call_silence_ring ()
gboolean calls_call_get_silenced ()
void calls_call_state_to_string ()
gboolean calls_call_state_parse_nick ()

Properties

char * id Read
gboolean inbound Read
char * name Read
char * protocol Read
gboolean silenced Read
CallsCallState state Read

Signals

void state-changed Run Last

Types and Values

#define CALLS_TYPE_CALL
enum CallsCallState
struct CallsCallClass
  CallsCall

Object Hierarchy

    GEnum
    ╰── CallsCallState
    GObject
    ╰── CallsCall

Description

This is the interface to a call. It has a id, name and a state. Only the state changes after creation. If the state is CALL_CALL_STATE_INCOMING, the call can be answered with answer. The call can also be hung up at any time with hang_up.

DTMF tones can be played the call using send_dtmf Valid characters for the key are 0-9, '*', '#', 'A', 'B', 'C' and 'D'.

Functions

calls_call_get_id ()

const char *
calls_call_get_id (CallsCall *self);

Get the id the call is connected to. It is possible that this could return NULL if the id is not known, for example if an incoming PTSN call has no caller ID information.

Parameters

self

a CallsCall

  

Returns

the id, or NULL.

[transfer none]

calls_call_get_name ()

const char *
calls_call_get_name (CallsCall *self);

Get the name of the party the call is connected to, if the network provides it.

Returns the id, or NULL

Parameters

self

a CallsCall

  

calls_call_get_state ()

CallsCallState
calls_call_get_state (CallsCall *self);

Get the current state of the call.

Parameters

self

a CallsCall

  

Returns

the state

calls_call_get_inbound ()

gboolean
calls_call_get_inbound (CallsCall *self);

Get the direction of the call.

Parameters

self

a CallsCall

  

Returns

TRUE if inbound, FALSE if outbound.

calls_call_get_protocol ()

const char *
calls_call_get_protocol (CallsCall *self);

Get the protocol of the call (i.e. "tel", "sip")

Parameters

self

a CallsCall

  

Returns

The protocol used or NULL when unknown

calls_call_answer ()

void
calls_call_answer (CallsCall *self);

If the call is incoming, answer it.

Parameters

self

a CallsCall

  

calls_call_hang_up ()

void
calls_call_hang_up (CallsCall *self);

Hang up the call.

Parameters

self

a CallsCall

  

calls_call_can_dtmf ()

gboolean
calls_call_can_dtmf (CallsCall *self);

Parameters

self

a CallsCall

  

Returns

TRUE if this call supports DTMF, FALSE otherwise

calls_call_send_dtmf_tone ()

void
calls_call_send_dtmf_tone (CallsCall *self,
                           char key);

Start playing a DTMF tone for the specified key. Implementations will stop playing the tone either after an implementation-specific timeout.

Parameters

self

a CallsCall

  

key

which tone to start

  

calls_call_get_contact ()

CallsBestMatch *
calls_call_get_contact (CallsCall *self);

This a convenience function to optain the CallsBestMatch matching the phone id of the CallsCall.

Parameters

self

a CallsCall

  

Returns

A CallsBestMatch.

[transfer full]

calls_call_silence_ring ()

void
calls_call_silence_ring (CallsCall *self);

Inhibit ringing

Parameters

self

a CallsCall

  

calls_call_get_silenced ()

gboolean
calls_call_get_silenced (CallsCall *self);

Parameters

self

a CallsCall

  

Returns

TRUE if call has been silenced to not ring, FALSE otherwise

calls_call_state_to_string ()

void
calls_call_state_to_string (GString *string,
                            CallsCallState state);

calls_call_state_parse_nick ()

gboolean
calls_call_state_parse_nick (CallsCallState *state,
                             const char *nick);

Types and Values

CALLS_TYPE_CALL

#define CALLS_TYPE_CALL (calls_call_get_type ())

enum CallsCallState

Members

CALLS_CALL_STATE_ACTIVE

    

CALLS_CALL_STATE_HELD

    

CALLS_CALL_STATE_DIALING

    

CALLS_CALL_STATE_ALERTING

    

CALLS_CALL_STATE_INCOMING

    

CALLS_CALL_STATE_WAITING

    

CALLS_CALL_STATE_DISCONNECTED

    

struct CallsCallClass

struct CallsCallClass {
  GObjectClass parent_iface;

  const char     *(*get_id)               (CallsCall *self);
  const char     *(*get_name)             (CallsCall *self);
  CallsCallState  (*get_state)            (CallsCall *self);
  gboolean        (*get_inbound)          (CallsCall *self);
  const char     *(*get_protocol)         (CallsCall *self);
  void            (*answer)               (CallsCall *self);
  void            (*hang_up)              (CallsCall *self);
  void            (*send_dtmf_tone)       (CallsCall *self,
                                           char       key);
};

CallsCall

typedef struct _CallsCall CallsCall;

Property Details

The “id” property

  “id”                       char *

The id the call is connected to if known.

Owner: CallsCall

Flags: Read

Default value: NULL

The “inbound” property

  “inbound”                  gboolean

Whether the call is inbound.

Owner: CallsCall

Flags: Read

Default value: FALSE

The “name” property

  “name”                     char *

The name of the party the call is connected to, if the network provides it.

Owner: CallsCall

Flags: Read

Default value: NULL

The “protocol” property

  “protocol”                 char *

The protocol used for this call.

Owner: CallsCall

Flags: Read

Default value: NULL

The “silenced” property

  “silenced”                 gboolean

Whether the call ringing should be silenced.

Owner: CallsCall

Flags: Read

Default value: FALSE

The “state” property

  “state”                    CallsCallState

The current state of the call.

Owner: CallsCall

Flags: Read

Default value: CALLS_CALL_STATE_ACTIVE

Signal Details

The “state-changed” signal

void
user_function (CallsCall     *self,
               CallsCallState new_state,
               CallsCallState old_state,
               gpointer       user_data)

This signal is emitted when the state of the call changes, for example when it's answered or when the call is disconnected.

Parameters

self

The CallsCall instance.

  

new_state

The new state of the call.

  

old_state

The old state of the call.

  

user_data

user data set when the signal handler was connected.

  

Flags: Run Last

Generated by GTK-Doc V1.33.1