sugar3.presence.presenceservice module

STABLE.

class sugar3.presence.presenceservice.PresenceService

Bases: gi.overrides.GObject.Object

Provides simplified access to the Telepathy framework to activities

get(object_path)

get_activities()

get_activities_async(reply_handler=None, error_handler=None)

get_activity(activity_id, warn_if_none=True)

Retrieve single Activity object for the given unique id

activity_id – unique ID for the activity

returns single Activity object or None if the activity

is not found using GetActivityById on the service

get_activity_by_handle(connection_path, room_handle)

get_buddies()

get_buddies_async(reply_handler=None, error_handler=None)

get_buddy(account_path, contact_id)

get_buddy_by_telepathy_handle(tp_conn_name, tp_conn_path, handle)

Retrieve single Buddy object for the given public key

Parameters

tp_conn_namestr

The well-known bus name of a Telepathy connection

tp_conn_pathdbus.ObjectPath

The object path of the Telepathy connection

handleint or long

The handle of a Telepathy contact on that connection, of type HANDLE_TYPE_CONTACT. This may not be a channel-specific handle.

Returns

the Buddy object, or None if the buddy is not found

get_owner()

Retrieves the laptop Buddy object.

get_preferred_connection()

Gets the preferred telepathy connection object that an activity should use when talking directly to telepathy

returns the bus name and the object path of the Telepathy connection

share_activity(activity, properties=None, private=True)

sugar3.presence.presenceservice.get_instance(allow_offline_iface=False)

Retrieve this process’ view of the PresenceService