[Telepathy] RFC: draft chat state interface specification

Luiz Augusto von Dentz luiz.dentz at gmail.com
Wed Jul 26 10:06:11 PDT 2006


So, does anyone take a look at this proposal?

Should I do a patch for it or there still missing point to be handle...

On 7/11/06, Luiz Augusto von Dentz <luiz.dentz at gmail.com> wrote:
>
>
>
> ---------- Forwarded message ----------
> From: Luiz Augusto von Dentz <luiz.dentz at gmail.com>
> Date: Jul 7, 2006 3:19 PM
> Subject: Re: [Telepathy] RFC: draft chat state interface specification
> To: Dafydd Harries <dafydd.harries at collabora.co.uk>
>
> Hi,
>
> This can lead to some confusions because the interface doesnt reflect that
> it is intent to send/receive notifications, but to set chat states that
> could be local.
> I suggest some modifications:
>
> On 7/7/06, Dafydd Harries < dafydd.harries at collabora.co.uk> wrote:
> >
> >
> > This dract is heavily based upon the relevant Jabber specification[0].
> >
> > class ChannelInterfaceChatState(dbus.service.Interface):
> >
>
> class ChannelInterfaceChatStateNotification( dbus.service.Interface ):
>
>     """
> >     An interface for channels for receiving notifications of remote
> > contacts'
> >     states, and for notifying remote contacts of the local state.
> >
> >     The following states are defined:
> >
> >      0 - CHAT_STATE_GONE
> >          The contact has effectively ceased participating in the chat.
> >      1 - CHAT_STATE_INACTIVE
> >          The contact has not been active for some time.
> >      2 - CHAT_STATE_ACTIVE
> >          The contact is actively participating in the chat.
> >      3 - CHAT_STATE_PAUSED
> >          The contact has paused composing a message.
> >      4 - CHAT_STATE_COMPOSING
> >          The contact is composing a message to be sent to the chat.
> >
> >     Clients should assume that a contact's state is CHAT_STATE_INACTIVE
> > unless
> >     they receive a notification otherwise.
> >
> >     The CHAT_STATE_GONE state is treated differently to other states:
> >
> >      - It is not used for multi-user chats;
> >      - It is implictly set when the channel is closed;
> >      - It may not be explicitly set.
> >     """
> >
> >     @dbus.service.method(CHANNEL_TYPE_TEXT, in_signature='u',
> > out_signature='')
> >     def SetState(self, state):
>
>
> def SendNotification(self, state) :
>
>         """
> >         Set the local state and notify other members of the channel that
> > it
> >         has changed.
> >
> >         Parameters:
> >         state - the new local state
> >         """
> >
> >     @dbus.service.signal(CHANNEL_TYPE_TEXT, signature='uu')
> >     def StateChanged(self, contact, state):
>
>
> def ReceivedNotification(self, contact, state):
>
>         """
> >         Emitted when somebody's state has changed. This includes local
> >         state.
> >
> >         Parameters:
> >         contact - the contact whose state has changed
> >         state - their new state
> >         """
> >
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.freedesktop.org/archives/telepathy/attachments/20060726/e349e427/attachment.html


More information about the Telepathy mailing list