Difference between revisions of "ImprovedInstantMessage"

From Second Life Wiki
Jump to navigation Jump to search
Line 28: Line 28:
</pre>
</pre>
==Usage and Notes==
==Usage and Notes==
the interpretation and/or existence of values in  each parameter in the packet is controlled by the value in the Dialog parameter. The current range is 0-42 and he various permutations are listed in the table below (a work in progress):


{| border="1"
{| border="1"
Line 33: Line 37:
! Dialog byte value !! ToAgentID  !! ParentEstateID !! RegionID  !! Position  !! ID!! Timestamp!! FromAgentName!! Message!! BinaryBucket
! Dialog byte value !! ToAgentID  !! ParentEstateID !! RegionID  !! Position  !! ID!! Timestamp!! FromAgentName!! Message!! BinaryBucket
|-
|-
! 0 Indicates a regular IM from another agent ||as expected ||as expected ||as expected ||as expected ||style="background:silver" |meaningless ||as expected ||as expected ||as expected ||style="background:silver" |empty  
! 0 Indicates a regular IM from another agent  
|as expected ||as expected ||as expected ||as expected ||style="background:silver" |meaningless ||as expected ||as expected ||as expected ||style="background:silver" |empty  
|-
|-
! 1 Simple notification box with an OK button ||as expected ||as expected ||as expected ||as expected ||
! 1 Simple notification box with an OK button ||as expected ||as expected ||as expected ||as expected ||||||||||
|- style="background:silver"
|- style="background:silver"
! 2 Used to show a countdown notification with an OK button, deprecated now ||||||||||||||||||
! 2 Used to show a countdown notification with an OK button, deprecated now ||||||||||||||||||
Line 42: Line 47:
| NULL-terminated string. "O" for officer, "M" for member, followed by cost to join
| NULL-terminated string. "O" for officer, "M" for member, followed by cost to join
|-
|-
! 4 Inventory offer
! 4 Inventory offer||||||||
| a
| Transaction ID||||||||a list of inventory uuid and type
|-
|-
! 5 Accepted inventory offer
! 5 Accepted inventory offer||||||||||||||||
| a
|  
|-
|-
! 6 Declined inventory offer
! 6 Declined inventory offer||||||||||||||||
| a
|  
|-
|-
! 7 Group vote
! 7 Group vote||||||||||||||||
| a
|  
|-style="background:silver"
|-style="background:silver"
! 8 A message to everyone in the agent's group, deprecated||||||||||||||||||
! 8 A message to everyone in the agent's group, deprecated||||||||||||||||||
|-
|-
! 9 An object is offering its inventory
! 9 An object is offering its inventory||||||||||||||||
| a
|  
|-
|-
! 10 Accept an inventory offer from an object
! 10 Accept an inventory offer from an object||||||||||||||||
| a
|  
|-
|-
! 11 Decline an inventory offer from an object
! 11 Decline an inventory offer from an object||||||||||||||||
| a
|  
|-
|-
! 12 Unknown
! 12 Unknown||||||||||||||||
| a
|  
|-
|-
! 13 Start a session, or add users to a session
! 13 Start a session, or add users to a session||||||||||||||||
| a
|  
|-
|-
! 14 Start a session, but don't prune offline users
! 14 Start a session, but don't prune offline users||||||||||||||||
| a
|  
|-
|-
! 15 Start a session with your group
! 15 Start a session with your group||||||||||||||||
| a
|  
|-
|-
! 16 Start a session without a calling card (finder or objects)
! 16 Start a session without a calling card (finder or objects)||||||||||||||||
| a
|  
|-
|-
! 17 Send a message to a session
! 17 Send a message to a session||||||||||||||||
| a
|  
|-
|-
! 18 Leave a session
! 18 Leave a session||||||||||||||||
| a
|  
|-
|-
! 19 Indicates that the IM is from an object
! 19 Indicates that the IM is from an object||||||||||||||||
| a
|  
|-
|-
! 20 Sent an IM to a busy user, this is the auto response
! 20 Sent an IM to a busy user, this is the auto response||||||||||||||||
| a
|  
|-
|-
! 21 Shows the message in the console and chat history
! 21 Shows the message in the console and chat history||||||||||||||||
| a
|  
|-
|-
! 22 Send a teleport lure
! 22 Send a teleport lure||||||||||||||||
| a
|  
|-
|-
! 23 Response sent to the agent which inititiated a teleport invitation
! 23 Response sent to the agent which inititiated a teleport invitation||||||||||||||||
| a
|  
|-
|-
! 24 Response sent to the agent which inititiated a teleport invitation
! 24 Response sent to the agent which inititiated a teleport invitation||||||||||||||||
| a
|  
|-
|-
! 25 Only useful if you have Linden permissions
! 25 Only useful if you have Linden permissions||||||||||||||||
| a
|  
|-style="background:silver"
|-style="background:silver"
! 26 A placeholder type for future expansion, currently not used||||||||||||||||||
! 26 A placeholder type for future expansion, currently not used||||||||||||||||
|
|-style="background:silver"
|-style="background:silver"
! 27 Notification of a new group election, this is deprecated||||||||||||||||||
! 27 Notification of a new group election, this is deprecated||||||||||||||||||
|-
|-
! 28 IM to tell the user to go to an URL
! 28 IM to tell the user to go to an URL||||||||||||||||
| a
|  
|-
|-
! 29 IM for help
! 29 IM for help||||||||||||||||
| a
|  
|-
|-
! 30 IM sent automatically on call for help, sends a lure to each Helper reached
! 30 IM sent automatically on call for help, sends a lure to each Helper reached||||||||||||||||
| a
|  
|-
|-
! 31 Like an IM but won't go to email
! 31 Like an IM but won't go to email||||||||||||||||
| a
|  
|-
|-
! 32 IM from a group officer to all group members
! 32 IM from a group officer to all group members||||||||||||||||
| a
|  
|-
|-
! 33 Unknown
! 33 Unknown||||||||||||||||
| a
|  
|-
|-
! 34 Unknown
! 34 Unknown||||||||||||||||
| a
|  
|-
|-
! 35 Accept a group invitation
! 35 Accept a group invitation||||||||||||||||
| a
|  
|-
|-
! 36 Decline a group invitation
! 36 Decline a group invitation||||||||||||||||
| a
|  
|-
|-
! 37 Unknown
! 37 Unknown||||||||||||||||
| a
|  
|-
|-
! 38 An avatar is offering you friendship
! 38 An avatar is offering you friendship||||||||||||||||
| a
|  
|-
|-
! 39 An avatar has accepted your friendship offer
! 39 An avatar has accepted your friendship offer||||||||||||||||
| a
|  
|-
|-
! 40 An avatar has declined your friendship offer
! 40 An avatar has declined your friendship offer||||||||||||||||
| a
|  
|-
|-
! 41 Indicates that a user has started typing
! 41 Indicates that a user has started typing||||||||||||||||
| a
|  
|-
|-
! 42 Indicates that a user has stopped typing
! 42 Indicates that a user has stopped typing||||||||||||||||
| a
|  
|-
|-
|}
|}


