PixelPAD 2D - 多人游戏

init_multiplayer() -> None

示例
描述
要制作多人游戏项目，必须调用此函数。注意，这不会把你连接到服务器，只会初始化其他多人游戏功能。
参数
None
无参数。

返回值
无返回值。

create_server(size: int) -> None

示例
描述
创建一个多人游戏服务器。如果 5 秒内没有人加入，该服务器将被删除。
参数
size
同一时间可以连接到服务器的最大玩家数。必须在 2 到 20 之间（含）。

返回值
无返回值。由于存在延迟，该函数的结果可以通过 get_server_event() 获取，其事件类型为 "type": "server_created"。

join_server(server_id: str) -> None

示例
描述
尝试连接到指定服务器 id 的服务器。如果用户已经连接到某个服务器，将会先断开，因为同一时间只能连接一个服务器。
参数
server_id
用户要尝试加入的服务器 ID。

返回值
无返回值。由于存在延迟，该函数的结果可以通过 get_server_event() 获取，其事件类型为 "type": "self_joined"。

inspect_server(server_id: str) -> None

示例
描述
获取指定服务器的信息，而不加入该服务器
参数
server_id
要获取信息的服务器 ID。

返回值
无返回值。由于存在延迟，该函数的结果可以通过 get_server_event() 获取，其事件类型为 "type": "server_info"。

get_server_event() -> dict

示例
描述
检查当前帧中来自 create_server()、join_server() 和 inspect_server() 的异步（延迟）响应。
参数
None
无参数。

返回值
一个字典，包含当前帧收到的事件类型；如果没有事件则为 None。如果事件类型不为 None，字典还会包含布尔字段 "status"，表示请求是否成功，以及字段 "message"，包含事件消息字符串，例如 "server_created" 事件返回的服务器 id。

send_message(data: str) -> None

示例
描述
向连接到同一服务器的所有其他用户发送数据。
参数
data
要发送的字符串。长度必须不超过 256 个字符。

返回值
无返回值。

get_messages() -> list

示例
描述
获取自上次调用 get_messages() 以来从当前服务器收到的所有消息。
参数
None
无参数。

返回值
已收到的字符串消息列表，按从最早到最新的顺序排列。如果没有收到消息，则返回空列表。

get_player_count() -> int

示例
描述
检查当前连接的服务器中有多少人。
参数
None
无参数。

返回值
连接到当前服务器的人数，未连接时为 0。

leave_server() -> None

示例
描述
将当前用户从所在的任何服务器断开。
参数
None
无参数。

返回值
无返回值。

get_servers() -> list

示例
描述
获取当前项目现有服务器的列表
参数
None
无参数。

返回值
同一项目所有活动服务器 ID 的列表，如果没有则为空列表。

多人游戏与服务器

多人游戏项目是可以和其他人一起玩的项目。有时是让多个人共用同一个键盘，但也可以通过互联网进行，这样大家就可以在各自的电脑上一起玩，即使身处不同的地方。Pixelpad 让你可以使用服务器来创建这样的项目。

服务器是一种专门用来处理并响应其他计算机（通常称为客户端）请求的计算机。服务器用途非常广泛，包括这个网站，也可以用来制作多人游戏项目。Pixelpad 提供了创建和加入服务器、查看项目的所有服务器，以及在服务器中收发消息的函数。