Methods
| SetURISchemeAssociation | (s: URI_Scheme, b: Association) | → | nothing |
Properties
| URISchemes | as | Read only |
PropertiesChanged signal is now used
for URISchemes property change notifications.
Description
Some accounts can be used for multiple protocols; for instance, SIP and Skype accounts can often be used to contact the PSTN, MSN and Yahoo accounts can contact each other, and XMPP accounts can potentially contact many protocols via a transport.
However, if the user does not intend to make use of this functionality, user interfaces can improve clarity by not displaying it: for instance, if a user prefers to call phone numbers via a particular SIP account, when an address book displays a contact with a phone number, it is desirable to display a "call with SIP" button for that account, but avoid displaying similar buttons for any other configured SIP or Skype accounts.
The purpose of this interface is to allow this "for use with" information to be recorded and retrieved.
Methods
SetURISchemeAssociation (s: URI_Scheme, b: Association) → nothing
Parameters
- URI_Scheme — s
- Association — b
URI scheme to associate/disassociate the account with/from
True to associate this account with a given addressing scheme
False if the account should not be associated with said scheme
Associate (or disassociate) an account with a particular URI addressing scheme, (such as 'tel' for telephony)
Properties
URISchemes — as
org.freedesktop.DBus.Properties.PropertiesChanged
signal is emitted with the new value.
A list of fields indicating the type of URI addressing scheme the the account should be used for (eg 'tel') indicating the account is intended for use by applications offering a telephony UI, or 'sip' or 'xmpp' for those protocols
Note that these fields signify intent, not ability: It is entirely possible that an account which can be used for a given URI scheme is not wanted for it by the user, and therefore not flagged as such in this field.
Change notification for this property is provided by the
standard D-Bus PropertiesChanged signal.