<br><br>---------- Forwarded message ----------<br><span class="gmail_quote">From: <b class="gmail_sendername">Luiz Augusto von Dentz</b> <<a href="mailto:luiz.dentz@gmail.com">luiz.dentz@gmail.com</a>><br>Date: Jul 7, 2006 3:19 PM
<br>Subject: Re: [Telepathy] RFC: draft chat state interface specification<br>To: Dafydd Harries <<a href="mailto:dafydd.harries@collabora.co.uk">dafydd.harries@collabora.co.uk</a>><br><br></span><div>Hi,<br><br>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.
<br>I suggest some modifications:<br><br><div><span class="q"><span class="gmail_quote"> On 7/7/06, <b class="gmail_sendername">Dafydd Harries</b> <<a href="mailto:dafydd.harries@collabora.co.uk" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">
dafydd.harries@collabora.co.uk</a>> wrote: </span><blockquote class="gmail_quote" style="border-left-color: #cccccc; border-left-width: 1px; border-left-style: solid; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0.80ex; padding-left: 1ex">
<br>This dract is heavily based upon the relevant Jabber specification[0].<br><br>class ChannelInterfaceChatState(dbus.service.Interface):<br></blockquote></span></div><div><div><br>class ChannelInterfaceChatStateNotification(
dbus.service.Interface ): <br></div></div><div><span class="q"><br><blockquote class="gmail_quote" style="border-left-color: #cccccc; border-left-width: 1px; border-left-style: solid; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0.80ex; padding-left: 1ex">
"""<br> An interface for channels for receiving notifications of remote contacts' <br> states, and for notifying remote contacts of the local state.<br><br> The following states are defined:<br>
<br> 0 - CHAT_STATE_GONE<br> The contact has effectively ceased participating in the chat. <br> 1 - CHAT_STATE_INACTIVE<br> The contact has not been active for some time.<br> 2 - CHAT_STATE_ACTIVE
<br> The contact is actively participating in the chat.<br> 3 - CHAT_STATE_PAUSED<br> The contact has paused composing a message. <br> 4 - CHAT_STATE_COMPOSING<br> The contact is composing a message to be sent to the chat.
<br><br> Clients should assume that a contact's state is CHAT_STATE_INACTIVE unless<br> they receive a notification otherwise. <br><br> The CHAT_STATE_GONE state is treated differently to other states:<br><br> - It is not used for multi-user chats;
<br> - It is implictly set when the channel is closed;<br> - It may not be explicitly set. <br> """<br><br> @dbus.service.method(CHANNEL_TYPE_TEXT, in_signature='u', out_signature='')<br> def SetState(self, state):
</blockquote></span></div><div><div><br>def SendNotification(self, state) :<br></div></div><div><span class="q"><br><blockquote class="gmail_quote" style="border-left-color: #cccccc; border-left-width: 1px; border-left-style: solid; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0.80ex; padding-left: 1ex">
"""<br> Set the local state and notify other members of the channel that it <br> has changed.<br><br> Parameters:<br> state - the new local state<br> """
<br><br> @dbus.service.signal(CHANNEL_TYPE_TEXT, signature='uu')<br> def StateChanged(self, contact, state): </blockquote></span></div><div><div><br>def ReceivedNotification(self, contact, state):</div></div><div><span class="q">
<br><blockquote class="gmail_quote" style="border-left-color: #cccccc; border-left-width: 1px; border-left-style: solid; margin-top: 0pt; margin-right: 0pt; margin-bottom: 0pt; margin-left: 0.80ex; padding-left: 1ex"> """
<br> Emitted when somebody's state has changed. This includes local<br> state.<br><br> Parameters:<br> contact - the contact whose state has changed<br> state - their new state <br> """
<br></blockquote></span></div><br></div>