com.whirled.ActorControl

	Property	Defined by
		_env : String The environment in which we're running.	EntityControl

Public Methods

	Method		Defined by
		ActorControl(disp:DisplayObject) Creates a controller for a mobile.	ActorControl
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registers an event listener.	AbstractControl
		canManageRoom(memberId:int = 0):Boolean Returns true if the local client has management privileges in the current room.	EntityControl
		clearPopup():void Clear any showing popup.	EntityControl
		doBatch(fn:Function, ... args):void Execute the specified function as a batch of commands that will be sent to the server together.	AbstractControl
		getCamera(index:String = null):Camera Access the local user's camera.	EntityControl
		getDefaultDataPack():ByteArray Get the default datapack for this entity, or null if there is none defined.	EntityControl
		getEntityIds(type:String = null):Array Enumerates the ids of all entities in this room.	EntityControl
		getEntityProperty(key:String, entityId:String = null):Object Looks up and returns the specified property for the specified entity.	EntityControl
		getEnvironment():String Get the "environment" in which this entity is presently running.	EntityControl
		getInstanceId():int Get the id of the viewer that is viewing this instance.	EntityControl
		getLogicalLocation():Array Returns our current logical location in the scene.	EntityControl
		getMemories():Object Return an associative hash of all the memories.	EntityControl
		getMemory(key:String, defval:Object = null):Object Returns the value associated with the supplied key in this item's memory.	EntityControl
		getMicrophone(index:int = -1):Microphone Access the local user's microphone.	EntityControl
		getMusicId3():Object Get the id3 metadata of the currently playing music.	EntityControl
		getMusicOwnerId():int Get the playerId of the owner of the currently playing music, aka the player who added it to the playlist, or 0 if there is no music currently playing.	EntityControl
		getMyEntityId():String Returns the Whirled-wide unique ID of this copy of the entity.	EntityControl
		getOrientation():Number Returns the current orientation of this mobile.	ActorControl
		getPixelLocation():Array Returns our current location in the scene, in pixel coordinates.	EntityControl
		getRoomBounds():Array Get the room's bounds in pixels.	EntityControl
		getState():String Get the current state.	ActorControl
		getViewerName(id:int = 0):String Get the non-unique display name of the user viewing a particular instance.	EntityControl
		hasControl():Boolean Detects whether this client is in control.	EntityControl
		isConnected():Boolean Are we connected and running inside the whirled environment, or has someone just loaded up our SWF by itself?	AbstractControl
		isMoving():Boolean Returns whether the mobile is currently moving between locations in the scene.	ActorControl
		registerCustomConfig(func:Function):void Register a function used for generating a custom config panel.	EntityControl
		registerPropertyProvider(func:Function):void Registers a function that provides custom entity properties.	EntityControl
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Unregisters an event listener.	AbstractControl
		sendMessage(name:String, arg:Object = null):void Send a message to other instances of this entity, resulting in a MESSAGE_RECEIVED event.	EntityControl
		sendSignal(name:String, arg:Object = null):void Send a message to all instances of all entities in this instance's current room, resulting in a SIGNAL_RECEIVED event.	EntityControl
		setHotSpot(x:Number, y:Number, height:Number):void Set the layout "hotspot" for your item, specified as pixels relative to (0, 0) the top-left coordinate.	EntityControl
		setLogicalLocation(x:Number, y:Number, z:Number, orient:Number):void Requests that our location be updated.	ActorControl
		setMemory(key:String, value:Object, callback:Function = null):void Requests that this item's memory be updated with the supplied key/value pair.	EntityControl
		setMoveSpeed(pixelsPerSecond:Number):void Set this actor's movement speed, in pixels per second.	ActorControl
		setOrientation(orient:Number):void Requests that our orientation be updated.	ActorControl
		setPixelLocation(x:Number, y:Number, z:Number, orient:Number):void Requests that our location be updated.	ActorControl
		setState(state:String):void Set the state of this actor.	ActorControl
		setTickInterval(interval:Number):void Configures the interval on which this item is "ticked" in milliseconds.	EntityControl
		showPopup(title:String, panel:DisplayObject, width:Number, height:Number, backgroundColor:uint = 0xFFFFFF, backgroundAlpha:Number = 1.0):Boolean Show a popup to the current user in the whirled.	EntityControl
		triggerAction(name:String, arg:Object = null):void Triggers an action on this scene object.	EntityControl

Events

Hide Inherited Events

Show Inherited Events

	Summary	Defined by
