ZEPETO Player

5min
Le ZepetoPlayer sert d'instance d'unité pour le personnage ZEPETO dans un monde multijoueur. Il représente à la fois le joueur que vous contrôlez directement et les autres joueurs dans la scène.
Dans ce guide, nous allons explorer comment utiliser l'API du ZEPETO Player pour afficher des informations sur le joueur local que vous contrôlez.
﻿
API Zepeto Player
Si vous êtes intéressé par l'API ZepetoPlayer, consultez la documentation :
Veuillez vous référer au guide suivant. [API ZEPETO.Character.Controller]
﻿
Exemple d'utilisation de base du joueur local
Vérification de l'état de chargement du joueur local
Utilisez le rappel OnAddedLocalPlayer() pour vérifier si le joueur local a été chargé.
Voici un exemple de code illustrant cela :
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { SpawnInfo, ZepetoPlayers, LocalPlayer, ZepetoCharacter } from 'ZEPETO.Character.Controller';
import { WorldService } from 'ZEPETO.World';

export default class LocalPlayerLoader extends ZepetoScriptBehaviour {

    private _localPlayer: LocalPlayer;
    
    Awake() {
        if(!this._localPlayer) {
            console.log("Le joueur local n'a pas fini de charger.");
        }
    }

    Start() {
        ZepetoPlayers.instance.CreatePlayerWithUserId(WorldService.userId, new SpawnInfo(), true);
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
            this._localPlayer = ZepetoPlayers.instance.LocalPlayer;
            console.log("Le joueur local a fini de charger.");
        });
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { SpawnInfo, ZepetoPlayers, LocalPlayer, ZepetoCharacter } from 'ZEPETO.Character.Controller';
import { WorldService } from 'ZEPETO.World';

export default class LocalPlayerLoader extends ZepetoScriptBehaviour {

    private _localPlayer: LocalPlayer;
    
    Awake() {
        if(!this._localPlayer) {
            console.log("Le joueur local n'a pas fini de charger.");
        }
    }

    Start() {
        ZepetoPlayers.instance.CreatePlayerWithUserId(WorldService.userId, new SpawnInfo(), true);
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
            this._localPlayer = ZepetoPlayers.instance.LocalPlayer;
            console.log("Le joueur local a fini de charger.");
        });
    }
}
﻿
﻿
Explication du script :
Au départ, le this._localPlayer n'est pas déclaré, ce qui signifie qu'il a une valeur nulle. Vous créez le joueur local en fonction de l'ID utilisateur connecté en utilisant
ZepetoPlayers.instance.CreatePlayerWithUserId(). Une fois que le joueur local a fini de charger, le OnAddedLocalPlayer() le rappel assigne une valeur à this._localPlayer.
Cette méthode vous permet de charger le joueur local et de vérifier son statut de chargement.
﻿
﻿
Affichage des informations du joueur local
Voici un exemple de la façon d'imprimer l'ID zepeto, l'ID utilisateur et le nom du joueur local chargé dans la console.
Veuillez noter que dans le code d'exemple fourni, ZepetoPlayers.instance.CreatePlayerWithUserId() n'est pas explicitement ajouté.
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script'
import {LocalPlayer, ZepetoPlayers} from "ZEPETO.Character.Controller";

export default class LocalPlayerInfo extends ZepetoScriptBehaviour {

    private _localPlayer: LocalPlayer;
    
    Start() {
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
            this._localPlayer = ZepetoPlayers.instance.LocalPlayer;
            console.log(`Est LocalPlayer : ${this._localPlayer.zepetoPlayer.isLocalPlayer}`);
            console.log(`ID Utilisateur : ${this._localPlayer.zepetoPlayer.userId}`);
            console.log(`Nom : ${this._localPlayer.zepetoPlayer.name}`);
        });
    }

}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script'
import {LocalPlayer, ZepetoPlayers} from "ZEPETO.Character.Controller";

export default class LocalPlayerInfo extends ZepetoScriptBehaviour {

    private _localPlayer: LocalPlayer;
    
    Start() {
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
            this._localPlayer = ZepetoPlayers.instance.LocalPlayer;
            console.log(`Est LocalPlayer : ${this._localPlayer.zepetoPlayer.isLocalPlayer}`);
            console.log(`ID Utilisateur : ${this._localPlayer.zepetoPlayer.userId}`);
            console.log(`Nom : ${this._localPlayer.zepetoPlayer.name}`);
        });
    }

}
﻿
﻿
﻿
Mis à jour 10 Oct 2024
Cette page vous a-t-elle aidée?
ZEPETO Players
Personnage ZEPETO