Player.IO

Build fun, powerful & scalable online and mobile games with the reliable backend your users expect

Sign Up | Sign In

.NET Client Reference

Multiplayer class documentationClass Multiplayer

Namespace: PlayerIOClient
Language: C# / .NET

The Player.IO Multiplayer Service

.

Properties

 
public ServerEndpoint
DevelopmentServer

If not null, rooms will be created on the development server at the address defined by the server endpoint, instead of using the live Player.IO servers.

Methods

 
public Connection
CreateJoinRoom (string roomId, string roomType, bool visible, Dictionary<string, string> roomData, Dictionary<string, string> joinData)

Creates a multiplayer room (if it does not exist already) and joins it.
public void
CreateJoinRoom (string roomId, string roomType, bool visible, Dictionary<string, string> roomData, Dictionary<string, string> joinData, Callback<Connection> successCallback)

Creates a multiplayer room (if it does not exist already) and joins it.
public void
CreateJoinRoom (string roomId, string roomType, bool visible, Dictionary<string, string> roomData, Dictionary<string, string> joinData, Callback<Connection> successCallback, Callback<PlayerIOError> errorCallback)

Creates a multiplayer room (if it does not exist already) and joins it.
public string
CreateRoom (string roomId, string roomType, bool visible, Dictionary<string, string> roomData)

Create a multiplayer room on the Player.IO infrastructure
public void
CreateRoom (string roomId, string roomType, bool visible, Dictionary<string, string> roomData, Callback<string> successCallback)

Create a multiplayer room on the Player.IO infrastructure
public void
CreateRoom (string roomId, string roomType, bool visible, Dictionary<string, string> roomData, Callback<string> successCallback, Callback<PlayerIOError> errorCallback)

Create a multiplayer room on the Player.IO infrastructure
public Connection
JoinRoom (string roomId, Dictionary<string, string> joinData)

Join a running multiplayer room
public void
JoinRoom (string roomId, Dictionary<string, string> joinData, Callback<Connection> successCallback)

Create an multiplayer room on the Player.IO infrastructure
public void
JoinRoom (string roomId, Dictionary<string, string> joinData, Callback<Connection> successCallback, Callback<PlayerIOError> errorCallback)

Create an multiplayer room on the Player.IO infrastructure
public RoomInfo[]
ListRooms (string roomType, Dictionary<string, string> searchCriteria, int resultLimit, int resultOffset)

List the currently running multiplayer rooms
public void
ListRooms (string roomType, Dictionary<string, string> searchCriteria, int resultLimit, int resultOffset, Callback<RoomInfo[]> successCallback)

List the currently running multiplayer rooms
public void
ListRooms (string roomType, Dictionary<string, string> searchCriteria, int resultLimit, int resultOffset, Callback<RoomInfo[]> successCallback, Callback<PlayerIOError> errorCallback)

List the currently running multiplayer rooms

Multiplayer.DevelopmentServer

public ServerEndpoint
DevelopmentServer

If not null, rooms will be created on the development server at the address defined by the server endpoint, instead of using the live Player.IO servers.

Multiplayer.CreateJoinRoom

public Connection
CreateJoinRoom (string roomId, string roomType, bool visible, Dictionary<string, string> roomData, Dictionary<string, string> joinData)

Creates a multiplayer room (if it does not exist already) and joins it.

Arguments

string roomId
The id of the room you wish to create/join
string roomType
The name of the room type you wish to run the room as. This value should match one of the [RoomType(...)] attributes of your uploaded code. A room type of 'bounce' is always available.
bool visible
If the room doesn't exist: Should the room be visible when listing rooms with GetRooms upon creation
Dictionary<string, string> roomData
If the room doesn't exist: The data to initialize the room with upon creation
Dictionary<string, string> joinData
Data to send to the room with additional information about the join

Multiplayer.CreateJoinRoom

public void
CreateJoinRoom (string roomId, string roomType, bool visible, Dictionary<string, string> roomData, Dictionary<string, string> joinData, Callback<Connection> successCallback)

Creates a multiplayer room (if it does not exist already) and joins it.

Arguments

string roomId
The id of the room you wish to create/join
string roomType
The name of the room type you wish to run the room as. This value should match one of the [RoomType(...)] attributes of your uploaded code. A room type of 'bounce' is always available.
bool visible
If the room doesn't exist: Should the room be visible when listing rooms with GetRooms upon creation
Dictionary<string, string> roomData
If the room doesn't exist: The data to initialize the room with upon creation
Dictionary<string, string> joinData
Data to send to the room with additional information about the join
Callback<Connection> successCallback
Callback with a connection into the room that was created

Multiplayer.CreateJoinRoom

public void
CreateJoinRoom (string roomId, string roomType, bool visible, Dictionary<string, string> roomData, Dictionary<string, string> joinData, Callback<Connection> successCallback, Callback<PlayerIOError> errorCallback)

Creates a multiplayer room (if it does not exist already) and joins it.

Arguments

string roomId
The id of the room you wish to create/join
string roomType
The name of the room type you wish to run the room as. This value should match one of the [RoomType(...)] attributes of your uploaded code. A room type of 'bounce' is always available.
bool visible
If the room doesn't exist: Should the room be visible when listing rooms with GetRooms upon creation
Dictionary<string, string> roomData
If the room doesn't exist: The data to initialize the room with upon creation
Dictionary<string, string> joinData
Data to send to the room with additional information about the join
Callback<Connection> successCallback
Callback with a connection into the room that was created
Callback<PlayerIOError> errorCallback
Callback that will be called instead of successCallback if an error occurs

