PixelPAD 2D - Multijoueur

init_multiplayer() -> None

Exemple
Description
Doit être appelée pour avoir un projet multijoueur. Note que cela ne te connecte PAS à un serveur : cela initialise seulement le reste des fonctionnalités multijoueur.
Paramètres
None
Aucun paramètre.

Valeur de retour
Aucune valeur de retour.

create_server(size: int) -> None

Exemple
Description
Crée un serveur multijoueur. Si personne n'a rejoint le serveur dans les 5 secondes, il est supprimé.
Paramètres
size
Le nombre maximal de joueurs pouvant être connectés au serveur en même temps. Doit être entre 2 et 20 inclusivement.

Valeur de retour
Aucune valeur de retour. En raison du délai, le résultat de la fonction se trouve dans get_server_event(), où le type d'événement sera "type": "server_created".

join_server(server_id: str) -> None

Exemple
Description
Tente de se connecter au serveur ayant l'identifiant indiqué. Si l'utilisateur est déjà connecté à un serveur, il en sera déconnecté, car on ne peut être connecté qu'à un seul serveur à la fois.
Paramètres
server_id
L'identifiant du serveur que l'utilisateur doit tenter de rejoindre.

Valeur de retour
Aucune valeur de retour. En raison du délai, le résultat de la fonction se trouve dans get_server_event(), où le type d'événement sera "type": "self_joined".

inspect_server(server_id: str) -> None

Exemple
Description
Obtient des informations sur un serveur précis sans le rejoindre
Paramètres
server_id
L'identifiant du serveur sur lequel obtenir des informations.

Valeur de retour
Aucune valeur de retour. En raison du délai, le résultat de la fonction se trouve dans get_server_event(), où le type d'événement sera "type": "server_info".

get_server_event() -> dict

Exemple
Description
Vérifie, pendant l'image courante, les réponses asynchrones (différées) de create_server(), join_server() et inspect_server().
Paramètres
None
Aucun paramètre.

Valeur de retour
Un dictionnaire avec le type d'événement reçu pendant l'image, ou None s'il n'y a aucun événement. Si le type d'événement n'est pas None, le dictionnaire contient aussi le champ booléen "status", qui indique si la requête a réussi ou non, ainsi que le champ "message", une chaîne contenant le message de l'événement, comme l'identifiant du serveur lors d'un événement "server_created".

send_message(data: str) -> None

Exemple
Description
Envoie des données à tous les autres utilisateurs connectés au même serveur.
Paramètres
data
La chaîne à envoyer. Sa longueur doit être inférieure ou égale à 256 caractères.

Valeur de retour
Aucune valeur de retour.

get_messages() -> list

Exemple
Description
Obtient tous les messages reçus du serveur courant depuis le dernier appel à get_messages().
Paramètres
None
Aucun paramètre.

Valeur de retour
Une liste des messages (chaînes) reçus, du plus ancien au plus récent. Renvoie une liste vide si aucun message n'a été reçu.

get_player_count() -> int

Exemple
Description
Vérifie combien de personnes se trouvent sur le serveur actuellement connecté.
Paramètres
None
Aucun paramètre.

Valeur de retour
Le nombre de personnes connectées au serveur courant, 0 s'il n'y a pas de connexion.

leave_server() -> None

Exemple
Description
Déconnecte l'utilisateur courant de tout serveur où il se trouve.
Paramètres
None
Aucun paramètre.

Valeur de retour
Aucune valeur de retour.

get_servers() -> list

Exemple
Description
Obtient la liste des serveurs existants pour le projet courant
Paramètres
None
Aucun paramètre.

Valeur de retour
Une liste de tous les identifiants de serveurs actifs pour le même projet, ou une liste vide s'il n'y en a aucun.

Multijoueur et serveurs

Les projets multijoueurs sont des projets auxquels tu peux jouer avec d'autres personnes. Parfois, plusieurs personnes partagent le même clavier, mais cela peut aussi se faire par Internet : chacun utilise alors son propre ordinateur et on joue ensemble même à distance. Pixelpad te permet de créer de tels projets grâce aux serveurs.

Un serveur est un ordinateur conçu pour traiter les requêtes d'autres ordinateurs, souvent appelés clients, et y répondre. Les serveurs servent à une foule d'usages, y compris ce site web, mais aussi à créer des projets multijoueurs. Pixelpad offre des fonctions pour créer et rejoindre des serveurs, pour inspecter et voir tous les serveurs d'un projet, et pour envoyer et recevoir des messages sur les serveurs.