calls_call_get_number ()

const char *
calls_call_get_number (CallsCall *self);

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

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 number, or NULL

calls_call_get_state ()

CallsCallState
calls_call_get_state (CallsCall *self);

Get the current state of the call.

calls_call_get_inbound ()

gboolean
calls_call_get_inbound (CallsCall *self);

Get the direction of the call.

calls_call_get_protocol ()

const char *
calls_call_get_protocol (CallsCall *self);

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

calls_call_answer ()

void
calls_call_answer (CallsCall *self);

If the call is incoming, answer it.

calls_call_hang_up ()

void
calls_call_hang_up (CallsCall *self);

Hang up the call.

calls_call_tone_start ()

void
calls_call_tone_start (CallsCall *self,
                       gchar key);

Start playing a DTMF tone for the specified key. Implementations will stop playing the tone either after an implementation-specific timeout, or after calls_call_tone_stop is called with the same value for key .

calls_call_tone_stoppable ()

gboolean
calls_call_tone_stoppable (CallsCall *self);

Determine whether tones for this call can be stopped by calling calls_call_tone_stop. Some implementations will only allow fixed-length tones to be played. In that case, this function should return FALSE.

calls_call_tone_stop ()

void
calls_call_tone_stop (CallsCall *self,
                      gchar key);

Stop playing a DTMF tone previously started with calls_call_tone_start.

calls_call_get_contact ()

CallsBestMatch *
calls_call_get_contact (CallsCall *self);

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

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

CALLS_TYPE_CALL

#define CALLS_TYPE_CALL (calls_call_get_type ())

enum CallsCallState

struct CallsCallClass

struct CallsCallClass {
  GObjectClass parent_iface;

  const char     *(*get_number)           (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            (*tone_start)           (CallsCall *self,
                                           char       key);
  void            (*tone_stop)            (CallsCall *self,
                                           char       key);
};

CallsCall

typedef struct _CallsCall CallsCall;

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 “number” property

  “number”                   char *

The number the call is connected to if known.

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 “state” property

  “state”                    CallsCallState

The current state of the call.

Owner: CallsCall

Flags: Read

Default value: CALLS_CALL_STATE_ACTIVE

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.

Flags: Run Last