647
edits
Changes
Jump to navigation
Jump to search
Line 5:
Line 5: + + Line 65:
Line 67: − + Line 103:
Line 105: − + − + Line 114:
Line 116: − + − + Line 124:
Line 126: − + Line 134:
Line 136: − + − + Line 172:
Line 174: − Line 180:
Line 181: − + − + − + Line 190:
Line 191: − + − + Line 200:
Line 201: − + − + Line 210:
Line 211: − + − + Line 220:
Line 221: − + − + Line 230:
Line 231: − + − + Line 240:
Line 241: − + − + Line 250:
Line 251: − + − + Line 260:
Line 261: − + − + − − * Future: + Line 273:
Line 273: − + − + − + Line 283:
Line 283: − + − + Line 293:
Line 293: − + − + Line 303:
Line 303: − + − + Line 313:
Line 313: − + − + − + Line 323:
Line 323: − + − + Line 333:
Line 333: − + − + − + Line 343:
Line 343: − + − + − + Line 353:
Line 353: − + − + − + Line 365:
Line 365: − + − + Line 378:
Line 378: − + − + Line 390:
Line 390: − + − + Line 400:
Line 400: − + − + Line 410:
Line 410: − + − + Line 420:
Line 420: − + − + Line 430:
Line 430: − + − + Line 440:
Line 440: − + − + − +
Development Team/Presence Service Removal (view source)
Revision as of 04:06, 15 March 2010
, 04:06, 15 March 2010no edit summary
* http://wiki.laptop.org/go/Activity_sharing
* http://wiki.laptop.org/go/Activity_sharing
* http://wiki.laptop.org/go/Presence_Service
* http://wiki.laptop.org/go/Presence_Service
* [http://people.collabora.co.uk/~cassidy/talks/sugar-camp-collab-archi-and-state-of-implementation.pdf Collaboration state of the art] (Guillaume Desmottes)
* [http://people.collabora.co.uk/~cassidy/talks/sugar-camp-futur-of-collab.pdf Future of collaboration] (Guillaume Desmottes)
== Interface org.laptop.Sugar.Presence ==
== Interface org.laptop.Sugar.Presence ==
* Present: Gets fired when a new channel that communicates with a contact is created.
* Present: Gets fired when a new channel that communicates with a contact is created.
* Future:
* Future: Should be fired on reception of an incoming channel (TODO: check the API in MC5 for this)
@dbus.service.method(PRESENCE_INTERFACE, in_signature="", out_signature="ao")
@dbus.service.method(PRESENCE_INTERFACE, in_signature="", out_signature="ao")
pass
pass
* Used by:
* Used by: activities to send invites.
* Present:
* Present: returns one of the tracked buddies, see BuddyAppeared.
* Future:
* Future:
pass
pass
* Used by:
* Used by: shell to get the buddy that offers/receives a file transfer from its contact handle, activities using SugarTubeConnection
* Present:
* Present: returns one of the tracked buddies, see BuddyAppeared
* Future:
* Future:
pass
pass
* Used by: shell to represent the buddy icon for the owner
* Used by: shell to represent the buddy icon for the owner, activity to get owner colors for saving to DS
* Present: color, tags and nick are retrieved from GConf, the public key from the owner.key.pub file
* Present: color, tags and nick are retrieved from GConf, the public key from the owner.key.pub file
pass
pass
* Used by: activities to interact with a connection manager
* Used by: activities to interact with a connection manager, shell to transfer files
* Present: returns the gabble CM if available or the salut one otherwise
* Present: returns the gabble CM if available or the salut one otherwise
* Future:
* Future: shell and activities should know which is the relevant connection for the current context
@dbus.service.method(PRESENCE_INTERFACE, in_signature="sssa{sv}",
@dbus.service.method(PRESENCE_INTERFACE, in_signature="sssa{sv}",
* Future: use the account API in MC5
* Future: use the account API in MC5
== Interface org.laptop.Sugar.Presence.Buddy ==
== Interface org.laptop.Sugar.Presence.Buddy ==
pass
pass
* Used by:
* Used by: avatars aren't used in Sugar as-of-yet
* Present:
* Present: fired when the buddy avatars are changed and when the local buddy's avatar is changed
* Future:
* Future: directly use the Avatar interfaces
@dbus.service.signal(_BUDDY_INTERFACE, signature="o")
@dbus.service.signal(_BUDDY_INTERFACE, signature="o")
pass
pass
* Used by:
* Used by: shell to know when the owner has accepted an invitation
* Present:
* Present: emitted when the buddy joins a valid activity, or an activity the user is in becomes valid
* Future:
* Future:
pass
pass
* Used by:
* Used by: apparently not used
* Present:
* Present: emitted when the buddy leaves an activity or the activity becomes non-valid
* Future:
* Future:
pass
pass
* Used by:
* Used by: Shell to update the nick, colors and current activity of other buddies
* Present:
* Present: fired on PropertiesChanged in org.laptop.Telepathy.BuddyInfo
* Future:
* Future:
pass
pass
* Used by:
* Used by: apparently not used
* Present:
* Present: fired when a contact has come online and for the owner when a CM gets connected
* Future:
* Future:
pass
pass
* Used by:
* Used by: avatars aren't used as of yet
* Present:
* Present: retrieved from org.freedesktop.Telepathy.Connection.Interface.Avatars with RequestAvatars
* Future:
* Future:
pass
pass
* Used by:
* Used by: not really used
* Present:
* Present: returns the activities a buddy is participating. This list is maintained via the MembersChanged signal in the org.freedesktop.Telepathy.Channel.Interface.Group interface of the channel associated to each activity.
* Future:
* Future:
pass
pass
* Used by:
* Used by: shell and activities to represent buddies
* Present:
* Present: returns the cached properties, which are maintained by listening to *Changed signals in org.laptop.Shell.Owner or via PropertiesChanged and GetProperties in BuddyInfo
* Future:
* Future:
pass
pass
* Used by:
* Used by: shell for starting a file transfer with a buddy, and maybe by activities (couldn't verify)
* Present:
* Present: a dict of contact handles is maintained for each buddy, indexed by CM
* Future:
== Interface org.laptop.Sugar.Presence.Activity ==
== Interface org.laptop.Sugar.Presence.Activity ==
pass
pass
* Used by:
* Used by: etoys
* Present:
* Present: we know a buddy has joined either by ActivitiesChanged in BuddyInfo when we aren't in this activity, or by GetAllMembers and MembersChanged in org.freedesktop.Telepathy.Channel.Interface.Group if we are already in. We also emit this signal for each buddy in an activity that has become valid.
* Future:
* Future: BuddyJoined is deprecated by BuddyHandleJoined
@dbus.service.signal(_ACTIVITY_INTERFACE, signature="ou")
@dbus.service.signal(_ACTIVITY_INTERFACE, signature="ou")
pass
pass
* Used by:
* Used by: shell to keep updated the friends tray, and activities to notify that one more buddy has joined
* Present:
* Present: see BuddyJoined for current implementation
* Future:
* Future:
pass
pass
* Used by:
* Used by: shell to keep updated the friends tray, and activities to notify that one more buddy has joined
* Present:
* Present: we know a buddy has left either by ActivitiesChanged in BuddyInfo when we aren't in this activity, or by GetAllMembers and MembersChanged in org.freedesktop.Telepathy.Channel.Interface.Group if we are already in. We also emit this signal for each buddy in an activity that has become valid.
* Future:
* Future:
pass
pass
* Used by:
* Used by: shell to display shared activities
* Present:
* Present: fired when ActivityPropertiesChanged in org.laptop.Telepathy.ActivityProperties is fired.
* Future:
* Future:
pass
pass
* Used by:
* Used by: couldn't find any use of it
* Present:
* Present: fired when the text and tubes channels get created
* Future:
* Future: drop it?
@dbus.service.method(_ACTIVITY_INTERFACE, in_signature="", out_signature="a{sv}")
@dbus.service.method(_ACTIVITY_INTERFACE, in_signature="", out_signature="a{sv}")
pass
pass
* Used by:
* Used by: shell to display shared activities
* Present:
* Present: returns the cached properties, which are updated by SetProperties for local activities, or by ActivityPropertiesChanged and GetProperties from org.laptop.Telepathy.ActivityProperties
* Future:
* Future:
pass
pass
* Used by:
* Used by: not used
* Present:
* Present: returns cached property
* Future:
* Future: drop?
@dbus.service.method(_ACTIVITY_INTERFACE, in_signature="", out_signature="s")
@dbus.service.method(_ACTIVITY_INTERFACE, in_signature="", out_signature="s")
pass
pass
* Used by:
* Used by: not used
* Present:
* Present: returns cached property
* Future:
* Future: drop?
@dbus.service.method(_ACTIVITY_INTERFACE, in_signature="", out_signature="s")
@dbus.service.method(_ACTIVITY_INTERFACE, in_signature="", out_signature="s")
pass
pass
* Used by:
* Used by: not used
* Present:
* Present: returns cached property
* Future:
* Future: drop?
@dbus.service.method(_ACTIVITY_INTERFACE,
@dbus.service.method(_ACTIVITY_INTERFACE,
pass
pass
* Used by:
* Used by: activities when the shell calls the Invite method in org.laptop.Activity
* Present:
* Present: calls AddMembers on the text channel for this buddy
* Future:
* Future:
pass
pass
* Used by:
* Used by: activities on resume to join an existing instance
* Present:
* Present: Create a room (if the activity is local), request a text and a tubes channels, then join the room with AddMembers
* Future:
* Future:
pass
pass
* Used by:
* Used by: activities when stopping
* Present:
* Present: closes the text channel, updates the buddies in the activity.
* Future:
* Future:
pass
pass
* Used by:
* Used by: shell for the friends tray, activities t know who is in the activity when it is joined
* Present:
* Present: returns cached list of buddies in the activity, see BuddyJoined for how this list is maintained
* Future:
* Future:
pass
pass
* Used by:
* Used by: activities to get a handle to the text and tubes channels.
* Present:
* Present: returns the text and tubes channels created when the activity was shared or joined.
* Future:
* Future:
pass
pass
* Used by:
* Used by: python activities when joining an existing activity
* Present:
* Present: same as GetChannels but with more useful info to reduce roundtrips
* Future:
* Future:
pass
pass
* Used by:
* Used by: local activities to set name, color, tags, etc
* Present:
* Present: calls SetProperties from org.laptop.Telepathy.ActivityProperties
* Future:
* Future:
pass
pass
* Used by:
* Used by: not used
* Present:
* Present: returns cached property
* Future:
* Future: drop?