| Server IP : 182.53.201.61 / Your IP : 216.73.217.175 Web Server : Apache/2.2.15 (Fedora) System : Linux km10.dyndns.org 2.6.31.5-127.fc12.i686.PAE #1 SMP Sat Nov 7 21:25:57 EST 2009 i686 User : apache ( 48) PHP Version : 5.3.3 Disable Function : NONE MySQL : ON | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : ON Directory : /usr/lib/python2.6/site-packages/telepathy/_generated/ |
Upload File : |
L7Jc @ s2 d Z d d k Z d e i i f d YZ d S( s4 Copyright (C) 2005-2008 Collabora Limited
Copyright (C) 2005-2008 Nokia Corporation
Copyright (C) 2006 INdT
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
iNt ConnectionInterfaceAvatarsc B sj e Z d Z d Z e i i d d d d d d Z e i i d d d d d d
Z e i i d d d d d d Z e i i d d d
d d d Z
e i i d d d d d d Z e i i d d d d d d Z e i i d d d d d d Z
e i i d d d d Z e i i d d d d Z RS( s An interface for requesting avatars for contacts on a given connection,
receiving notification when avatars are changed, and publishing your own
avatar.
Avatars are identified by a string, the Avatar_Token,
which represents a particular avatar. Tokens MUST be chosen by the
connection manager in such a way that the triple
(Connection_Manager_Name, Protocol,
Avatar_Token) uniquely identifies an avatar.
An empty token means that an avatar has not been set for this contact, and
a changed token implies the contact's avatar has changed, but the strings
should otherwise be considered opaque by clients.
A client should use GetKnownAvatarTokens
to request the tokens for the
avatars of all the contacts it is interested in when it connects. The
avatars can then be requested using
RequestAvatars for the contacts. Clients
should bind to the AvatarUpdated signal and
request a new copy of
the avatar when a contacts' avatar token changes. Clients should cache the
token and data of each contact's avatar between connections, to avoid
repeatedly retrieving the same avatar.
To publish an avatar, a client should use
SetAvatar to provide an image which meets
the requirements returned by the
GetAvatarRequirements
function. On some protocols the avatar is stored on the server, so setting
the avatar is persistent, but on others it is transferred via a peer to
peer mechanism, so needs to be set every connection. Hence, on every
connection, clients should inspect the avatar token of the connection's
self handle using GetKnownAvatarTokens; if
the self handle is not in the
returned map, the client should re-set the avatar. If the self handle's
avatar token is known, but the avatar has been changed locally since the
last connection, the client should upload the new avatar; if the avatar has
not changed locally, then the client should download the avatar from the
server if its token differs from the that of the local avatar.
To remove the published avatar on protocols which have persistent avatars,
a client should use the ClearAvatar method.
This method can safely be used even if there is no avatar for this
connection.
c C s | i i d d S( Ns6 org.freedesktop.Telepathy.Connection.Interface.Avatars( t _interfacest add( t self( ( sU /usr/lib/python2.6/site-packages/telepathy/_generated/Connection_Interface_Avatars.pyt __init__J s s6 org.freedesktop.Telepathy.Connection.Interface.Avatarst in_signaturet t
out_signaturet asqqqquc C s
t d S( sO
Get the required format of avatars on this connection.
N( t NotImplementedError( R ( ( sU /usr/lib/python2.6/site-packages/telepathy/_generated/Connection_Interface_Avatars.pyt GetAvatarRequirementsM s t aut asc C s
t d S( s
Get the unique tokens for all of the given contacts' avatars.
Using this method in new Telepathy clients is deprecated; use
GetKnownAvatarTokens instead.
N( R ( R t Contacts( ( sU /usr/lib/python2.6/site-packages/telepathy/_generated/Connection_Interface_Avatars.pyt GetAvatarTokensU s s a{us}c C s
t d S( s
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. For handles other than
the self handle, only tokens that are already known are returned; an
empty token means the given contact has no avatar. However, a CM must
always have the tokens for the self handle if one is set (even if it is
set to no avatar). On protocols where the avatar does not persist
between connections, a CM should omit the self handle from the returned
map until an avatar is explicitly set or cleared.
N( R ( R R
( ( sU /usr/lib/python2.6/site-packages/telepathy/_generated/Connection_Interface_Avatars.pyt GetKnownAvatarTokens` s t ut aysc C s
t d S( s
Request the avatar for a given contact. Using this method in new
Telepathy clients is deprecated; use RequestAvatars instead.
N( R ( R t Contact( ( sU /usr/lib/python2.6/site-packages/telepathy/_generated/Connection_Interface_Avatars.pyt
RequestAvatarp s c C s
t d S( sT
Request avatars for a number of contacts. The
AvatarRetrieved signal is emitted for
each avatar retrieved. If the handles are valid but retrieving an
avatar fails (for any reason, including the contact not having an
avatar) the AvatarRetrieved signal is not emitted for that contact.
N( R ( R R
( ( sU /usr/lib/python2.6/site-packages/telepathy/_generated/Connection_Interface_Avatars.pyt RequestAvatarsy s
t sc C s
t d S( s
Set a new avatar image for this connection. The avatar image must
respect the requirements obtained by
GetAvatarRequirements.
N( R ( R t Avatart MIME_Type( ( sU /usr/lib/python2.6/site-packages/telepathy/_generated/Connection_Interface_Avatars.pyt SetAvatar s c C s
t d S( sE
Remove the avatar image for this connection.
N( R ( R ( ( sU /usr/lib/python2.6/site-packages/telepathy/_generated/Connection_Interface_Avatars.pyt ClearAvatar s t signaturet usc C s d S( s1
Emitted when the avatar for a contact has been updated, or first
discovered on this connection. If the token differs from the token
associated with the client's cached avatar for this contact, the new
avatar should be requested with
RequestAvatars.
N( ( R R t New_Avatar_Token( ( sU /usr/lib/python2.6/site-packages/telepathy/_generated/Connection_Interface_Avatars.pyt
AvatarUpdated s
t usaysc C s d S( sR
Emitted when the avatar for a contact has been retrieved.
N( ( R R t TokenR t Type( ( sU /usr/lib/python2.6/site-packages/telepathy/_generated/Connection_Interface_Avatars.pyt AvatarRetrieved s ( t __name__t
__module__t __doc__R t dbust servicet methodR
R R R R R R t signalR R! ( ( ( sU /usr/lib/python2.6/site-packages/telepathy/_generated/Connection_Interface_Avatars.pyR s . '' '' ' '
'! ( R$ t dbus.serviceR% R& t InterfaceR ( ( ( sU /usr/lib/python2.6/site-packages/telepathy/_generated/Connection_Interface_Avatars.pyt <module> s