Reformat ChatProtocolMessages
This commit is contained in:
parent
9a75767faa
commit
41b6164bbc
|
@ -32,26 +32,26 @@ enum im_what_code {
|
|||
//! Request a server-side contact list from protocol →Protocol
|
||||
IM_GET_CONTACT_LIST = 1,
|
||||
|
||||
//! Server-side contact list received →App
|
||||
// Requires: Stringlist "user_id"
|
||||
/*! Server-side contact list received →App
|
||||
Requires: Stringlist "user_id" */
|
||||
IM_CONTACT_LIST = 2,
|
||||
|
||||
//! Add a contact to the roster →Protocol
|
||||
// The slots for this message are determined by the protocol's
|
||||
// "roster" template (ChatProtocol::SettingsTemplate("roster"))
|
||||
/*! Add a contact to the roster →Protocol
|
||||
The slots for this message are determined by the protocol's
|
||||
"roster" template (ChatProtocol::SettingsTemplate("roster")) */
|
||||
IM_CONTACT_LIST_ADD_CONTACT = 3,
|
||||
|
||||
//! Remove a contact →Protocol
|
||||
// Requires: String "user_id"
|
||||
/*! Remove a contact →Protocol
|
||||
Requires: String "user_id" */
|
||||
IM_CONTACT_LIST_REMOVE_CONTACT = 4,
|
||||
|
||||
//! Contact(s) removed from the server-side list →App
|
||||
// Requires: String "user_id"
|
||||
/*! Contact(s) removed from the server-side list →App
|
||||
Requires: String "user_id" */
|
||||
IM_CONTACT_LIST_CONTACT_REMOVED = 5,
|
||||
|
||||
//! Edit some data on contact →Protocol
|
||||
// The slots for this message are determined by the protocol's
|
||||
// "roster" template (ChatProtocol::SettingsTemplate("roster"))
|
||||
/*! Edit some data on contact →Protocol
|
||||
The slots for this message are determined by the protocol's
|
||||
"roster" template (ChatProtocol::SettingsTemplate("roster")) */
|
||||
IM_CONTACT_LIST_EDIT_CONTACT = 6,
|
||||
|
||||
|
||||
|
@ -59,32 +59,32 @@ enum im_what_code {
|
|||
* Messages related to text chat.
|
||||
*/
|
||||
|
||||
//! Send a chat message →Protocol
|
||||
// Requires: String "user_id", String "body"
|
||||
/*! Send a chat message →Protocol
|
||||
Requires: String "user_id", String "body" */
|
||||
IM_SEND_MESSAGE = 20,
|
||||
|
||||
//! Chat message has been sent →App
|
||||
// If no user_id is specified, it's treated as a system message
|
||||
// Requires: String "chat_id", String "body"
|
||||
// Allows: String "user_id"
|
||||
/*! Chat message has been sent →App
|
||||
If no user_id is specified, it's treated as a system message
|
||||
Requires: String "chat_id", String "body"
|
||||
Allows: String "user_id" */
|
||||
IM_MESSAGE_SENT = 21,
|
||||
|
||||
//! Chat message received →App
|
||||
// Requires: String "chat_id", String "user_id", String "body"
|
||||
/*! Chat message received →App
|
||||
Requires: String "chat_id", String "user_id", String "body" */
|
||||
IM_MESSAGE_RECEIVED = 22,
|
||||
|
||||
//! Logs received →App
|
||||
// Without "when" (a time_t), the logged message will lack a timestamp
|
||||
// Requires: Strings "chat_id", Strings "user_id", Strings "body"
|
||||
// Accepts: in64s "when"
|
||||
/*! Logs received →App
|
||||
Without "when" (a time_t), the logged message will lack a timestamp
|
||||
Requires: Strings "chat_id", Strings "user_id", Strings "body"
|
||||
Accepts: in64s "when" */
|
||||
IM_LOGS_RECEIVED = 23,
|
||||
|
||||
//! User started typing →App
|
||||
// Requires: String "chat_id", String "user_id"
|
||||
/*! User started typing →App
|
||||
Requires: String "chat_id", String "user_id" */
|
||||
IM_USER_STARTED_TYPING = 24,
|
||||
|
||||
//! User stopped typing →App
|
||||
// Requires: String "chat_id", String "user_id"
|
||||
/*! User stopped typing →App
|
||||
Requires: String "chat_id", String "user_id" */
|
||||
IM_USER_STOPPED_TYPING = 25,
|
||||
|
||||
|
||||
|
@ -103,29 +103,30 @@ enum im_what_code {
|
|||
* Messages related to contact's information received from protocols.
|
||||
*/
|
||||
|
||||
//! Received contact new status →App
|
||||
// Requires: String "user_id", int32/UserStatus "status"
|
||||
/*! Received contact new status →App
|
||||
Requires: String "user_id", int32/UserStatus "status" */
|
||||
IM_STATUS_SET = 60,
|
||||
|
||||
//! User's avatar icon was changed →App
|
||||
// Requires: String "user_id", Ref "ref"
|
||||
/*! User's avatar icon was changed →App
|
||||
Requires: String "user_id", Ref "ref" */
|
||||
IM_AVATAR_SET = 61,
|
||||
|
||||
//! Get contact information →Protocol
|
||||
IM_GET_CONTACT_INFO = 62,
|
||||
|
||||
//! Received contact information →App
|
||||
// Requires: String "user_id"
|
||||
// Accepts: String "user_name", String "message", int32/UserStatus "status"
|
||||
/*! Received contact information →App
|
||||
Requires: String "user_id"
|
||||
Accepts: String "user_name", String "message",
|
||||
int32/UserStatus "status" */
|
||||
IM_CONTACT_INFO = 63,
|
||||
|
||||
//! Request contact information →Protocol
|
||||
IM_GET_EXTENDED_CONTACT_INFO = 64,
|
||||
|
||||
//! Received contact information →App
|
||||
// Requires: String "user_id",
|
||||
// non-standard slots used by "roster" template
|
||||
// Accepts: String "user_name", String "full_name"
|
||||
/*! Received contact information →App
|
||||
Requires: String "user_id",
|
||||
non-standard slots used by "roster" template
|
||||
Accepts: String "user_name", String "full_name" */
|
||||
IM_EXTENDED_CONTACT_INFO = 65,
|
||||
|
||||
|
||||
|
@ -133,30 +134,33 @@ enum im_what_code {
|
|||
* Messages that involve changing own information.
|
||||
*/
|
||||
|
||||
//! Change own nickname →Protocol
|
||||
// Requires: String "user_name"
|
||||
/*! Change own nickname →Protocol
|
||||
Requires: String "user_name" */
|
||||
IM_SET_OWN_NICKNAME = 80,
|
||||
|
||||
//! Own nickname was changed →App
|
||||
IM_OWN_NICKNAME_SET = 81,
|
||||
|
||||
//! Change own status →Protocol
|
||||
// Requires: int32/UserStatus "status"
|
||||
/*! Change own status →Protocol
|
||||
Requires: int32/UserStatus "status" */
|
||||
IM_SET_OWN_STATUS = 82,
|
||||
|
||||
// Own status was changed →App
|
||||
// Requires: int32/UserStatus "status"
|
||||
/*! Own status was changed →App
|
||||
Requires: int32/UserStatus "status" */
|
||||
IM_OWN_STATUS_SET = 83,
|
||||
|
||||
//! Get own contact information
|
||||
// Requires: String "user_id"
|
||||
/*! Get own contact information →App
|
||||
Must be send right after connection is established,
|
||||
before any room events, etc.
|
||||
Requires: String "user_id"
|
||||
Allows: String "user_name" */
|
||||
IM_OWN_CONTACT_INFO = 84,
|
||||
|
||||
//! Change own avatar icon
|
||||
IM_SET_OWN_AVATAR = 85,
|
||||
|
||||
//! Own avatar icon was changed
|
||||
// Requires: Ref "ref"
|
||||
/*! Own avatar icon was changed
|
||||
Requires: Ref "ref" */
|
||||
IM_OWN_AVATAR_SET = 86,
|
||||
|
||||
|
||||
|
@ -195,7 +199,7 @@ enum im_what_code {
|
|||
* Miscellaneous.
|
||||
*/
|
||||
|
||||
//! Progress message received, could be login sequence, file transfer etc...
|
||||
//! Progress message received, could be login sequence, file transfer etc
|
||||
IM_PROGRESS = 140,
|
||||
|
||||
//! Notifications
|
||||
|
@ -206,89 +210,89 @@ enum im_what_code {
|
|||
* Room membership
|
||||
*/
|
||||
|
||||
//! Create an individual chat →Protocol
|
||||
// Individual chats and rooms are really the same thing (at least according
|
||||
// to App)― the only difference is in how they're created and joined.
|
||||
// A "chat" should be uniquely tied to a single user, and its chat_id
|
||||
// should be derivable from the user's ID (when sent back from
|
||||
// CHAT_CREATED). It doesn't matter how you get this done, really.
|
||||
// Requires: String "user_id"
|
||||
/*! Create an individual chat →Protocol
|
||||
Individual chats and rooms are really the same thing (at least according
|
||||
to App)― the only difference is in how they're created and joined.
|
||||
A "chat" should be uniquely tied to a single user, and its chat_id
|
||||
should be derivable from the user's ID (when sent back from
|
||||
CHAT_CREATED). It doesn't matter how you get this done, really.
|
||||
Requires: String "user_id" */
|
||||
IM_CREATE_CHAT = 150,
|
||||
|
||||
//! Chat has been created →App
|
||||
// Requires: String "chat_id", String "user_id"
|
||||
/*! Chat has been created →App
|
||||
Requires: String "chat_id", String "user_id" */
|
||||
IM_CHAT_CREATED = 151,
|
||||
|
||||
//! Create a room →Protocol
|
||||
// The required slots for this message are completely determined by the
|
||||
// protocol itself― the protocol will just receive data from the
|
||||
// "room" template (which is fetched via
|
||||
// ChatProtocol::SettingsTemplate("room")
|
||||
/*! Create a room →Protocol
|
||||
The required slots for this message are completely determined by the
|
||||
protocol itself― the protocol will just receive data from the
|
||||
"room" template (which is fetched via
|
||||
ChatProtocol::SettingsTemplate("room") */
|
||||
IM_CREATE_ROOM = 152,
|
||||
|
||||
//! Inform App room was created →App
|
||||
// Just a semantically-dressed IM_ROOM_JOINED
|
||||
// Requires: String "chat_id"
|
||||
/*! Inform App room was created →App
|
||||
Just a semantically-dressed IM_ROOM_JOINED
|
||||
Requires: String "chat_id" */
|
||||
IM_ROOM_CREATED = 153,
|
||||
|
||||
//! Join a room →Protocol
|
||||
// Requires: String "chat_id"
|
||||
/*! Join a room →Protocol
|
||||
Requires: String "chat_id" */
|
||||
IM_JOIN_ROOM = 154,
|
||||
|
||||
//! Confirm the room's been joined →App
|
||||
// Requires: String "chat_id"
|
||||
/*! Confirm the room's been joined →App
|
||||
Requires: String "chat_id" */
|
||||
IM_ROOM_JOINED = 155,
|
||||
|
||||
//! User wants to leave the room →Protocol
|
||||
// Requires: String "chat_id"
|
||||
/*! User wants to leave the room →Protocol
|
||||
Requires: String "chat_id" */
|
||||
IM_LEAVE_ROOM = 156,
|
||||
|
||||
//! User left the room →App
|
||||
// Requires: String "chat_id"
|
||||
/*! User left the room →App
|
||||
Requires: String "chat_id" */
|
||||
IM_ROOM_LEFT = 157,
|
||||
|
||||
//! Request a room's userlist →Protocol
|
||||
// Requires: String "chat_id"
|
||||
/*! Request a room's userlist →Protocol
|
||||
Requires: String "chat_id" */
|
||||
IM_GET_ROOM_PARTICIPANTS = 158,
|
||||
|
||||
//! Quietly add user(s) to the chat →App
|
||||
// Shouldn't be sent automatically on joining a room.
|
||||
// Requires: String "chat_id", StringList "user_id"
|
||||
// Accepts: StringList "user_name"
|
||||
/*! Quietly add user(s) to the chat →App
|
||||
Shouldn't be sent automatically on joining a room.
|
||||
Requires: String "chat_id", StringList "user_id"
|
||||
Accepts: StringList "user_name" */
|
||||
IM_ROOM_PARTICIPANTS = 159,
|
||||
|
||||
//! User has explicitly joined →App
|
||||
// Requires: String "chat_id", String "user_id"
|
||||
// Accepts: String "body"
|
||||
/*! User has explicitly joined →App
|
||||
Requires: String "chat_id", String "user_id"
|
||||
Accepts: String "body" */
|
||||
IM_ROOM_PARTICIPANT_JOINED = 160,
|
||||
|
||||
//! A user left the room →App
|
||||
// Requires: String "chat_id", String "user_id"
|
||||
// Accepts: String "user_name", String "body"
|
||||
/*! A user left the room →App
|
||||
Requires: String "chat_id", String "user_id"
|
||||
Accepts: String "user_name", String "body" */
|
||||
IM_ROOM_PARTICIPANT_LEFT = 161,
|
||||
|
||||
//! Invite a user to a room →Protocol
|
||||
// You can tell it succeded with IM_ROOM_PARTICIPANT_JOINED.
|
||||
// Requires: String "chat_id", String "user_id"
|
||||
// Accepts: String "body"
|
||||
/*! Invite a user to a room →Protocol
|
||||
You can tell it succeded with IM_ROOM_PARTICIPANT_JOINED.
|
||||
Requires: String "chat_id", String "user_id"
|
||||
Accepts: String "body" */
|
||||
IM_ROOM_SEND_INVITE = 162,
|
||||
|
||||
//! Invitee explicitly refused →App
|
||||
// Requires: String "chat_id", String "user_id"
|
||||
// Accepts: String "user_name", String "body"
|
||||
/*! Invitee explicitly refused →App
|
||||
Requires: String "chat_id", String "user_id"
|
||||
Accepts: String "user_name", String "body" */
|
||||
IM_ROOM_INVITE_REFUSED = 163,
|
||||
|
||||
//! User was invited to a room →App
|
||||
// Requires: String "chat_id"
|
||||
// Accepts: String "user_id", String "chat_name", String "body"
|
||||
/*! User was invited to a room →App
|
||||
Requires: String "chat_id"
|
||||
Accepts: String "user_id", String "chat_name", String "body" */
|
||||
IM_ROOM_INVITE_RECEIVED = 164,
|
||||
|
||||
//! User accepted an invite →Protocol
|
||||
// Requires: String "chat_id"
|
||||
/*! User accepted an invite →Protocol
|
||||
Requires: String "chat_id" */
|
||||
IM_ROOM_INVITE_ACCEPT = 165,
|
||||
|
||||
//! User denies an invite →Protocol
|
||||
// Requires: String "chat_id"
|
||||
/*! User denies an invite →Protocol
|
||||
Requires: String "chat_id" */
|
||||
IM_ROOM_INVITE_REFUSE = 166,
|
||||
|
||||
|
||||
|
@ -296,33 +300,33 @@ enum im_what_code {
|
|||
* Room metadata
|
||||
*/
|
||||
|
||||
//! Request a room's metadata →Protocol
|
||||
// Requires: String "chat_id"
|
||||
/*! Request a room's metadata →Protocol
|
||||
Requires: String "chat_id" */
|
||||
IM_GET_ROOM_METADATA = 170,
|
||||
|
||||
//! Receive room metadata →App
|
||||
// The idea is that all other metadata-related messages should only be
|
||||
// called either from a request, or from a change.
|
||||
// This shouldn't be sent automatically upon joining a room.
|
||||
// Requires: String "chat_id"
|
||||
// Allows: String "chat_name", String "subject",
|
||||
// int32 "room_default_flags", int32 "room_disallowed_flags"
|
||||
/*! Receive room metadata →App
|
||||
The idea is that all other metadata-related messages should only be
|
||||
called either from a request, or from a change.
|
||||
This shouldn't be sent automatically upon joining a room.
|
||||
Requires: String "chat_id"
|
||||
Allows: String "chat_name", String "subject",
|
||||
int32 "room_default_flags", int32 "room_disallowed_flags" */
|
||||
IM_ROOM_METADATA = 171,
|
||||
|
||||
//! Set the room name →Protocol
|
||||
// Requires: String "chat_id", String "chat_name"
|
||||
/*! Set the room name →Protocol
|
||||
Requires: String "chat_id", String "chat_name" */
|
||||
IM_SET_ROOM_NAME = 172,
|
||||
|
||||
//! Room name has changed →Protocol
|
||||
// Requires: String "chat_id", String "chat_name"
|
||||
/*! Room name has changed →Protocol
|
||||
Requires: String "chat_id", String "chat_name" */
|
||||
IM_ROOM_NAME_SET = 173,
|
||||
|
||||
//! Set the room subject →App
|
||||
// Requires: String "chat_id", String "subject"
|
||||
/*! Set the room subject →App
|
||||
Requires: String "chat_id", String "subject" */
|
||||
IM_SET_ROOM_SUBJECT = 174,
|
||||
|
||||
//! Subject has been changed →App
|
||||
// Requires: String "chat_id", String "subject"
|
||||
/*! Subject has been changed →App
|
||||
Requires: String "chat_id", String "subject" */
|
||||
IM_ROOM_SUBJECT_SET = 175,
|
||||
|
||||
|
||||
|
@ -330,49 +334,50 @@ enum im_what_code {
|
|||
* Room moderation
|
||||
*/
|
||||
|
||||
//! A user's role has been changed →App
|
||||
// Requires: String "role_title", int32 "role_perms", int32 "role_priority"
|
||||
/*! A user's role has been changed →App
|
||||
Requires: String "role_title", int32 "role_perms",
|
||||
int32 "role_priority" */
|
||||
IM_ROOM_ROLECHANGED = 190,
|
||||
|
||||
//! Kick user →Protocol
|
||||
// Requires: String "chat_id", String "user_id"
|
||||
/*! Kick user →Protocol
|
||||
Requires: String "chat_id", String "user_id" */
|
||||
IM_ROOM_KICK_PARTICIPANT = 191,
|
||||
|
||||
//! A user was kicked →App
|
||||
// Requires: String "chat_id", String "user_id"
|
||||
// Accepts: String "user_name", String "body"
|
||||
/*! A user was kicked →App
|
||||
Requires: String "chat_id", String "user_id"
|
||||
Accepts: String "user_name", String "body" */
|
||||
IM_ROOM_PARTICIPANT_KICKED = 192,
|
||||
|
||||
//! Ban user →Protocol
|
||||
// Requires: String "chat_id", String "user_id"
|
||||
/*! Ban user →Protocol
|
||||
Requires: String "chat_id", String "user_id" */
|
||||
IM_ROOM_BAN_PARTICIPANT = 193,
|
||||
|
||||
//! A user was banned →App
|
||||
// Requires: String "chat_id", String "user_id"
|
||||
// Accepts: String "user_name", String "body"
|
||||
/*! A user was banned →App
|
||||
Requires: String "chat_id", String "user_id"
|
||||
Accepts: String "user_name", String "body" */
|
||||
IM_ROOM_PARTICIPANT_BANNED = 194,
|
||||
|
||||
//! Unban user →Protocol
|
||||
/*! Unban user →Protocol */
|
||||
IM_ROOM_UNBAN_PARTICIPANT = 195,
|
||||
|
||||
//! Mute user →Protocol
|
||||
// The result of this can be seen with IM_ROOM_ROLECHANGED.
|
||||
// Requires: String "chat_id", String "user_id"
|
||||
/*! Mute user →Protocol
|
||||
The result of this can be seen with IM_ROOM_ROLECHANGED.
|
||||
Requires: String "chat_id", String "user_id" */
|
||||
IM_ROOM_MUTE_PARTICIPANT = 196,
|
||||
|
||||
//! Unmute user →Protocol
|
||||
// The result of this can be seen with IM_ROOM_ROLECHANGED.
|
||||
// Requires: String "chat_id", String "user_id"
|
||||
/*! Unmute user →Protocol
|
||||
The result of this can be seen with IM_ROOM_ROLECHANGED.
|
||||
Requires: String "chat_id", String "user_id" */
|
||||
IM_ROOM_UNMUTE_PARTICIPANT = 197,
|
||||
|
||||
//! Deafen →Protocol
|
||||
// The result of this can be seen with IM_ROOM_ROLECHANGED.
|
||||
// Requires: String "chat_id", String "user_id"
|
||||
/*! Deafen →Protocol
|
||||
The result of this can be seen with IM_ROOM_ROLECHANGED.
|
||||
Requires: String "chat_id", String "user_id" */
|
||||
IM_ROOM_DEAFEN_PARTICIPANT = 198,
|
||||
|
||||
//! Allow to read messages →Protocol
|
||||
// The result of this can be seen with IM_ROOM_ROLECHANGED.
|
||||
// Requires: String "chat_id", String "user_id"
|
||||
/*! Allow to read messages →Protocol
|
||||
The result of this can be seen with IM_ROOM_ROLECHANGED.
|
||||
Requires: String "chat_id", String "user_id" */
|
||||
IM_ROOM_UNDEAFEN_PARTICIPANT = 199,
|
||||
|
||||
|
||||
|
|
Ŝarĝante…
Reference in New Issue