API pour changer le personnage ZEPETO en type de corps basique

6min

Lorsqu'un avatar ZEPETO entrant dans le monde porte un élément de modification corporelle ou a choisi une forme corporelle excessivement grande ou petite, cela peut entraver le gameplay dans le monde.
En utilisant l'API introduite dans ce guide, vous pouvez ramener le personnage ZEPETO à sa forme corporelle par défaut.
❗️ Attention
Le package ZEPETO.Character.Controller est disponible à partir de la version 1.11.1.
API
Description
GetBodyModifierProperties()
- Renvoie des informations sur quelle partie du corps le personnage ZEPETO porte un élément de modification corporelle.
DeformDefaultProperties()
- Cette API supprime les éléments de modification corporelle portés par le personnage ZEPETO et le ramène à sa forme corporelle par défaut.
DeformDefaultCostume()
- Cette API supprime les éléments de modification corporelle portés par le personnage ZEPETO, le ramène à sa forme corporelle par défaut et l'habille dans le costume ZEPETO par défaut.
- Elle peut également être appliquée au niveau des joueurs ZEPETO. Dans ce cas, tous les joueurs ZEPETO entrant dans le monde multijoueur auront leurs éléments de modification corporelle supprimés et seront habillés dans le costume ZEPETO par défaut.
﻿
ZepetoPropertyFlag Enum
Aucun = 0, Peau = 1, Teint = 2, Détail de la peau = 3, Visage = 4, Œil = 5, Lentille de l'œil = 6, Sourcil = 7, 
Barbe = 8, Moustache = 9, Ombre à paupières = 10, Eyeliner = 11, Cil = 12, Fard à joues = 13, Nez = 14, 
Bouche = 15, Lèvres = 16, Cheveux = 17, VêtementsLunettes = 18, VêtementsHaut = 19, VêtementsBas = 20, VêtementsChaussures = 21, 
VêtementsRobe = 22, Arrière-plan = 23, Papier peint de la pièce = 24, Sol de la pièce = 25, Bas de la pièce = 26, Haut gauche de la pièce = 27, Haut droit de la pièce = 28, 
Milieu gauche de la pièce = 29, Milieu droit de la pièce = 30, Point = 31, Taches de rousseur = 32, Poils du visage = 33, Double paupière = 34, Nail Art = 35, 
VêtementsChaussettes = 36, VêtementsGant = 37, AccessoireBracelet = 38, AccessoireCollier = 39, AccessoireBoucle d'oreille = 40, AccessoireBague = 41, AccessoireChapeau = 42, 
AccessoirePiercing = 43, Arrière-plan de la cabine = 44, LUT = 45, AccessoireMasque = 46, Maquillage = 47, AccessoireSac = 48, AccessoireAile = 49, 
VêtementsCape = 50, VêtementsSupplémentaire = 51, VisageMannequin = 52, RideauFront = 53, RideauŒil = 54, RideauBouche = 55, DoublePaupièreBas = 56, 
RideauMongo = 57, AccessoireQueue = 58, AccessoireEffet = 59, VêtementsDéformation = 60, Extensions de cheveux = 61, Ensemble de maquillage = 62, Contouring du visage = 63, 
Modèle de base = 64, Lentille de créateur = 65, Déformation de base = 66
Aucun = 0, Peau = 1, Teint = 2, Détail de la peau = 3, Visage = 4, Œil = 5, Lentille de l'œil = 6, Sourcil = 7, 
Barbe = 8, Moustache = 9, Ombre à paupières = 10, Eyeliner = 11, Cil = 12, Fard à joues = 13, Nez = 14, 
Bouche = 15, Lèvres = 16, Cheveux = 17, VêtementsLunettes = 18, VêtementsHaut = 19, VêtementsBas = 20, VêtementsChaussures = 21, 
VêtementsRobe = 22, Arrière-plan = 23, Papier peint de la pièce = 24, Sol de la pièce = 25, Bas de la pièce = 26, Haut gauche de la pièce = 27, Haut droit de la pièce = 28, 
Milieu gauche de la pièce = 29, Milieu droit de la pièce = 30, Point = 31, Taches de rousseur = 32, Poils du visage = 33, Double paupière = 34, Nail Art = 35, 
VêtementsChaussettes = 36, VêtementsGant = 37, AccessoireBracelet = 38, AccessoireCollier = 39, AccessoireBoucle d'oreille = 40, AccessoireBague = 41, AccessoireChapeau = 42, 
AccessoirePiercing = 43, Arrière-plan de la cabine = 44, LUT = 45, AccessoireMasque = 46, Maquillage = 47, AccessoireSac = 48, AccessoireAile = 49, 
VêtementsCape = 50, VêtementsSupplémentaire = 51, VisageMannequin = 52, RideauFront = 53, RideauŒil = 54, RideauBouche = 55, DoublePaupièreBas = 56, 
RideauMongo = 57, AccessoireQueue = 58, AccessoireEffet = 59, VêtementsDéformation = 60, Extensions de cheveux = 61, Ensemble de maquillage = 62, Contouring du visage = 63, 
Modèle de base = 64, Lentille de créateur = 65, Déformation de base = 66
﻿
﻿
Exemple de Script
Veuillez vous référer à l'exemple de script suivant :
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { ZepetoCharacter, LocalPlayer, ZepetoPlayers } from 'ZEPETO.Character.Controller';
import { ZepetoPropertyFlag } from 'Zepeto';
 
