CallState

Description:

[ CCode ( cprefix = "TP_CALL_STATE_" , has_type_id = false ) ]
public enum CallState

The state of a call, as a whole.

The allowed transitions are: Pending_Initiator → Initialising (for outgoing calls, when Accept is called) Initialising → Initialised (for outgoing calls, when the remote client indicates that the user has been notified about the call. If the network is known not to provide feedback about whether the remote side is ringing, then the call should immediately be set to Initialised. Initialising → Initialised (for incoming calls, when e.g. the implementation has been initialised far enough that it is sensible to notify the user about the call (to reduce the probability that the user will pick up the call and have it immediately fail). The UI should then alert the user about the call, and call SetRinging) Initialised → Accepted (for outgoing calls to a contact, when the remote contact accepts the call; for incoming calls, when Accept is called.) Accepted → Active (when the local user successfully joins the call/conference, and media is known to be flowing successfully; also, when temporary connection problems are resolved (See below)). If the network is known not to provide feedback about when the call is properly connected, the call should immediately be set to Active. Active → Accepted (when there are temporary connection problems that the CM is aware of and able to recover from) any state → Ended (when the call is terminated normally, or when an error occurs that the CM is unable to recover from) Clients MAY consider unknown values from this enum to be an error - additional values will not be defined after the Call specification is declared to be stable.

Bitfield/set of flags generated from the Telepathy specification.


Namespace: TelepathyGLib
Package: telepathy-glib

Content:

Enum values:

  • ACCEPTED - The contact being called has accepted the call, but the call is not in the Active state (The most common reason for this is that the streaming implementation hasn't connected yet).
  • ACTIVE - The contact being called has accepted the call, and discourse between at least two parties should now be possible.
  • ENDED - The call has ended, either via normal termination or an error.
  • INITIALISED - In the outgoing case: at least one called user has been alerted about the call (a SIP 180 (Ringing) packet or equivalent has been received) but none have answered, so the call cannot go to Accepted (use Ringing to determine which members have been informed and which haven't, if you care).
  • INITIALISING - Progress has been made in placing the call, but the contact has not been made aware of the call yet.
  • PENDING_INITIATOR - The initiator of the call hasn't accepted the call yet.
  • UNKNOWN - The call state is not known.