État de la salle multijoueur

8min

﻿
La salle Multiplay fournit une propriété d'état pour gérer l'emplacement des joueurs ou des objets connectés.
La définition des données de l'état peut être gérée à partir du fichier Schema, qui se trouve en dessous du package multiplay.
L'événement onStateChange est d'abord appelé lorsque le client établit avec succès une connexion à la salle, et est ensuite appelé chaque fois qu'il y a des changements dans les données d'état.


API du serveur
API
Description
state.SCHEMA_NAME
Vous pouvez accéder au champ SCHEMA_NAME défini dans le fichier schema avec l'état.

Vous pouvez modifier la valeur du champ à la demande d'un client ou de la logique interne du serveur.

L'état modifié est ensuite automatiquement propagé aux clients en utilisant l'événement OnStateChange.
📘 Veuillez vous référer au guide suivant. [API ZEPETO.Multiplay(Server)]
TypeScript
import { Location } from 'ZEPETO.Multiplay.Schema';

export default class extends Sandbox {
 
   ...
   const location: Location = this.state.playerLocation;
   // Gestion de l'état.
   ...
}
import { Location } from 'ZEPETO.Multiplay.Schema';

export default class extends Sandbox {
 
   ...
   const location: Location = this.state.playerLocation;
   // Gestion de l'état.
   ...
}
﻿
API
Description
room.OnStateChange(State, isFirst)
Vous pouvez enregistrer un rappel de changement d'état lorsque vous rejoignez la salle.

Vous pouvez recevoir l'état de l'ensemble de la salle pour la première fois, et seul l'état modifié sera reçu par la suite.
API Client
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { Location } from 'ZEPETO.Multiplay.Schema';

export default class SampleClient extends ZepetoScriptBehaviour {

    Start() {
        this.multiplay.RoomJoined += (room: Room) => {
            room.OnStateChange += this.OnStateChange;
        };
    }

    private OnStateChange(state: State, isFirst: boolean) {
        const location: Location = state.playerLocation;
        // Gestion de la localisation du joueur en utilisant l'état mis à jour.  
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { Location } from 'ZEPETO.Multiplay.Schema';

export default class SampleClient extends ZepetoScriptBehaviour {

    Start() {
        this.multiplay.RoomJoined += (room: Room) => {
            room.OnStateChange += this.OnStateChange;
        };
    }

    private OnStateChange(state: State, isFirst: boolean) {
        const location: Location = state.playerLocation;
        // Gestion de la localisation du joueur en utilisant l'état mis à jour.  
    }
}
﻿
﻿
Définir le fichier de schéma
Le schéma est une structure de données pour définir l'état actuel dans la salle. Les salles sont principalement utilisées pour gérer les informations des joueurs, les emplacements des joueurs ou des objets, etc.
Pour modifier un schéma, vous pouvez sélectionner Vue du projet → Actif MultiplayPackage → schema.json, puis modifier le type de données à utiliser pour le Monde dans la fenêtre Inspecteur.
Vous pouvez modifier le type de données à utiliser pour le Monde dans la fenêtre Inspecteur.
ÉTAPE 1 : Définir les types de schéma
Les types de schéma sont la structure de données utilisée dans le Monde. Dans l'Inspecteur → Types de schéma, appuyez sur le bouton [+] et ajoutez des données.
4-4-3-1.gif
﻿
﻿
ÉTAPE 2 : Ajouter l'état de la pièce
L'état de la pièce est la propriété qui montre l'état actuel de la pièce du Monde, et est exprimé dans la structure de schéma comme défini ci-dessus.
Parmi les types de schéma, sélectionnez le type État de la pièce qui sera utilisé comme l'état actuel du Monde et définissez-le comme le NOM_DU_SCHEMA.
﻿
Exemple de Schemas.json
JSON
{
"État" : {"joueurs" : {"carte" : "Joueur"}},
"Joueur" : {"sessionId" : "string","zepetoUserId" : "string","transform" : "Transform","état" : "number","sousÉtat" : "number"},
"Transform" : {"position" : "Vector3","rotation" : "Vector3"},
"Vector3" : {"x" : "number","y" : "number","z" : "number"}
}
{
"État" : {"joueurs" : {"carte" : "Joueur"}},
"Joueur" : {"sessionId" : "string","zepetoUserId" : "string","transform" : "Transform","état" : "number","sousÉtat" : "number"},
"Transform" : {"position" : "Vector3","rotation" : "Vector3"},
"Vector3" : {"x" : "number","y" : "number","z" : "number"}
}
﻿
﻿

API	Description
state.SCHEMA_NAME	Vous pouvez accéder au champ SCHEMA_NAME défini dans le fichier schema avec l'état. Vous pouvez modifier la valeur du champ à la demande d'un client ou de la logique interne du serveur. L'état modifié est ensuite automatiquement propagé aux clients en utilisant l'événement OnStateChange.

API	Description
room.OnStateChange(State, isFirst)	Vous pouvez enregistrer un rappel de changement d'état lorsque vous rejoignez la salle. Vous pouvez recevoir l'état de l'ensemble de la salle pour la première fois, et seul l'état modifié sera reçu par la suite.

Mis à jour 10 Oct 2024

Cette page vous a-t-elle aidée?

Message de la salle multiplay

Accéder aux adresses IP Multiplay