AgentUpdate

From Second Life Wiki
Jump to navigation Jump to search

Message Layout

{
	AgentUpdate High 4 NotTrusted Zerocoded
	{
		AgentData			Single
		{	AgentID			LLUUID	}
		{	SessionID		LLUUID	}
		{	BodyRotation	LLQuaternion	}
		{	HeadRotation	LLQuaternion	}
		{	State			U8	}
		{	CameraCenter	LLVector3	}
		{	CameraAtAxis	LLVector3	}
		{	CameraLeftAxis	LLVector3	}
		{	CameraUpAxis	LLVector3	}
		{	Far				F32	}
		{	ControlFlags	U32	}
		{	Flags			U8	}
	}
}

Usage and Notes

Regularly sent to inform the simulator of the state of the viewer, such as where the camera is located, how far it can see, what controls are being pressed and the rotation of various parts of the body(torso and head.)

It is required that this message be sent on a regular basis for the simulator to provide/see updated info about the agent's position and velocity! Between receiving agent updates, the sim will continue simulating the agent physically (given the provided control flags) but won't be able to provide the updated position and velocity outside of the physics simulation. This is often seen when a client crashes during a motion.

Far is the distance the viewer can see in meters, it is combined with the viewers FOV to create an interest list on the simulator. Objects outside this distance are not sent to the viewer.

CameraCenter is the location of the camera in region local coordinates.

CameraAtAxis is the X rotational axis of the camera.(Forward)

CameraLeftAxis is the Y rotational axis of the camera.(Left)

CameraUpAxis is the Z rotational axis of the camera.(Up)

State values

Value Flag Comment
0x04 AGENT_STATE_TYPING The agent is currently playing the typing animation or typing is occurring.
0x10 AGENT_STATE_EDITING Agent has the tools window open and objects are selected.

Flags values

Value Flag Comment
0x00 AU_FLAGS_NONE No flags at all.
0x01 AU_FLAGS_HIDETITLE Used to hide group title in nametag. Hides title both locally and for everyone else.

Control Flags values

Value Flag Comment
AGENT_CONTROL_AT_POS 0x00000001
AGENT_CONTROL_AT_NEG 0x00000002
AGENT_CONTROL_LEFT_POS 0x00000004
AGENT_CONTROL_LEFT_NEG 0x00000008
AGENT_CONTROL_UP_POS 0x00000010
AGENT_CONTROL_UP_NEG 0x00000020
AGENT_CONTROL_PITCH_POS 0x00000040
AGENT_CONTROL_PITCH_NEG 0x00000080
AGENT_CONTROL_YAW_POS 0x00000100
AGENT_CONTROL_YAW_NEG 0x00000200
AGENT_CONTROL_FAST_AT 0x00000400
AGENT_CONTROL_FAST_LEFT 0x00000800
AGENT_CONTROL_FAST_UP 0x00001000
AGENT_CONTROL_FLY 0x00002000 Set while flying
AGENT_CONTROL_STOP 0x00004000 Soft freezes the avatar
AGENT_CONTROL_FINISH_ANIM 0x00008000
AGENT_CONTROL_STAND_UP 0x00010000 Only sent once to stand up
AGENT_CONTROL_SIT_ON_GROUND 0x00020000 Set while sitting on ground
AGENT_CONTROL_MOUSELOOK 0x00040000 Set while in mouse look
AGENT_CONTROL_NUDGE_AT_POS 0x00080000
AGENT_CONTROL_NUDGE_AT_NEG 0x00100000
AGENT_CONTROL_NUDGE_LEFT_POS 0x00200000
AGENT_CONTROL_NUDGE_LEFT_NEG 0x00400000
AGENT_CONTROL_NUDGE_UP_POS 0x00800000
AGENT_CONTROL_NUDGE_UP_NEG 0x01000000
AGENT_CONTROL_TURN_LEFT 0x02000000
AGENT_CONTROL_TURN_RIGHT 0x04000000
AGENT_CONTROL_AWAY 0x08000000 Set while away
AGENT_CONTROL_LBUTTON_DOWN 0x10000000
AGENT_CONTROL_LBUTTON_UP 0x20000000
AGENT_CONTROL_ML_LBUTTON_DOWN 0x40000000
AGENT_CONTROL_ML_LBUTTON_UP 0x80000000

Official Client Behavior

Sent UP TO 10 times per second.