Constructor
new MMORoomSettings(name, defaultAOI)
Pass the instance to the CreateRoomRequest class constructor.
| Name | Type | Description |
|---|---|---|
name | string | The name of the MMORoom to be created. |
defaultAOI | Vec3D | The Area of Interest (AoI) for the MMORoom to be created. |
Extends
Members
allowOwnerOnlyInvitation :boolean
- boolean
- Default Value
- true
defaultAOI :Vec3D
This value represents the area/range around the User that is affected by server events and events generated by other Users. It is represented by a Vec3D object providing 2D or 3D coordinates.
For example, a Vec3D(50,50) describes a range of 50 units (e.g. pixels) in all four directions (top, bottom, left, right) with respect to the User position in a 2D coordinates system. A Vec3D(120,120,60). instead describes a range of 120 units in all four directions (top, bottom, left, right) and 60 units along the two Z-axis directions (backward, forward) with respect to the User position in a 3D coordinates system.
events :RoomEvents
Room events include: Users entering or leaving the Room, User count change and User Variables update. If set to null, the events configured on the server side are enabled (see the SmartFoxServer Administration Tool documentation).
- Overrides
- Default Value
- null
extension :RoomExtension
- Overrides
- Default Value
- null
groupId :string
If the Group doesn't exist yet, a new one is created before assigning the Room to it.
- string
- Overrides
- Default Value
- "default"
isGame :boolean
- boolean
- Overrides
- Default Value
- false
mapLimits :MapLimits
When specified, this property must contain two non-null Vec3D objects representing the minimum and maximum limits of the 2D/3D coordinates systems represented by the MMORoom. Any positional value that falls outside the provided limit is refused by the server.
This setting is optional but its usage is highly recommended.
- Default Value
- null
- See
maxSpectators :number
- number
- Overrides
- Default Value
- 0
maxUsers :number
In case of Game Rooms, this represents the maximum number of Players.
- number
- Overrides
- Default Value
- 10
maxVariables :number
- number
- Overrides
- Default Value
- 5
name :string
- string
- Overrides
password :string
If the password is set to an empty string, the Room won't be password protected.
- string
- Overrides
- Default Value
- (empty string)
permissions :RoomPermissions
Permissions include: name and password change, maximum Users change and public messaging. If set to null, the permissions configured on the server side are used (see the SmartFoxServer Administration Tool documentation).
- Overrides
- Default Value
- null
proximityListUpdateMillis :number
In an MMORoom, the regular User List is replaced by a Proximity List, which keeps an updated view of the Users currently within the Area of Interest of the client. The frequency at which these updates are fired by the server is regulated by this parameter, which sets the minimum time between two subsequent updates.
Note that values below the default one may be unnecessary for most applications, unless they are in realtime.
- number
- Default Value
- 250
sendAOIEntryPoint :boolean
If this setting is set to true, when a User enters the AoI of another User, the server sends the coordinates where the former "appeared" inside the AoI. This option should be turned off in case these coordinates are not needed, in order to save bandwidth.
- boolean
- Default Value
- true
userMaxLimboSeconds :number
As soon as the MMORoom is joined, the User still doesn't have a physical position set in the coordinates system of the Room, therefore it is considered in a "limbo" state. At this point the User is expected to set its position (via the SetUserPositionRequest) within the amount of time expressed by this value.
- number
- Default Value
- 50
variables :Array.<SFSRoomVariable>
- Array.<SFSRoomVariable>
- Overrides
- Default Value
- (empty array)