PixelPAD 2D - multiplayer

init_multiplayer() -> None

示例
描述
Must be called in order to have a multiplayer project. Note that this does NOT connect you to a server, only initializes the other multiplayer functionality.
参数
None
No parameters.

返回值
No return value.

create_server(size: int) -> None

示例
描述
Creates a multiplayer server. If no one has joined the server within 5 seconds it will be deleted.
参数
size
The maximum number of players that can be connected to the server at any given time. Must be between 2 and 20 inclusive.

返回值
No return value. Because of delay the result of the function can be found with get_server_event(), where the event type will be "type": "server_created".

join_server(server_id: str) -> None

示例
描述
Attempts to connect to the server with the specified server id. If the user is already connected to a server they will be disconnected as you can only be connected to one server at a time.
参数
server_id
The ID of the server the user should attempt to join.

返回值
No return value. Because of delay the result of the function can be found with get_server_event(), where the event type will be "type": "self_joined".

inspect_server(server_id: str) -> None

示例
描述
Gets information about a specific server without joining it
参数
server_id
The ID of the server to get information about.

返回值
No return value. Because of delay the result of the function can be found with get_server_event(), where the event type will be "type": "server_info".

get_server_event() -> dict

示例
描述
Checks for asynchronous (delayed) responses from create_server(), join_server(), and inspect_server() on the current frame.
参数
None
No parameters.

返回值
A dictionary with the type of event that was received on the frame, or None if there is no event. If the event type is not None, the dict will also contain the boolean field "status", detailing whether the request was successful or not, as well as the field "message", containing a string with the event message, such as a server id from a "server_created" event.

send_message(data: str) -> None

示例
描述
Sends data to all other users connected to the same server.
参数
data
The string to send. Must be of length less than or equal to 256 characters.

返回值
No return value.

get_messages() -> list

示例
描述
Get all the messages that have been received from the current server since get_messages() was last called.
参数
None
No parameters.

返回值
A list of string messages that have been received, in order from oldest to most recently received. Returns an empty list if no messages have been received.

get_player_count() -> int

示例
描述
Checks how many people are in the currently connected server.
参数
None
No parameters.

返回值
The number of people connected to the current server, 0 if there is no connection.

leave_server() -> None

示例
描述
Disconnects the current user from any servers they are in.
参数
None
No parameters.

返回值
No return value.

get_servers() -> list

示例
描述
Gets a list of existing servers for the current project
参数
None
No parameters.

返回值
A list with all active server IDs for the same project, or an empty list if there are none.

Multiplayer and Servers

Multiplayer projects are projects you can play together with other people. Sometimes this is done by having multiple people use the same keyboard, but in can also be done over the internet, so people can use their own computers and play projects together even when they are in different places. Pixelpad allows you to create such projects by using servers.

A server is a computer designed to process and respond to requests from other computers, often known as clients. Servers are used for a huge variety of purposes, including this website, but they are also used for making multiplayer projects. Pixelpad has functions to create and join servers, to inspect and see all servers for a project, and to send and receive messages in the servers.