Changes

Jump to navigation Jump to search
no edit summary
Line 5: Line 5:  
* 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 ==
Line 271: Line 273:  
     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")
Line 281: Line 283:  
     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:  
Line 291: Line 293:  
     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:  
Line 301: Line 303:  
     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:  
Line 311: Line 313:  
     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}")
Line 321: Line 323:  
     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:  
Line 331: Line 333:  
     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")
Line 341: Line 343:  
     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")
Line 351: Line 353:  
     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,
Line 363: Line 365:  
     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:  
Line 376: Line 378:  
     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:  
Line 388: Line 390:  
     pass
 
     pass
   −
* Used by:  
+
* Used by: activities when stopping
   −
* Present:  
+
* Present: closes the text channel, updates the buddies in the activity.
    
* Future:  
 
* Future:  
Line 398: Line 400:  
     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:  
Line 408: Line 410:  
     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:  
Line 418: Line 420:  
     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:  
Line 428: Line 430:  
     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:  
Line 438: Line 440:  
     pass
 
     pass
   −
* Used by:  
+
* Used by: not used
   −
* Present:  
+
* Present: returns cached property
   −
* Future:
+
* Future: drop?
647

edits

Navigation menu