Changer la zone de collision du personnage ZEPETO

4min
Indépendamment de la forme du corps du personnage ZEPETO, la taille de la zone de collision du contrôleur de personnage est cohérente pour tous.
La zone de collision du contrôleur de personnage est adaptée à la forme de corps de base et est de forme cylindrique.
Dans le mode Scène de l'exécution, en sélectionnant un personnage ZEPETO généré, vous pouvez voir la zone de collision du contrôleur de personnage.
Zone de collision du contrôleur de personnage en forme cylindrique
﻿
Valeurs par défaut de la zone de collision du contrôleur
﻿
﻿
La hauteur d'un personnage ZEPETO peut varier en fonction de sa forme corporelle ou des objets équipés.
Lorsqu'il y a une différence significative par rapport à la forme corporelle de base, la zone de collision peut parfois sembler peu naturelle.
📘 Veuillez vous référer au guide suivant. [Vous voulez connaître la hauteur du personnage﻿]
﻿
Dans de tels cas, vous pouvez modifier la valeur de l'attribut Collider du contrôleur de personnage à l'aide de scripts pendant l'exécution.
Hauteur : La hauteur de la zone de collision
Centre : L'axe central de la zone de collision
Rayon : Le rayon de la zone de collision
Veuillez noter que les valeurs utilisées dans les exemples sont définies pour le monde de test et le compte de test. Ajustez les paramètres pour convenir à votre monde. Dans l'exemple, la valeur du Rayon n'a pas été modifiée.
TypeScript
import {HumanBodyBones, Vector3, WaitForEndOfFrame, WaitForSeconds } from 'UnityEngine';
import {KnowSockets, LocalPlayer, ZepetoPlayers, ZepetoPlayer } from 'ZEPETO.Character.Controller';
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
 
export default class ChangeCollider extends ZepetoScriptBehaviour {
 
     private _localPlayer: LocalPlayer;
 
     Start() {
 
         ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
             this._localPlayer = ZepetoPlayers.instance.LocalPlayer;
             
             // Mesurer la hauteur du personnage local
             this.StartCoroutine(this.CoGetZepetoHeight(this._localPlayer.zepetoPlayer));
         });
     }
 
     *CoGetZepetoHeight(zepeto: ZepetoPlayer) {
         yield new WaitForEndOfFrame();
         const headPosition = zepeto.character.GetSocket(KnowSockets.HEAD_UPPER).position;
         const leftFootPosition = zepeto.character.ZepetoAnimator.GetBoneTransform(HumanBodyBones.LeftFoot).position;
         const rightFootPosition = zepeto.character.ZepetoAnimator.GetBoneTransform(HumanBodyBones.RightFoot).position;
         const characterCenter = Vector3.Lerp(leftFootPosition, rightFootPosition, 0.5);
         const characterHeight = Vector3.Distance(headPosition, characterCenter);
         // Hauteur du personnage local
         console.log(characterHeight);                  
 
        // Définir la hauteur et le point central en fonction d'un ratio, en supposant que la hauteur de la forme corporelle de base soit d'environ 0.85
        let controllerHeight = characterHeight / 0.85 * 1.2;
        let controllerCenterY = controllerHeight / 2;
 
        this._localPlayer.zepetoPlayer.character.characterController.height = controllerHeight;
        this._localPlayer.zepetoPlayer.character.characterController.center = new Vector3(0, controllerCenterY, 0);      
    }
}
import {HumanBodyBones, Vector3, WaitForEndOfFrame, WaitForSeconds } from 'UnityEngine';
import {KnowSockets, LocalPlayer, ZepetoPlayers, ZepetoPlayer } from 'ZEPETO.Character.Controller';
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
 
export default class ChangeCollider extends ZepetoScriptBehaviour {
 
     private _localPlayer: LocalPlayer;
 
     Start() {
 
         ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
             this._localPlayer = ZepetoPlayers.instance.LocalPlayer;
             
             // Mesurer la hauteur du personnage local
             this.StartCoroutine(this.CoGetZepetoHeight(this._localPlayer.zepetoPlayer));
         });
     }
 
     *CoGetZepetoHeight(zepeto: ZepetoPlayer) {
         yield new WaitForEndOfFrame();
         const headPosition = zepeto.character.GetSocket(KnowSockets.HEAD_UPPER).position;
         const leftFootPosition = zepeto.character.ZepetoAnimator.GetBoneTransform(HumanBodyBones.LeftFoot).position;
         const rightFootPosition = zepeto.character.ZepetoAnimator.GetBoneTransform(HumanBodyBones.RightFoot).position;
         const characterCenter = Vector3.Lerp(leftFootPosition, rightFootPosition, 0.5);
         const characterHeight = Vector3.Distance(headPosition, characterCenter);
         // Hauteur du personnage local
         console.log(characterHeight);                  
 
        // Définir la hauteur et le point central en fonction d'un ratio, en supposant que la hauteur de la forme corporelle de base soit d'environ 0.85
        let controllerHeight = characterHeight / 0.85 * 1.2;
        let controllerCenterY = controllerHeight / 2;
 
        this._localPlayer.zepetoPlayer.character.characterController.height = controllerHeight;
        this._localPlayer.zepetoPlayer.character.characterController.center = new Vector3(0, controllerCenterY, 0);      
    }
}
﻿
Le script essentiel implique d'accéder au contrôleur de personnage et de modifier les valeurs des propriétés :
this._localPlayer.zepetoPlayer.character.characterController.height = number;
this._localPlayer.zepetoPlayer.character.characterController.center = Vector3;
Apparence d'une zone de collision réduite pour des formes corporelles plus petites pendant l'exécution
﻿
Il peut y avoir des cas où vous ne pouvez pas mesurer correctement la hauteur des avatars portant des objets uniques spécifiques.
﻿
Mis à jour 10 Oct 2024
Cette page vous a-t-elle aidée?
API pour changer le personnage ZEPETO en type de corps basique
Comment appliquer une animation personnalisée