Multiplayer.CreateRoom

public string
CreateRoom (string roomId, string roomType, bool visible, Dictionary<string, string> roomData)

Create a multiplayer room on the Player.IO infrastructure

Arguments

string roomId
The id you wish to assign to your new room - You can use this to connect to the specific room later as long as it still exists
string roomType
The name of the room type you wish to run the room as. This value should match one of the [RoomType(...)] attributes of your uploaded code. A room type of 'bounce' is always available.
bool visible
Should the room be visible when listing rooms with GetRooms
Dictionary<string, string> roomData
The data to initialize the room with, this can be read with ListRooms and changed from the serverside

Multiplayer.CreateRoom

public void
CreateRoom (string roomId, string roomType, bool visible, Dictionary<string, string> roomData, Callback<string> successCallback)

Create a multiplayer room on the Player.IO infrastructure

Arguments

string roomId
The id you wish to assign to your new room - You can use this to connect to the specific room later as long as it still exists
string roomType
The name of the room type you wish to run the room as. This value should match one of the [RoomType(...)] attributes of your uploaded code. A room type of 'bounce' is always available.
bool visible
Should the room be visible when listing rooms with GetRooms
Dictionary<string, string> roomData
The data to initialize the room with, this can be read with ListRooms and changed from the serverside
Callback<string> successCallback
Callback with the id of the room that was created

Multiplayer.CreateRoom

public void
CreateRoom (string roomId, string roomType, bool visible, Dictionary<string, string> roomData, Callback<string> successCallback, Callback<PlayerIOError> errorCallback)

Create a multiplayer room on the Player.IO infrastructure

Arguments

string roomId
The id you wish to assign to your new room - You can use this to connect to the specific room later as long as it still exists
string roomType
The name of the room type you wish to run the room as. This value should match one of the [RoomType(...)] attributes of your uploaded code. A room type of 'bounce' is always available.
bool visible
Should the room be visible when listing rooms with GetRooms
Dictionary<string, string> roomData
The data to initialize the room with, this can be read with ListRooms and changed from the serverside
Callback<string> successCallback
Callback with the database object found, or null if no object was found
Callback<PlayerIOError> errorCallback
Callback that will be called instead of successCallback if an error occurs during the room creation.

Multiplayer.JoinRoom

public Connection
JoinRoom (string roomId, Dictionary<string, string> joinData)

Join a running multiplayer room

Arguments

string roomId
The id of the room you wish to connect to
Dictionary<string, string> joinData
Data to send to the room with additional information about the join

Multiplayer.JoinRoom

public void
JoinRoom (string roomId, Dictionary<string, string> joinData, Callback<Connection> successCallback)

Create an multiplayer room on the Player.IO infrastructure

Arguments

string roomId
The id of the room you wish to connect to
Dictionary<string, string> joinData
Data to send to the room with additional information about the join
Callback<Connection> successCallback
Callback with a connection into the room

Multiplayer.JoinRoom

public void
JoinRoom (string roomId, Dictionary<string, string> joinData, Callback<Connection> successCallback, Callback<PlayerIOError> errorCallback)

Create an multiplayer room on the Player.IO infrastructure

Arguments

string roomId
The id of the room you wish to connect to
Dictionary<string, string> joinData
Data to send to the room with additional information about the join
Callback<Connection> successCallback
Callback with a connection into the room
Callback<PlayerIOError> errorCallback
Callback that will be called instead of successCallback if an error occurs

Multiplayer.ListRooms

public RoomInfo[]
ListRooms (string roomType, Dictionary<string, string> searchCriteria, int resultLimit, int resultOffset)

List the currently running multiplayer rooms

Arguments

string roomType
The type of room you wish to list
Dictionary<string, string> searchCriteria
Only rooms with the same values in their roomdata will be returned
int resultLimit
The maximum amount of rooms you want to receive. Use 0 for 'as many as possible'.
int resultOffset
The offset into the list you wish

Multiplayer.ListRooms

public void
ListRooms (string roomType, Dictionary<string, string> searchCriteria, int resultLimit, int resultOffset, Callback<RoomInfo[]> successCallback)

List the currently running multiplayer rooms

Arguments

string roomType
The type of room you wish to list
Dictionary<string, string> searchCriteria
Only rooms with the same values in their roomdata will be returned
int resultLimit
The maximum amount of rooms you want to receive. Use 0 for 'as many as possible'.
int resultOffset
The offset into the list you wish
Callback<RoomInfo[]> successCallback
Callback with a list of rooms matching the search criteria

Multiplayer.ListRooms

public void
ListRooms (string roomType, Dictionary<string, string> searchCriteria, int resultLimit, int resultOffset, Callback<RoomInfo[]> successCallback, Callback<PlayerIOError> errorCallback)

List the currently running multiplayer rooms

Arguments

string roomType
The type of room you wish to list
Dictionary<string, string> searchCriteria
Only rooms with the same values in their roomdata will be returned
int resultLimit
The maximum amount of rooms you want to receive. Use 0 for 'as many as possible'.
int resultOffset
The offset into the list you wish
Callback<RoomInfo[]> successCallback
Callback with a list of rooms matching the search criteria
Callback<PlayerIOError> errorCallback
Callback that will be called instead of successCallback if an error occurs