Top | ![]() |
![]() |
![]() |
![]() |
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 () |
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'.
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.
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
CallsCallState
calls_call_get_state (CallsCall *self
);
Get the current state of the call.
gboolean
calls_call_get_inbound (CallsCall *self
);
Get the direction of the call.
const char *
calls_call_get_protocol (CallsCall *self
);
Get the protocol of the call (i.e. "tel", "sip")
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.
CallsBestMatch *
calls_call_get_contact (CallsCall *self
);
This a convenience function to optain the CallsBestMatch matching the phone id of the CallsCall.
void calls_call_state_to_string (GString *string
,CallsCallState state
);
gboolean calls_call_state_parse_nick (CallsCallState *state
,const char *nick
);
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); };
“id”
property “id” char *
The id the call is connected to if known.
Owner: CallsCall
Flags: Read
Default value: NULL
“inbound”
property “inbound” gboolean
Whether the call is inbound.
Owner: CallsCall
Flags: Read
Default value: FALSE
“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
“protocol”
property “protocol” char *
The protocol used for this call.
Owner: CallsCall
Flags: Read
Default value: NULL
“silenced”
property “silenced” gboolean
Whether the call ringing should be silenced.
Owner: CallsCall
Flags: Read
Default value: FALSE
“state”
property“state” CallsCallState
The current state of the call.
Owner: CallsCall
Flags: Read
Default value: CALLS_CALL_STATE_ACTIVE
“state-changed”
signalvoid 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.
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