PixelPAD 2D - Multiplayer

init_multiplayer() -> None

Beispiel
Beschreibung
Muss aufgerufen werden, damit ein Projekt Multiplayer unterstützt. Beachte, dass dich das NICHT mit einem Server verbindet, sondern nur die übrigen Multiplayer-Funktionen initialisiert.
Parameter
None
Keine Parameter.

Rückgabewert
Kein Rückgabewert.

create_server(size: int) -> None

Beispiel
Beschreibung
Erstellt einen Multiplayer-Server. Wenn innerhalb von 5 Sekunden niemand dem Server beitritt, wird er gelöscht.
Parameter
size
Die maximale Anzahl von Spielern, die gleichzeitig mit dem Server verbunden sein können. Muss zwischen 2 und 20 (einschließlich) liegen.

Rückgabewert
Kein Rückgabewert. Wegen der Verzögerung findest du das Ergebnis der Funktion mit get_server_event(), wobei der Ereignistyp "type": "server_created" ist.

join_server(server_id: str) -> None

Beispiel
Beschreibung
Versucht, sich mit dem Server mit der angegebenen Server-ID zu verbinden. Ist der Nutzer bereits mit einem Server verbunden, wird diese Verbindung getrennt, da man nur mit einem Server gleichzeitig verbunden sein kann.
Parameter
server_id
Die ID des Servers, dem der Nutzer beitreten soll.

Rückgabewert
Kein Rückgabewert. Wegen der Verzögerung findest du das Ergebnis der Funktion mit get_server_event(), wobei der Ereignistyp "type": "self_joined" ist.

inspect_server(server_id: str) -> None

Beispiel
Beschreibung
Liefert Informationen über einen bestimmten Server, ohne ihm beizutreten
Parameter
server_id
Die ID des Servers, über den Informationen abgerufen werden.

Rückgabewert
Kein Rückgabewert. Wegen der Verzögerung findest du das Ergebnis der Funktion mit get_server_event(), wobei der Ereignistyp "type": "server_info" ist.

get_server_event() -> dict

Beispiel
Beschreibung
Prüft im aktuellen Frame auf asynchrone (verzögerte) Antworten von create_server(), join_server() und inspect_server().
Parameter
None
Keine Parameter.

Rückgabewert
Ein Dictionary mit dem Typ des Ereignisses, das in diesem Frame empfangen wurde, oder None, wenn es kein Ereignis gibt. Ist der Ereignistyp nicht None, enthält das Dict außerdem das boolesche Feld "status", das angibt, ob die Anfrage erfolgreich war, sowie das Feld "message" mit einem String mit der Ereignisnachricht, zum Beispiel einer Server-ID aus einem "server_created"-Ereignis.

send_message(data: str) -> None

Beispiel
Beschreibung
Sendet Daten an alle anderen Nutzer, die mit demselben Server verbunden sind.
Parameter
data
Der zu sendende String. Darf höchstens 256 Zeichen lang sein.

Rückgabewert
Kein Rückgabewert.

get_messages() -> list

Beispiel
Beschreibung
Liefert alle Nachrichten, die seit dem letzten Aufruf von get_messages() vom aktuellen Server empfangen wurden.
Parameter
None
Keine Parameter.

Rückgabewert
Eine Liste der empfangenen String-Nachrichten, geordnet von der ältesten zur zuletzt empfangenen. Gibt eine leere Liste zurück, wenn keine Nachrichten empfangen wurden.

get_player_count() -> int

Beispiel
Beschreibung
Prüft, wie viele Personen sich im aktuell verbundenen Server befinden.
Parameter
None
Keine Parameter.

Rückgabewert
Die Anzahl der mit dem aktuellen Server verbundenen Personen, 0 wenn keine Verbindung besteht.

leave_server() -> None

Beispiel
Beschreibung
Trennt den aktuellen Nutzer von allen Servern, in denen er sich befindet.
Parameter
None
Keine Parameter.

Rückgabewert
Kein Rückgabewert.

get_servers() -> list

Beispiel
Beschreibung
Liefert eine Liste der vorhandenen Server für das aktuelle Projekt
Parameter
None
Keine Parameter.

Rückgabewert
Eine Liste mit allen aktiven Server-IDs für dasselbe Projekt, oder eine leere Liste, wenn es keine gibt.

Multiplayer und Server

Multiplayer-Projekte sind Projekte, die du zusammen mit anderen spielen kannst. Manchmal teilen sich dafür mehrere Personen dieselbe Tastatur, es geht aber auch über das Internet, sodass alle ihren eigenen Computer nutzen und gemeinsam spielen können, auch wenn sie an verschiedenen Orten sind. Pixelpad ermöglicht solche Projekte über Server.

Ein Server ist ein Computer, der Anfragen anderer Computer, oft Clients genannt, verarbeitet und beantwortet. Server werden für sehr viele Zwecke eingesetzt, auch für diese Website, aber eben auch für Multiplayer-Projekte. Pixelpad hat Funktionen, um Server zu erstellen und ihnen beizutreten, um Server zu inspizieren und alle Server eines Projekts zu sehen sowie um Nachrichten in den Servern zu senden und zu empfangen.