[[Category:Messages]]
[[Category:Messages]]

Revision as of 14:33, 28 December 2007

Message Layout

{
	ImprovedInstantMessage Low NotTrusted Zerocoded
	{
		AgentData 		Single
		{   AgentID     LLUUID  }
		{	SessionID	LLUUID	}
	}
	{
		MessageBlock		Single
		{	FromGroup		BOOL	}
		{	ToAgentID		LLUUID	}
		{	ParentEstateID	U32	}
		{   RegionID		LLUUID	}
		{	Position		LLVector3	}
		{	Offline			U8	}
		{	Dialog			U8	}	
		{	ID				LLUUID	}
		{	Timestamp		U32	}
		{	FromAgentName	Variable	1	}
		{	Message			Variable	2	}
		{	BinaryBucket	Variable	2	}
	}
}

Usage and Notes

the interpretation and/or existence of values in each parameter in the packet is controlled by the value in the Dialog parameter. The current range is 0-42 and he various permutations are listed in the table below (a work in progress):


All possible interactions of Dialog byte and other packet variables
Dialog byte value ToAgentID ParentEstateID RegionID Position ID Timestamp FromAgentName Message BinaryBucket
0 Indicates a regular IM from another agent as expected as expected as expected as expected meaningless as expected as expected as expected empty
1 Simple notification box with an OK button as expected as expected as expected as expected
2 Used to show a countdown notification with an OK button, deprecated now
3 You've been invited to join a group NULL-terminated string. "O" for officer, "M" for member, followed by cost to join
4 Inventory offer Transaction ID a list of inventory uuid and type
5 Accepted inventory offer
6 Declined inventory offer
7 Group vote
8 A message to everyone in the agent's group, deprecated
9 An object is offering its inventory
10 Accept an inventory offer from an object
11 Decline an inventory offer from an object
12 Unknown
13 Start a session, or add users to a session
14 Start a session, but don't prune offline users
15 Start a session with your group
16 Start a session without a calling card (finder or objects)
17 Send a message to a session
18 Leave a session
19 Indicates that the IM is from an object
20 Sent an IM to a busy user, this is the auto response
21 Shows the message in the console and chat history
22 Send a teleport lure
23 Response sent to the agent which inititiated a teleport invitation
24 Response sent to the agent which inititiated a teleport invitation
25 Only useful if you have Linden permissions
26 A placeholder type for future expansion, currently not used
27 Notification of a new group election, this is deprecated
28 IM to tell the user to go to an URL
29 IM for help
30 IM sent automatically on call for help, sends a lure to each Helper reached
31 Like an IM but won't go to email
32 IM from a group officer to all group members
33 Unknown
34 Unknown
35 Accept a group invitation
36 Decline a group invitation
37 Unknown
38 An avatar is offering you friendship
39 An avatar has accepted your friendship offer
40 An avatar has declined your friendship offer
41 Indicates that a user has started typing
42 Indicates that a user has stopped typing