actionTriggered	Dispatched when the instance in control sends a trigger action to all instances.	EntityControl
appearanceChanged	Dispatched as notification that the actor's appearance has changed.	ActorControl
chatReceived	Dispatched to entities when they overhear chatter in the room.	EntityControl
controlAcquired	Dispatched when this instance gains control.	EntityControl
entityEntered	Dispatched when an entity enters the room.	EntityControl
entityLeft	Dispatched when an entity leaves the room.	EntityControl
entityMoved	Dispatched when an entity in the room (other than the listening entity) changes location.	EntityControl
memoryChanged	Dispatched when the instance in control updates the memory of this digital item.	EntityControl
messageReceived	Dispatched when any instance sends a message to all instances.	EntityControl
musicId3	Dispatched when id3 data is found in the currently playing song.	EntityControl
musicStarted	Dispatched when music starts playing in the room.	EntityControl
musicStopped	Dispatched when music stops playing in the room.	EntityControl
signalReceived	Dispatched when any entity or AVR game sends a message to all other entities.	EntityControl
stateChanged	Dispatched as notification that the actor's state has changed.	ActorControl
timer	Dispatched once per tick, only when this instance has control and only if tick interval is registered.	EntityControl
unload	Event.UNLOAD Dispatched when the SWF using this control has been unloaded.	AbstractControl

Public Constants

Hide Inherited Public Constants

Show Inherited Public Constants

	Constant		Defined by
		ENV_ROOM : String = "room" [static] A constant returned by getEnvironment() to indicate that this entity is being viewed in a room.	EntityControl
		ENV_SHOP : String = "shop" [static] A constant returned by getEnvironment() to indicate that this entity is being viewed in the shop.	EntityControl
		ENV_VIEWER : String = "viewer" [static] A constant returned by getEnvironment() to indicate that this entity is being viewed in the "viewer": memories may be set and read, but they will not be saved.	EntityControl
		PROP_DIMENSIONS : String = "std:dimensions" [static] The entity pixel dimensions (an Array [width, height]).	EntityControl
		PROP_HOTSPOT : String = "std:hotspot" [static] The entity's hot spot (an Array [x, y]).	EntityControl
		PROP_LOCATION_LOGICAL : String = "std:location_logical" [static] The entity's location in logical coordinates (an Array [ x, y, z ]).	EntityControl
		PROP_LOCATION_PIXEL : String = "std:location_pixel" [static] The entity's location in pixel coordinates (an Array [ x, y, z ]).	EntityControl
		PROP_MEMBER_ID : String = "std:member_id" [static] The unique Whirled player ID (int) of the wearer of the avatar, or the owner of the pet.	EntityControl
		PROP_MOVE_SPEED : String = "std:move_speed" [static] The current movement speed of an actor (Number).	EntityControl
		PROP_NAME : String = "std:name" [static] The non-unique display name of the entity (a String).	EntityControl
		PROP_ORIENTATION : String = "std:orientation" [static] The entity facing direction (a Number).	EntityControl
		PROP_TYPE : String = "std:type" [static] The type of the entity, TYPE_AVATAR, TYPE_PET or TYPE_FURNI.	EntityControl
		TYPE_AVATAR : String = "avatar" [static] The type of avatar entities.	EntityControl
		TYPE_FURNI : String = "furni" [static] The type of furniture entities.	EntityControl
		TYPE_PET : String = "pet" [static] The type of pet entities.	EntityControl

Constructor detail

ActorControl

()

constructor

public function ActorControl(disp:DisplayObject)

Creates a controller for a mobile. The display object is the mobile's visualization.

Parameters

disp:DisplayObject

Method detail

getOrientation

()

method

public function getOrientation():Number

Returns the current orientation of this mobile.

Returns

Number — a value between 0 (facing straight ahead) moving counter-clockwise to 359.

getState

()

method

public function getState():String

Get the current state. If no state has been set or the control is not connected to whirled, null will be returned.

Returns

String

isMoving

()

method

public function isMoving():Boolean

Returns whether the mobile is currently moving between locations in the scene.

Returns

Boolean

setLogicalLocation

()

method

public function setLogicalLocation(x:Number, y:Number, z:Number, orient:Number):void

Requests that our location be updated. This will result in dispatch of the APPEARANCE_CHANGED event when the mobile starts moving and another when the mobile arrives at its destination and stops moving.

x, y, and z are Numbers between 0 and 1 indicating a percentage of the room's width, height and depth respectively. orient is a number between 0 (facing straight ahead) and 359, going counter-clockwise.

Parameters

	`x:Number`

	`y:Number`

	`z:Number`

	`orient:Number`

Whirled API Documentation	All Packages \| All Classes \| Index \| Frames No Frames
Class ActorControl	Properties \| Methods \| Events \| Constants

Package	com.whirled
Class	public class ActorControl
Inheritance	ActorControl EntityControl AbstractControl flash.events.EventDispatcher
Subclasses	AvatarControl, PetControl