export default class Deform extends ZepetoScriptBehaviour {
 
     private _localPlayer: LocalPlayer;
     private _itemProperties : ZepetoPropertyFlag[]
     
     Start() {
         ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
             this._localPlayer = ZepetoPlayers.instance.LocalPlayer;
             
             // 1. Personnage local - Code pour imprimer où l'élément de changement de forme corporelle est équipé
             this._itemProperties = this._localPlayer.zepetoPlayer.character.GetBodyModifierProperties();
             console.log(this._itemProperties);
             
             // 2. Personnage local - code pour déséquiper l'élément de changement de forme corporelle
             this._localPlayer.zepetoPlayer.character.DeformDefaultProperties();
             
             // 3. Personnage local - code pour déséquiper les éléments de changement de forme corporelle et mettre l'habit par défaut
             this._localPlayer.zepetoPlayer.character.DeformDefaultCostume();
             
         });
 
       	 // 4. Code pour déséquiper tous les éléments de changement de forme corporelle des joueurs et les mettre dans des habits par défaut
         ZepetoPlayers.instance.OnAddedPlayer.AddListener(() => {
             ZepetoPlayers.instance.DeformDefaultCostume();
         });
         
     }
}

import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { ZepetoCharacter, LocalPlayer, ZepetoPlayers } from 'ZEPETO.Character.Controller';
import { ZepetoPropertyFlag } from 'Zepeto';
 
export default class Deform extends ZepetoScriptBehaviour {
 
     private _localPlayer: LocalPlayer;
     private _itemProperties : ZepetoPropertyFlag[]
     
     Start() {
         ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
             this._localPlayer = ZepetoPlayers.instance.LocalPlayer;
             
             // 1. Personnage local - Code pour imprimer où l'élément de changement de forme corporelle est équipé
             this._itemProperties = this._localPlayer.zepetoPlayer.character.GetBodyModifierProperties();
             console.log(this._itemProperties);
             
             // 2. Personnage local - code pour déséquiper l'élément de changement de forme corporelle
             this._localPlayer.zepetoPlayer.character.DeformDefaultProperties();
             
             // 3. Personnage local - code pour déséquiper les éléments de changement de forme corporelle et mettre l'habit par défaut
             this._localPlayer.zepetoPlayer.character.DeformDefaultCostume();
             
         });
 
       	 // 4. Code pour déséquiper tous les éléments de changement de forme corporelle des joueurs et les mettre dans des habits par défaut
         ZepetoPlayers.instance.OnAddedPlayer.AddListener(() => {
             ZepetoPlayers.instance.DeformDefaultCostume();
         });
         
     }
}
﻿
﻿
Description du Script
1) Les informations sur l'emplacement de l'élément de modification corporelle porté par le Joueur Local sont enregistrées dans this._itemProperties par GetBodyModifierProperties() et ces informations sont imprimées dans la console
﻿
﻿
2) Tous les éléments de modification corporelle portés par le joueur local sont supprimés par DeformDefaultProperties(), et le personnage est ramené à sa forme corporelle par défaut.
﻿
﻿
3) Par DeformDefaultCostume(), tous les éléments de modification corporelle portés par le joueur local sont supprimés, et ils sont changés pour apparaître comme s'ils portaient le costume ZEPETO par défaut.
﻿
﻿
4) Le code ci-dessous garantit que tous les joueurs entrant dans le monde auront tous leurs objets de modification corporelle retirés et seront habillés dans le costume par défaut de ZEPETO.
Cependant, les paramètres multijoueurs et l'implémentation de base du script serveur-client doivent être complétés à l'avance.
TypeScript
ZepetoPlayers.instance.OnAddedPlayer.AddListener(() => {
	ZepetoPlayers.instance.DeformDefaultCostume();
});
ZepetoPlayers.instance.OnAddedPlayer.AddListener(() => {
	ZepetoPlayers.instance.DeformDefaultCostume();
});
﻿
﻿
﻿
Les visages d'avatar animés sont également classés comme des objets de modification corporelle.
Par conséquent, lors de l'utilisation des DeformDefaultProperties(), DeformDefaultCostume() APIs, veuillez noter que l'apparence des avatars animés entrant dans le monde changera également.
﻿

API	Description
GetBodyModifierProperties()	- Renvoie des informations sur quelle partie du corps le personnage ZEPETO porte un élément de modification corporelle.
DeformDefaultProperties()	- Cette API supprime les éléments de modification corporelle portés par le personnage ZEPETO et le ramène à sa forme corporelle par défaut.
DeformDefaultCostume()	- Cette API supprime les éléments de modification corporelle portés par le personnage ZEPETO, le ramène à sa forme corporelle par défaut et l'habille dans le costume ZEPETO par défaut. - Elle peut également être appliquée au niveau des joueurs ZEPETO. Dans ce cas, tous les joueurs ZEPETO entrant dans le monde multijoueur auront leurs éléments de modification corporelle supprimés et seront habillés dans le costume ZEPETO par défaut.

Mis à jour 10 Oct 2024

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

Changer le costume du joueur local

Changer la zone de collision du personnage ZEPETO