Package sfs3.client.requests.mmo

Class SetUserPositionRequest

java.lang.Object

sfs3.client.requests.BaseRequest

sfs3.client.requests.mmo.SetUserPositionRequest

All Implemented Interfaces:

sfs3.client.requests.IClientRequest

public class SetUserPositionRequest
extends BaseRequest

Updates the User position inside an MMORoom.

MMORooms represent virtual environments and can host any number of users. Based on their position, the system allows users within a certain range from each other (Area of Interest, or AoI) to interact. This request allows the current user to update his position inside the MMORoom, which in turn will trigger a SFSEvent.PROXIMITY_LIST_UPDATE event for all users that fall within his AoI.

See Also:

• SFSEvent.PROXIMITY_LIST_UPDATE
• MMORoom
• Vec3D

Field Summary

Fields

Modifier and Type	Field	Description
static final String	KEY_MINUS_ITEM_LIST	API internal usage only
static final String	KEY_MINUS_USER_LIST	API internal usage only
static final String	KEY_PLUS_ITEM_LIST	API internal usage only
static final String	KEY_PLUS_USER_LIST	API internal usage only
static final String	KEY_ROOM	API internal usage only
static final String	KEY_VEC3D	API internal usage only

Fields inherited from class sfs3.client.requests.BaseRequest

AddBuddy, AdminMessage, AutoJoin, BanUser, BanUsersFromRoom, BlockBuddy, CallExtension, ChangeRoomCapacity, ChangeRoomName, ChangeRoomPassword, ClusterInviteUsers, ClusterJoinOrCreate, CreateRoom, CreateSFSGame, FindRooms, FindUsers, GameServerConnectionRequired, GenericMessage, GetRoomList, GoOnline, Handshake, InitBuddyList, InvitationReply, InviteUser, JoinRoom, JoinRoomInvite, KEY_ERROR_CODE, KEY_ERROR_PARAMS, KickUser, LeaveRoom, Login, Logout, ManualDisconnection, ModeratorMessage, ObjectMessage, PingPong, PlayerToSpectator, PrivateMessage, PublicMessage, QuickJoinGame, QuickJoinOrCreateRoom, RemoveBuddy, SetBuddyVariables, SetRoomVariables, SetUserPosition, SetUserVariables, sfso, SpectatorToPlayer, SubscribeRoomGroup, targetController, UdpInit, UnsubscribeRoomGroup

Constructor Summary

Constructors

Constructor	Description
SetUserPositionRequest(Vec3D position, Room room)	Creates a new SetUserPositionRequest instance.

Method Summary

Modifier and Type	Method	Description
void	execute(ISmartFox sfs)
void	validate(ISmartFox sfs)

Methods inherited from class sfs3.client.requests.BaseRequest

getId, getRequest, getTargetController, getTransportType, setId, setTargetController, setTransportType

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

KEY_ROOM

public static final String KEY_ROOM

API internal usage only

See Also:

• Constant Field Values

KEY_VEC3D

public static final String KEY_VEC3D

API internal usage only

See Also:

• Constant Field Values

KEY_PLUS_USER_LIST

public static final String KEY_PLUS_USER_LIST

API internal usage only

See Also:

• Constant Field Values

KEY_MINUS_USER_LIST

public static final String KEY_MINUS_USER_LIST

API internal usage only

See Also:

• Constant Field Values

KEY_PLUS_ITEM_LIST

public static final String KEY_PLUS_ITEM_LIST

API internal usage only

See Also:

• Constant Field Values

KEY_MINUS_ITEM_LIST

public static final String KEY_MINUS_ITEM_LIST

API internal usage only

See Also:

• Constant Field Values

Constructor Details

SetUserPositionRequest

public SetUserPositionRequest(Vec3D position,
 Room room)

Creates a new SetUserPositionRequest instance. The instance must be passed to the SmartFox.send() method for the request to be performed.

Parameters:

position - The user position.

room - The MMORoom object corresponding to the Room where the position should be set; if null, the last Room joined by the user is used.

See Also:

• SmartFox.send(sfs3.client.requests.IRequest)
• MMORoom
• Vec3D

Method Details

validate

public void validate(ISmartFox sfs)
              throws SFSValidationException

Throws:

SFSValidationException

execute

public void execute(ISmartFox sfs)
             throws SFSException

Throws:

SFSException