Methods
| SetChatState | (u: State) | → | nothing |
Signals
| ChatStateChanged | (u: Contact, u: State) |
Properties
| ChatStates | a{uu} (Chat_State_Map) | Read only |
Types
| Channel_Chat_State | Enum | u | |
| Chat_State_Map | Mapping | a{uu} |
Objects implementing this interface must also implement:
Description
An interface for channels for receiving notifications of remote contacts' state, and for notifying remote contacts of the local state.
Clients should assume that a contact's state is Channel_Chat_State_Inactive unless they receive a notification otherwise.
The Channel_Chat_State_Gone state is treated differently to other states:
- It may not be used for multi-user chats
- It may not be explicitly sent
- It should be automatically sent when the channel is closed
- It must not be sent to the peer if a channel is closed without being used
- Receiving it must not cause a new channel to be opened
The different states are defined by XEP-0085, but may be applied to any suitable protocol.
Methods
(Permalink)
SetChatState (u: State) → nothing
Parameters
- State — u (Channel_Chat_State)
The new state.
Set the local state and notify other members of the channel that it
has changed.
Possible Errors
- Network Error
- Not Available
- Invalid Argument
Raised when there is an error reading from or writing to the network.
Raised when the requested functionality is temporarily unavailable.
Raised when one of the provided arguments is invalid.
Signals
(Permalink)
ChatStateChanged (u: Contact, u: State)
Parameters
- Contact — u (Contact_Handle)
- State — u (Channel_Chat_State)
An integer handle for the contact.
The new state of this contact.
Emitted when the state of a member of the channel has changed.
This includes local state.
Properties
Accessed using the org.freedesktop.DBus.Properties
interface.
(Permalink)
ChatStates — a{uu} (Chat_State_Map)
Read only
Added in 0.19.7.
A map containing the chat states of all contacts in this channel whose chat state is not Inactive.
Contacts in this channel, but who are not listed in this map, may be assumed to be in the Inactive state.
Types
Enum (Permalink)
Channel_Chat_State — u
- Gone (0)
- Inactive (1)
- Active (2)
- Paused (3)
- Composing (4)
The contact has effectively ceased participating in the chat.
The contact has not been active for some time.
The contact is actively participating in the chat.
The contact has paused composing a message.
The contact is composing a message to be sent to the chat.
Mapping (Permalink)
Chat_State_Map — a{uu}
Added in 0.19.7.
A map from contacts to their chat states.
- Contact — u (Contact_Handle)
- State — u (Channel_Chat_State)
A contact
The contact's chat state