diff options
| author | Alban Crequy <alban.crequy@collabora.co.uk> | 2008-09-03 16:24:02 +0100 |
|---|---|---|
| committer | Alban Crequy <alban.crequy@collabora.co.uk> | 2008-09-11 18:42:51 +0100 |
| commit | 5fb733a278e57d65936d28c8aff5492b9ed6fa68 (patch) | |
| tree | 98c5c6b826d6bc761cfc7ab9f449986be4fe19eb /spec/Connection_Interface_Contact_Capabilities.xml | |
| parent | 5be274743d22067d3c09a469ea96f5d0930b2ab6 (diff) | |
Add AdvertiseContactCapabilities
Diffstat (limited to 'spec/Connection_Interface_Contact_Capabilities.xml')
| -rw-r--r-- | spec/Connection_Interface_Contact_Capabilities.xml | 43 |
1 files changed, 40 insertions, 3 deletions
diff --git a/spec/Connection_Interface_Contact_Capabilities.xml b/spec/Connection_Interface_Contact_Capabilities.xml index 3aa19095..098a81e1 100644 --- a/spec/Connection_Interface_Contact_Capabilities.xml +++ b/spec/Connection_Interface_Contact_Capabilities.xml @@ -34,18 +34,55 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</ channel type for that activity, and channel properties which can be requested.</p> - <!-- Not yet spec'ed - <p>This interface also provides for user interfaces notifying the connection manager of what capabilities to advertise for the user. This is done by using the AdvertiseContactCapabilities method, and deals with the interface names of channel types and the channel properties values pertaining to them which are implemented by available client processes.</p> - --> </tp:docstring> + <method name="AdvertiseContactCapabilities"> + <arg direction="in" name="add" type="aa{sv}" + tp:type="String_Variant_Map[]"> + <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> + An array of channel classes to add to the list of what the connection + can handle + </tp:docstring> + </arg> + <arg direction="in" name="remove" type="aa{sv}" + tp:type="String_Variant_Map[]"> + <tp:docstring> + An array of channel classes to remove from the list of what the + connection can handle + </tp:docstring> + </arg> + <arg direction="out" type="aa{sv}" tp:type="String_Variant_Map[]"> + <tp:docstring> + An array of channel classes describing the current capabilities. + </tp:docstring> + </arg> + <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> + <p>Used by user interfaces to indicate which channel types they are able + to handle on this connection. Because these may be provided by + different client processes, this method accepts channel types to add + and remove from the set already advertised on this connection.</p> + + <p>Upon a successful invocation of this method, the + ContactCapabilitiesChanged signal will be emitted for the user's own + handle (as returned by GetSelfHandle) by the connection manager to + indicate the changes that have been made. This signal should also be + monitored to ensure that the set is kept accurate - for example, a + client may remove capabilities when it exits which are still provided + by another client.</p> + </tp:docstring> + <tp:possible-errors> + <tp:error name="org.freedesktop.Telepathy.Error.NetworkError"/> + <tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/> + </tp:possible-errors> + </method> + <method name="GetContactCapabilities"> <arg direction="in" name="handles" type="au" tp:type="Contact_Handle[]"> <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> |