summaryrefslogtreecommitdiff
path: root/spec/Connection_Interface_Avatars.xml
diff options
context:
space:
mode:
authorSenko Rasic <senko.rasic@collabora.co.uk>2007-08-27 22:05:56 +0000
committerSenko Rasic <senko.rasic@collabora.co.uk>2007-08-27 22:05:56 +0000
commit2257b14caf13d0f205c1219bb7d774d1f5195a8d (patch)
tree12cb9dd8bec35f14ade5956696f064f71e69403b /spec/Connection_Interface_Avatars.xml
parentfdd3ec2e75c8c01471e60a7c159a4b3cadddd555 (diff)
downloadtelepathy-glib-2257b14caf13d0f205c1219bb7d774d1f5195a8d.tar.gz
Connection.Interface.Avatars: added new GetKnownAvatarTokens() method and deprecate the old GetAvatarTokens() one
20070827220556-01440-7339a14bc3fb6b550ea5612d637302d65b713f79.gz
Diffstat (limited to 'spec/Connection_Interface_Avatars.xml')
-rw-r--r--spec/Connection_Interface_Avatars.xml29
1 files changed, 28 insertions, 1 deletions
diff --git a/spec/Connection_Interface_Avatars.xml b/spec/Connection_Interface_Avatars.xml
index bf36793c1..ede3af7fe 100644
--- a/spec/Connection_Interface_Avatars.xml
+++ b/spec/Connection_Interface_Avatars.xml
@@ -118,6 +118,32 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
</tp:docstring>
</arg>
<tp:docstring>
+ Get the unique tokens for all of the given contacts' avatars.
+
+ Using this method in new Telepathy clients is deprecated; use
+ GetKnownAvatarTokens instead.
+ </tp:docstring>
+ <tp:possible-errors>
+ <tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/>
+ <tp:error name="org.freedesktop.Telepathy.Error.NetworkError"/>
+ <tp:error name="org.freedesktop.Telepathy.Error.InvalidArgument"/>
+ <tp:error name="org.freedesktop.Telepathy.Error.PermissionDenied"/>
+ <tp:error name="org.freedesktop.Telepathy.Error.NotAvailable"/>
+ </tp:possible-errors>
+ </method>
+ <method name="GetKnownAvatarTokens">
+ <arg direction="in" name="contacts" type="au" tp:type="Contact_Handle[]">
+ <tp:docstring>
+ An array of handles representing contacts
+ </tp:docstring>
+ </arg>
+ <arg direction="out" type="a{us}">
+ <tp:docstring>
+ A dictionary of handles mapped to avatar tokens, containing only
+ the known avatar tokens.
+ </tp:docstring>
+ </arg>
+ <tp:docstring>
Get the unique tokens for the given contacts' avatars. These tokens
can be persisted across connections, and should be used by the client
to check whether the avatars have been updated. A empty token means
@@ -149,7 +175,8 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
</tp:docstring>
</arg>
<tp:docstring>
- Request the avatar for a given contact.
+ Request the avatar for a given contact. Using this method in new
+ Telepathy clients is deprecated; use RequestAvatars instead.
</tp:docstring>
<tp:possible-errors>
<tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/>