AVRG FAQ - Revision history

Whirled vox: Text replacement - ">" to ">"

2018-09-05T21:23:21Z

Text replacement - ">" to ">"

← Older revision		Revision as of 21:23, 5 September 2018
Line 16:		Line 16:
	One exception to the rule is player properties, clients can set properties only for the local player like this:		One exception to the rule is player properties, clients can set properties only for the local player like this:

	<actionscript~~>~~		<actionscript>
	_control.player.props.set("Property", value);		_control.player.props.set("Property", value);
	</actionscript~~>~~		</actionscript>

	== How do I make a property persistent? ==		== How do I make a property persistent? ==
Line 24:		Line 24:
	You can use the [http://www.whirled.com/code/asdocs/com/whirled/net/NetConstants.html NetConstants.makePersistent] method to flag a property as persistent so that it will remain set even after the server agent has shut down and a new server agent has started.		You can use the [http://www.whirled.com/code/asdocs/com/whirled/net/NetConstants.html NetConstants.makePersistent] method to flag a property as persistent so that it will remain set even after the server agent has shut down and a new server agent has started.

	<actionscript~~>~~		<actionscript>
	var propName:String = NetConstants.makePersistent("someProperty");		var propName:String = NetConstants.makePersistent("someProperty");
	_control.getRoom(roomId).props.set(propName, {some:"Value"});		_control.getRoom(roomId).props.set(propName, {some:"Value"});
	</actionscript~~>~~		</actionscript>

	To retrieve a property persisted this way, use the persisted property name generated by makePersistent:		To retrieve a property persisted this way, use the persisted property name generated by makePersistent:

	<actionscript~~>~~		<actionscript>
	var propName:String = NetConstants.makePersistent("someProperty");		var propName:String = NetConstants.makePersistent("someProperty");
	something = _control.getRoom(roomId).props.get(propName);		something = _control.getRoom(roomId).props.get(propName);
	</actionscript~~>~~		</actionscript>

	== Message limits ==		== Message limits ==
Line 88:		Line 88:
	* Use doBatch. If you have several room operations and several game operations to perform at once, use the doBatch function to send all the room ones together and all the game ones together:		* Use doBatch. If you have several room operations and several game operations to perform at once, use the doBatch function to send all the room ones together and all the game ones together:

	<actionscript~~>~~		<actionscript>
	_control.doBatch(function () :void {		_control.doBatch(function () :void {
	doSomeRoomStuff();		doSomeRoomStuff();
	doSomeGameStuff();		doSomeGameStuff();
	})		})
	</actionscript~~>~~		</actionscript>

	=== What happens if I exceed the message limit? ===		=== What happens if I exceed the message limit? ===
Line 109:		Line 109:
	The encoded size of a persistent property can be no more than 4K. We mostly just use [http://livedocs.adobe.com/flex/3/langref/flash/net/ObjectEncoding.html#AMF3 AMF3 encoding] wrapped in a [http://code.threerings.net/svn/narya/trunk/src/as/com/threerings/io/ObjectInputStream.as com.threerings.io.ObjectOutputStream].		The encoded size of a persistent property can be no more than 4K. We mostly just use [http://livedocs.adobe.com/flex/3/langref/flash/net/ObjectEncoding.html#AMF3 AMF3 encoding] wrapped in a [http://code.threerings.net/svn/narya/trunk/src/as/com/threerings/io/ObjectInputStream.as com.threerings.io.ObjectOutputStream].

	Exception #1 to the use of AMF3 encoding: if the property is a <code~~>~~Dictionary</code~~>~~, we circumvent the AMF3 encoding and assume that the keys are integral. The size followed by a key/value pair for each entry is encoded using AMF3 (see [http://code.threerings.net/svn/whirled/trunk/libraries/whirled/src/as/com/whirled/game/data/GameMap.as GameMap]) prior to wrapping in <code~~>~~ObjectOutputStream</code~~>~~.		Exception #1 to the use of AMF3 encoding: if the property is a <code>Dictionary</code>, we circumvent the AMF3 encoding and assume that the keys are integral. The size followed by a key/value pair for each entry is encoded using AMF3 (see [http://code.threerings.net/svn/whirled/trunk/libraries/whirled/src/as/com/whirled/game/data/GameMap.as GameMap]) prior to wrapping in <code>ObjectOutputStream</code>.

	Exception #2 to the use of AMF3 encoding: if the property is an <code~~>~~Array</code~~>~~, we circumvent the AMF3 encoding and store instead an array of encoded values prior to wrapping in the <code~~>~~ObjectOutputStream</code~~>~~.		Exception #2 to the use of AMF3 encoding: if the property is an <code>Array</code>, we circumvent the AMF3 encoding and store instead an array of encoded values prior to wrapping in the <code>ObjectOutputStream</code>.

	The reason for these exceptions is to allow the implementation of setAt and setIn.		The reason for these exceptions is to allow the implementation of setAt and setIn.

	AMF3 introduces some overhead and ObjectOutputStream introduces a very small overhead (since the objects are already converted to assemblies of arrays of bytes by the time they are persisted, only 2 bytes of type information per object are stored). If you think you may be getting close to the limit, convert your property values to a <code~~>~~ByteArray</code~~>~~ before assigning them, or use multiple propeties.		AMF3 introduces some overhead and ObjectOutputStream introduces a very small overhead (since the objects are already converted to assemblies of arrays of bytes by the time they are persisted, only 2 bytes of type information per object are stored). If you think you may be getting close to the limit, convert your property values to a <code>ByteArray</code> before assigning them, or use multiple propeties.

	Transient properties have no encoded size limit at this time.		Transient properties have no encoded size limit at this time.
Line 126:		Line 126:

	'''RoomTrace.as'''		'''RoomTrace.as'''
	<actionscript~~>~~		<actionscript>
	package {		package {

Line 153:		Line 153:
	}		}
	}		}
	</actionscript~~>~~		</actionscript>

	Here's a server agent that will attach the trace object to any player that enters the game:		Here's a server agent that will attach the trace object to any player that enters the game:

	'''Server.as'''		'''Server.as'''
	<actionscript~~>~~		<actionscript>
	package {		package {

Line 181:		Line 181:
	}		}
	}		}
	</actionscript~~>~~		</actionscript>

	Here's a client top-level object that attaches the trace to the local player:		Here's a client top-level object that attaches the trace to the local player:

	'''Client.as'''		'''Client.as'''
	<actionscript~~>~~		<actionscript>
	package {		package {

Line 203:		Line 203:
	}		}
	}		}
	</actionscript~~>~~		</actionscript>

	See [http://www.whirled.com/code/asdocs/com/whirled/avrg/PlayerSubControlBase.html#event:enteredRoom enteredRoom] and [http://www.whirled.com/code/asdocs/com/whirled/avrg/PlayerSubControlBase.html#event:leftRoom leftRoom].		See [http://www.whirled.com/code/asdocs/com/whirled/avrg/PlayerSubControlBase.html#event:enteredRoom enteredRoom] and [http://www.whirled.com/code/asdocs/com/whirled/avrg/PlayerSubControlBase.html#event:leftRoom leftRoom].

Whirled vox: Text replacement - "<" to "<"

2018-09-04T11:27:31Z

Text replacement - "<" to "<"

← Older revision		Revision as of 11:27, 4 September 2018
Line 16:		Line 16:
	One exception to the rule is player properties, clients can set properties only for the local player like this:		One exception to the rule is player properties, clients can set properties only for the local player like this:

	~~<~~actionscript>		<actionscript>
	_control.player.props.set("Property", value);		_control.player.props.set("Property", value);
	~~<~~/actionscript>		</actionscript>

	== How do I make a property persistent? ==		== How do I make a property persistent? ==
Line 24:		Line 24:
	You can use the [http://www.whirled.com/code/asdocs/com/whirled/net/NetConstants.html NetConstants.makePersistent] method to flag a property as persistent so that it will remain set even after the server agent has shut down and a new server agent has started.		You can use the [http://www.whirled.com/code/asdocs/com/whirled/net/NetConstants.html NetConstants.makePersistent] method to flag a property as persistent so that it will remain set even after the server agent has shut down and a new server agent has started.

	~~<~~actionscript>		<actionscript>
	var propName:String = NetConstants.makePersistent("someProperty");		var propName:String = NetConstants.makePersistent("someProperty");
	_control.getRoom(roomId).props.set(propName, {some:"Value"});		_control.getRoom(roomId).props.set(propName, {some:"Value"});
	~~<~~/actionscript>		</actionscript>

	To retrieve a property persisted this way, use the persisted property name generated by makePersistent:		To retrieve a property persisted this way, use the persisted property name generated by makePersistent:

	~~<~~actionscript>		<actionscript>
	var propName:String = NetConstants.makePersistent("someProperty");		var propName:String = NetConstants.makePersistent("someProperty");
	something = _control.getRoom(roomId).props.get(propName);		something = _control.getRoom(roomId).props.get(propName);
	~~<~~/actionscript>		</actionscript>

	== Message limits ==		== Message limits ==
Line 88:		Line 88:
	* Use doBatch. If you have several room operations and several game operations to perform at once, use the doBatch function to send all the room ones together and all the game ones together:		* Use doBatch. If you have several room operations and several game operations to perform at once, use the doBatch function to send all the room ones together and all the game ones together:

	~~<~~actionscript>		<actionscript>
	_control.doBatch(function () :void {		_control.doBatch(function () :void {
	doSomeRoomStuff();		doSomeRoomStuff();
	doSomeGameStuff();		doSomeGameStuff();
	})		})
	~~<~~/actionscript>		</actionscript>

	=== What happens if I exceed the message limit? ===		=== What happens if I exceed the message limit? ===
Line 109:		Line 109:
	The encoded size of a persistent property can be no more than 4K. We mostly just use [http://livedocs.adobe.com/flex/3/langref/flash/net/ObjectEncoding.html#AMF3 AMF3 encoding] wrapped in a [http://code.threerings.net/svn/narya/trunk/src/as/com/threerings/io/ObjectInputStream.as com.threerings.io.ObjectOutputStream].		The encoded size of a persistent property can be no more than 4K. We mostly just use [http://livedocs.adobe.com/flex/3/langref/flash/net/ObjectEncoding.html#AMF3 AMF3 encoding] wrapped in a [http://code.threerings.net/svn/narya/trunk/src/as/com/threerings/io/ObjectInputStream.as com.threerings.io.ObjectOutputStream].

	Exception #1 to the use of AMF3 encoding: if the property is a ~~<~~code>Dictionary~~<~~/code>, we circumvent the AMF3 encoding and assume that the keys are integral. The size followed by a key/value pair for each entry is encoded using AMF3 (see [http://code.threerings.net/svn/whirled/trunk/libraries/whirled/src/as/com/whirled/game/data/GameMap.as GameMap]) prior to wrapping in ~~<~~code>ObjectOutputStream~~<~~/code>.		Exception #1 to the use of AMF3 encoding: if the property is a <code>Dictionary</code>, we circumvent the AMF3 encoding and assume that the keys are integral. The size followed by a key/value pair for each entry is encoded using AMF3 (see [http://code.threerings.net/svn/whirled/trunk/libraries/whirled/src/as/com/whirled/game/data/GameMap.as GameMap]) prior to wrapping in <code>ObjectOutputStream</code>.

	Exception #2 to the use of AMF3 encoding: if the property is an ~~<~~code>Array~~<~~/code>, we circumvent the AMF3 encoding and store instead an array of encoded values prior to wrapping in the ~~<~~code>ObjectOutputStream~~<~~/code>.		Exception #2 to the use of AMF3 encoding: if the property is an <code>Array</code>, we circumvent the AMF3 encoding and store instead an array of encoded values prior to wrapping in the <code>ObjectOutputStream</code>.

	The reason for these exceptions is to allow the implementation of setAt and setIn.		The reason for these exceptions is to allow the implementation of setAt and setIn.

	AMF3 introduces some overhead and ObjectOutputStream introduces a very small overhead (since the objects are already converted to assemblies of arrays of bytes by the time they are persisted, only 2 bytes of type information per object are stored). If you think you may be getting close to the limit, convert your property values to a ~~<~~code>ByteArray~~<~~/code> before assigning them, or use multiple propeties.		AMF3 introduces some overhead and ObjectOutputStream introduces a very small overhead (since the objects are already converted to assemblies of arrays of bytes by the time they are persisted, only 2 bytes of type information per object are stored). If you think you may be getting close to the limit, convert your property values to a <code>ByteArray</code> before assigning them, or use multiple propeties.

	Transient properties have no encoded size limit at this time.		Transient properties have no encoded size limit at this time.
Line 126:		Line 126:

	'''RoomTrace.as'''		'''RoomTrace.as'''
	~~<~~actionscript>		<actionscript>
	package {		package {

Line 153:		Line 153:
	}		}
	}		}
	~~<~~/actionscript>		</actionscript>

	Here's a server agent that will attach the trace object to any player that enters the game:		Here's a server agent that will attach the trace object to any player that enters the game:

	'''Server.as'''		'''Server.as'''
	~~<~~actionscript>		<actionscript>
	package {		package {

Line 181:		Line 181:
	}		}
	}		}
	~~<~~/actionscript>		</actionscript>

	Here's a client top-level object that attaches the trace to the local player:		Here's a client top-level object that attaches the trace to the local player:

	'''Client.as'''		'''Client.as'''
	~~<~~actionscript>		<actionscript>
	package {		package {

Line 203:		Line 203:
	}		}
	}		}
	~~<~~/actionscript>		</actionscript>

	See [http://www.whirled.com/code/asdocs/com/whirled/avrg/PlayerSubControlBase.html#event:enteredRoom enteredRoom] and [http://www.whirled.com/code/asdocs/com/whirled/avrg/PlayerSubControlBase.html#event:leftRoom leftRoom].		See [http://www.whirled.com/code/asdocs/com/whirled/avrg/PlayerSubControlBase.html#event:enteredRoom enteredRoom] and [http://www.whirled.com/code/asdocs/com/whirled/avrg/PlayerSubControlBase.html#event:leftRoom leftRoom].

Whirled vox: Text replacement - """ to """

2018-08-31T09:13:02Z

Text replacement - """ to """

← Older revision		Revision as of 09:13, 31 August 2018
Line 17:		Line 17:

	<actionscript>		<actionscript>
	_control.player.props.set(~~"~~Property~~"~~, value);		_control.player.props.set("Property", value);
	</actionscript>		</actionscript>

Line 25:		Line 25:

	<actionscript>		<actionscript>
	var propName:String = NetConstants.makePersistent(~~"~~someProperty~~"~~);		var propName:String = NetConstants.makePersistent("someProperty");
	_control.getRoom(roomId).props.set(propName, {some:~~"~~Value~~"~~});		_control.getRoom(roomId).props.set(propName, {some:"Value"});
	</actionscript>		</actionscript>

Line 32:		Line 32:

	<actionscript>		<actionscript>
	var propName:String = NetConstants.makePersistent(~~"~~someProperty~~"~~);		var propName:String = NetConstants.makePersistent("someProperty");
	something = _control.getRoom(roomId).props.get(propName);		something = _control.getRoom(roomId).props.get(propName);
	</actionscript>		</actionscript>
Line 42:		Line 42:
	For the server agent, there are separate message limits for each server that the agent is connected to and how many objects on that server are in use by the game. Here are the rules:		For the server agent, there are separate message limits for each server that the agent is connected to and how many objects on that server are in use by the game. Here are the rules:

	* ~~"~~Game messages~~"~~ are sent via the game server and the limit is 100 * (1 + log(N)) per 10 seconds, where N is the number of players. Here are some sample values of the limit for various numbers of players (that's total number):		* "Game messages" are sent via the game server and the limit is 100 * (1 + log(N)) per 10 seconds, where N is the number of players. Here are some sample values of the limit for various numbers of players (that's total number):
	{\|border=~~"~~1~~"~~ cellpadding=~~"~~3~~"~~ cellspacing=~~"~~0~~"~~		{\|border="1" cellpadding="3" cellspacing="0"
	\|-		\|-
	\|Players\|\|Messages/second		\|Players\|\|Messages/second
Line 66:		Line 66:
	The logarithmic limit is intended to encourage creators to not use per player messaging and properties very heavily, but instead use room-wide group communications where possible.		The logarithmic limit is intended to encourage creators to not use per player messaging and properties very heavily, but instead use room-wide group communications where possible.

	* ~~"~~Room messages~~"~~ are sent via the world server connection and the limit is 100 * N per 10 seconds, where N is the number rooms that are active on that server.		* "Room messages" are sent via the world server connection and the limit is 100 * N per 10 seconds, where N is the number rooms that are active on that server.

	Room message include all operations (not accessors) on [http://www.whirled.com/code/asdocs/com/whirled/avrg/RoomSubControlServer.html RoomSubControlServer] and the avatar operations on [http://www.whirled.com/code/asdocs/com/whirled/avrg/PlayerSubControlServer.html PlayerSubControlServer].		Room message include all operations (not accessors) on [http://www.whirled.com/code/asdocs/com/whirled/avrg/RoomSubControlServer.html RoomSubControlServer] and the avatar operations on [http://www.whirled.com/code/asdocs/com/whirled/avrg/PlayerSubControlServer.html PlayerSubControlServer].
Line 144:		Line 144:
	protected function entered (evt :AVRGamePlayerEvent) :void		protected function entered (evt :AVRGamePlayerEvent) :void
	{		{
	trace(~~"~~Player entered, evt=~~"~~ + evt);		trace("Player entered, evt=" + evt);
	}		}

	protected function left (evt :AVRGamePlayerEvent) :void		protected function left (evt :AVRGamePlayerEvent) :void
	{		{
	trace(~~"~~Player left, evt=~~"~~ + evt);		trace("Player left, evt=" + evt);
	}		}
	}		}

Dragawn: Created page with "{{FAQS}} {{TOCright}}These are some frequently asked questions about AVR games. == When does the server agent shut down? == The server agent shuts down under 2 condi..."

2018-08-25T16:42:56Z

Created page with "{{FAQS}} {{TOCright}}These are some frequently asked questions about AVR games. == When does the server agent shut down? == The server agent shuts down under 2 condi..."

New page

{{FAQS}}
{{TOCright}}These are some frequently asked questions about [[AVR game]]s.

== When does the server agent shut down? ==

The [[server agent]] shuts down under 2 conditions:

1. There have been no players playing the game for a certain duration. At the time of this writing, this duration is 5 minutes. So if the game is popular enough, it may never shut down.

2. When you relist the game in the catalog, the game server evicts all the players and restarts the agent. There are plans in place to allow the game code to do the eviction so that the player experience is more pleasant, but we don't know when that will be enabled.

== Why can't I set properties from the client? ==

AVRGs require a server agent in order to run. The restriction on properties is to encourage game authors to embed more of the game logic in the server agent code rather than in the clients.

One exception to the rule is player properties, clients can set properties only for the local player like this:

<actionscript>
_control.player.props.set("Property", value);
</actionscript>

== How do I make a property persistent? ==

You can use the [http://www.whirled.com/code/asdocs/com/whirled/net/NetConstants.html NetConstants.makePersistent] method to flag a property as persistent so that it will remain set even after the server agent has shut down and a new server agent has started.

<actionscript>
var propName:String = NetConstants.makePersistent("someProperty");
_control.getRoom(roomId).props.set(propName, {some:"Value"});
</actionscript>

To retrieve a property persisted this way, use the persisted property name generated by makePersistent:

<actionscript>
var propName:String = NetConstants.makePersistent("someProperty");
something = _control.getRoom(roomId).props.get(propName);
</actionscript>

== Message limits ==

=== What is the message limit for the server agent? ===

For the server agent, there are separate message limits for each server that the agent is connected to and how many objects on that server are in use by the game. Here are the rules:

* "Game messages" are sent via the game server and the limit is 100 * (1 + log(N)) per 10 seconds, where N is the number of players. Here are some sample values of the limit for various numbers of players (that's total number):
{|border="1" cellpadding="3" cellspacing="0"
|-
|Players||Messages/second
|-
|1||10
|-
|2||15
|-
|3||21
|-
|4||24
|-
|10||33
|-
|20||40
|-
|64||51
|}

Game messages include all operations (not accessors) on [http://www.whirled.com/code/asdocs/com/whirled/avrg/GameSubControlServer.html GameSubControlServer] and all operations and non-avatar methods (like deactivateGame and completeTask) on [http://www.whirled.com/code/asdocs/com/whirled/avrg/PlayerSubControlServer.html PlayerSubControlServer].

The logarithmic limit is intended to encourage creators to not use per player messaging and properties very heavily, but instead use room-wide group communications where possible.

* "Room messages" are sent via the world server connection and the limit is 100 * N per 10 seconds, where N is the number rooms that are active on that server.

Room message include all operations (not accessors) on [http://www.whirled.com/code/asdocs/com/whirled/avrg/RoomSubControlServer.html RoomSubControlServer] and the avatar operations on [http://www.whirled.com/code/asdocs/com/whirled/avrg/PlayerSubControlServer.html PlayerSubControlServer].

* There are plans to do some automatic batching for each kind of message and further batching within that for each target property space. This will be announced when it is ready in the SDK release notes.

=== What is the message limit for the game client? ===

The game client message limit is simpler than that for the server agent. The client can send up to 100 room messages and 100 game messages per 10 seconds.

On the client, only the [http://www.whirled.com/code/asdocs/com/whirled/avrg/PlayerSubControlClient.html PlayerSubControlClient] operations (not accessors) perform messaging. In here, the avatar operations contribute to the room total and the other operations contribute to the game total.

=== How can I avoid hitting the message limit? ===

The message limits that we set should be adequate for any game. The best thing you can do is design your messaging to be lean and mean. Here are a few rules of thumb:

* Never send a message from the agent in direct response to a player event. This is almost certain to go over the limit when a lot of players are all interacting rapidly with the game. Instead, batch the player actions and send updates at a fixed frequency, say 2 per second. This can be coupled with some client logic to estimate the game state between official server agent updates and increase smoothness.

* Avoid per-player private messaging except on rare occasions. For example, rewarding a player with a new item for passing a level may be ok if levels take a few minutes to finish. If you are implementing a minigame that can be played by one player, just have the client send the results of the game and/or periodic sanity checks to the server agent. Don't process every move on the server.

* Use doBatch. If you have several room operations and several game operations to perform at once, use the doBatch function to send all the room ones together and all the game ones together:

<actionscript>
_control.doBatch(function () :void {
doSomeRoomStuff();
doSomeGameStuff();
})
</actionscript>

=== What happens if I exceed the message limit? ===

If you exceed the message limit on the client, the connection to the server in question will be forcibly terminated. This will usually cause the user's game session to end.

If the game message limit is exceeded by the server agent, the server agent will shut down, causing all players' games to end.

If the world message limit is exceeded by the server agent, the server agent will no longer be able to access any room information and the behavior of the game will most likely become very erratic and unplayable.

This behavior will hopefully be made more sensible at some stage, but until then be sure not to exceed the message limits.

== What are the limits on properties (for players, rooms, and games, persistent and transient, maximum size)? ==

The encoded size of a persistent property can be no more than 4K. We mostly just use [http://livedocs.adobe.com/flex/3/langref/flash/net/ObjectEncoding.html#AMF3 AMF3 encoding] wrapped in a [http://code.threerings.net/svn/narya/trunk/src/as/com/threerings/io/ObjectInputStream.as com.threerings.io.ObjectOutputStream].

Exception #1 to the use of AMF3 encoding: if the property is a <code>Dictionary</code>, we circumvent the AMF3 encoding and assume that the keys are integral. The size followed by a key/value pair for each entry is encoded using AMF3 (see [http://code.threerings.net/svn/whirled/trunk/libraries/whirled/src/as/com/whirled/game/data/GameMap.as GameMap]) prior to wrapping in <code>ObjectOutputStream</code>.

Exception #2 to the use of AMF3 encoding: if the property is an <code>Array</code>, we circumvent the AMF3 encoding and store instead an array of encoded values prior to wrapping in the <code>ObjectOutputStream</code>.

The reason for these exceptions is to allow the implementation of setAt and setIn.

AMF3 introduces some overhead and ObjectOutputStream introduces a very small overhead (since the objects are already converted to assemblies of arrays of bytes by the time they are persisted, only 2 bytes of type information per object are stored). If you think you may be getting close to the limit, convert your property values to a <code>ByteArray</code> before assigning them, or use multiple propeties.

Transient properties have no encoded size limit at this time.

There is no limit at this time on the number of persistent or transient properties a game may store in a particular property space.

== How can I track players moving between rooms? ==

You can listen for a player entering and leaving the room separately. Here's a class that will just trace the enter/leave events to the output console:

'''RoomTrace.as'''
<actionscript>
package {

import com.whirled.avrg.PlayerSubControlBase;
import com.whirled.avrg.AVRGameControl;
import com.whirled.avrg.AVRServerGameControl;
import com.whirled.avrg.AVRGamePlayerEvent;

public class RoomTrace
{
public function RoomTrace (player :PlayerSubControlBase)
{
player.addEventListener(AVRGamePlayerEvent.ENTERED_ROOM, entered);
player.addEventListener(AVRGamePlayerEvent.LEFT_ROOM, left);
}

protected function entered (evt :AVRGamePlayerEvent) :void
{
trace("Player entered, evt=" + evt);
}

protected function left (evt :AVRGamePlayerEvent) :void
{
trace("Player left, evt=" + evt);
}
}
}
</actionscript>

Here's a server agent that will attach the trace object to any player that enters the game:

'''Server.as'''
<actionscript>
package {

import com.whirled.ServerObject;
import com.whirled.avrg.AVRServerGameControl;
import com.whirled.avrg.AVRGameControlEvent;

public class Server extends ServerObject
{
public function Server ()
{
_control = new AVRServerGameControl(this);
_control.game.addEventListener(AVRGameControlEvent.PLAYER_JOINED_GAME, joined);
}

protected function joined (evt :AVRGameControlEvent) :void
{
new RoomTrace(_control.getPlayer(evt.value as int));
}

protected var _control :AVRServerGameControl;
}
}
</actionscript>

Here's a client top-level object that attaches the trace to the local player:

'''Client.as'''
<actionscript>
package {

import flash.display.Sprite;
import com.whirled.avrg.AVRGameControl;

public class Client extends Sprite
{
public function Client ()
{
_control = new AVRGameControl(this);
new RoomTrace(_control.player);
}

protected var _control :AVRGameControl;
}
}
</actionscript>

See [http://www.whirled.com/code/asdocs/com/whirled/avrg/PlayerSubControlBase.html#event:enteredRoom enteredRoom] and [http://www.whirled.com/code/asdocs/com/whirled/avrg/PlayerSubControlBase.html#event:leftRoom leftRoom].

== How do I debug my AVRG? ==

You can use the [[How to use the AVRG probe|AVRG probe]].
[[Category:Game tutorials|*]]