SetPresence ( i: presence, s: message ) -> None
Request a presence
presence - any of the following values:
0 - MC_PRESENCE_UNSET
1 - MC_PRESENCE_OFFLINE
2 - MC_PRESENCE_AVAILABLE
3 - MC_PRESENCE_AWAY
4 - MC_PRESENCE_EXTENDED_AWAY
5 - MC_PRESENCE_HIDDEN
6 - MC_PRESENCE_DO_NOT_DISTURB
message - NULL or a message string to specify along with the presence (typically with away presence).
GetPresence ( ) -> i
Get the last requested presence.
GetPresenceActual ( ) -> i
Get the current presence (which could be different from the last requested presence).
RequestChannel ( s: account_name, s: type, u: handle, i: handle_type ) -> None
Request a channel for a given numeric handle.
account_name - the name of the account requesting the channel
type - a D-Bus interface name representing base channel type
handle - an integer handle representing a contact, room or list
handle_type - an integer representing the handle type
RequestChannelWithStringHandle ( s: account_name, s: type, s: handle, i: handle_type ) -> None
Request a channel for a given string handle.
account_name - the name of the account requesting the channel
type - a D-Bus interface name representing base channel type
handle - a string representing a contact, room or list
handle_type - an integer representing the handle type
CancelChannelRequest ( u: operation_id ) -> None
Cancel a channel request; if the channel has already been created, it will be destroyed.
operation_id - the unique id of the channel request operation. (this is the serial parameter of the RequestChannelWithStringHandle call — specs are going to change soon, though)
ConnectAllWithDefaultPresence ( ) -> None
Connect all accounts with the default online presence.
GetConnectionStatus ( s: account_name ) -> u
Get the connection status for the specified account.
account_name - the account to retrieve the status from
A unsigned integer as defined in Telepathy:
0 - CONNECTION_STATUS_CONNECTED
1 - CONNECTION_STATUS_CONNECTING
2 - CONNECTION_STATUS_DISCONNECTED
GetOnlineConnections ( ) -> as
Get the online connections.
An array of the names of the online accounts.
GetConnection ( s: account_name ) -> s, o
Get the connection status for the specified account.
account_name - the account to retrieve the connection from
s: the connection bus name
o: the connection object path
GetAccountForConnection ( s: object_path ) -> s
Get the connection's account.
object_path - the connection's object path
s: the account name
GetUsedChannelsCount ( s: type ) -> u
Get the number of channels of the specified type.
type - the channel type
u: the number of existing channels of this type
AccountStatusChanged ( u: status, u: presence, u: reason, s: account_id )
Emitted when the status of some account changes.
status - the connection status of the account
presence - the presence status of the account
reason - the reason why the status change happened. Can be any of the following:
0 - TP_CONN_STATUS_REASON_NONE_SPECIFIED
1 - TP_CONN_STATUS_REASON_REQUESTED
2 - TP_CONN_STATUS_REASON_NETWORK_ERROR
3 - TP_CONN_STATUS_REASON_AUTHENTICATION_FAILED
4 - TP_CONN_STATUS_REASON_ENCRYPTION_ERROR
5 - TP_CONN_STATUS_REASON_NAME_IN_USE
6 - TP_CONN_STATUS_REASON_CERT_NOT_PROVIDED
7 - TP_CONN_STATUS_REASON_CERT_UNTRUSTED
8 - TP_CONN_STATUS_REASON_CERT_EXPIRED
9 - TP_CONN_STATUS_REASON_CERT_NOT_ACTIVATED
10 - TP_CONN_STATUS_REASON_CERT_HOSTNAME_MISMATCH
11 - TP_CONN_STATUS_REASON_CERT_FINGERPRINT_MISMATCH
12 - TP_CONN_STATUS_REASON_CERT_SELF_SIGNED
13 - TP_CONN_STATUS_REASON_CERT_OTHER_ERROR
account_id - the account whose status has changed
McdError ( u: serial, s: client_id, u: error_id )
Emitted on some error.
serial -
operation ID, maybe it will get removed from the specs soon
client_id - the d-bus unique name of the client whose this error is meant to
error_id - the error code:
0 - MC_DISCONNECTED_ERROR
1 - MC_INVALID_HANDLE_ERROR
2 - MC_NO_MATCHING_CONNECTION_ERROR
3 - MC_INVALID_ACCOUNT_ERROR
4 - MC_PRESENCE_FAILURE_ERROR
5 - MC_NO_ACCOUNTS_ERROR
6 - MC_NETWORK_ERROR
7 - MC_CONTACT_DOES_NOT_SUPPORT_VOICE_ERROR
8 - MC_LOWMEM_ERROR
9 - MC_CHANNEL_REQUEST_GENERIC_ERROR
10 - MC_CHANNEL_BANNED_ERROR
11 - MC_CHANNEL_FULL_ERROR
12 - MC_CHANNEL_INVITE_ONLY_ERROR
13 - MC_LAST_ERROR
PresenceStatusRequested ( u: presence )
Emitted when a presence has been requested.
presence - the requested presence.
PresenceStatusActual ( u: presence )
Emitted when the actual presence changes.
presence - the actual presence.
UsedChannelsCountChanged ( s: type, u: count )
Emitted when the actual presence changes.
type - the type of the channels
count - the new number of the channels of this type
StatusActual ( u: status, u: presence )
Emitted when the accounts' status changes.
status - Can be one of these values:
0 - MC_STATUS_DISCONNECTED
When all accounts are disconnected.
1 - MC_STATUS_CONNECTING
When at least one account is connecting.
2 - MC_STATUS_CONNECTED
When at least one account is connected and none is connecting.
presence - the last requested presence.