Account objects store off of the information that is used for making a Connection to a remote service. Mission Control can be used to establish connections for valid accounts.
Account objects have object paths of the form /org/freedesktop/Telepathy/Account/cm/proto/acct where cm is the Connection Manager name (e.g. gabble, salut) and proto is the protocol name (as used in the object path of a Connection). Account objects implement the interface org.freedesktop.Telepathy.Account.
Settings for an account are managed through D-Bus properties. To reduce D-Bus roundtrips: bulk read the properties with the standard org.freedesktop.DBus.Properties.GetAll method; bulk set properties with the org.freedesktop.Telepathy.Account.UpdateParameters method. Table 3-1 shows the properties of an Account object.
Obtaining connections and managing the online/offline status of accounts is documented in Section 5.2.1 ― From the Account Manager.
| Read/Write Properties | |||
|---|---|---|---|
| Property | Type | Description | Example |
| DisplayName | String | The user-visible name of this account. This is how the account is referred to in the user interface, and should be able to be set by the user. | Jabber (bob@example.com), Work |
| Icon | String | The name of an icon in the system's icon theme or the empty string to not specify an icon (in which case one may be automatically chosen). | im-msn |
| Enabled | Boolean | Whether or not an account is enabled (whether or not it can be used to go online). N.B. this is different from whether or not it is Valid. | True |
| Nickname | String | The nickname to set on this account for display to other contacts, as set by the user. | Bob McBadgers |
| AutomaticPresence | SimplePresence | The presence status that this account should have if it is brought online. | |
| ConnectAutomatically | Boolean | Whether or not the Account Manager should automatically establish a Connection for this account. | True |
| RequestedPresence | SimplePresence | The requested presence for this account. | |
| Read-Only Properties | |||
|---|---|---|---|
| Property | Type | Description | Example |
| Interfaces | DBus_Interface[] | A list of the extra interfaces provided by this account. | org.freedesktop.Telepathy.Account.Interface.Avatar |
| Valid | Boolean | Whether this account is considered by the Account Manager to be complete and usable. | True |
| Parameters | Map | A map from connection manager parameter names (as in the ConnectionManager interface) to their values. | |
| Connection | Connection | Either the object path of the Connection to this account, or the special value '/' if there is no connection. | /org/freedesktop/Telepathy/Connection/gabble/jabber/bob_40example_2ecom_2fwork |
| ConnectionStatus | integer | If the Connection property is non-empty, the status of that connection. | |
| ConnectionStatusReason | integer | The reason for the last change to ConnectionStatus. | |
| CurrentPresence | SimplePresence | The actual presence of the account. | |
| NormalizedName | String | The normalized user ID of the local user on this account. | |