Implémentation d'un objet qui suit le personnage

10min
Vous pouvez utiliser le composant NavMeshAgent pour implémenter des objets IA qui suivent votre personnage.
Dans ce guide, vous allez implémenter un objet de type Animal de compagnie qui vous suit.
﻿
ÉTAPE 1 : Configuration du NavMesh
1) Configurez un maillage de navigation (NavMesh) pour définir la zone où l'objet Animal de compagnie peut se déplacer.
Veuillez vous référer au guide NavMesh pour des détails sur la façon de le configurer.
﻿
Définissez la propriété Navigation Static de l'objet Arrière-plan et appuyez sur le bouton Bake dans l'onglet Bake pour générer le maillage de navigation.
﻿
﻿
2) Ajoutez un composant NavMeshAgent à l'objet Animal de compagnie et définissez la taille, la vitesse de rotation, l'accélération, etc. de l'Agent.
Ici, l'Agent est l'objet Animal de compagnie qui utilise le système de navigation du NavMesh.
En changeant les valeurs de l'Agent, vous pouvez définir la vitesse à laquelle l'Animal de compagnie se déplace, la vitesse de rotation et l'accélération lorsqu'il se déplace, la hauteur à laquelle il reconnaît les obstacles, et plus encore.
Nous avons défini la Distance d'Arrêt de l'Agent Nav Mesh à 3 pour faire en sorte que l'Animal de compagnie s'arrête à une distance de 3 du joueur.
﻿
﻿
Veuillez vous référer au guide NavMeshAgent pour des détails sur la façon de le configurer.
📘 Document de l'Agent Navmesh Unity
https://docs.unity3d.com/2021.3/Documentation/Manual/class-NavMeshAgent.html﻿
﻿
ÉTAPE 2 : Écrire un script AI pour un Animal de compagnie
1) créez un nouveau TypeScript et nommez-le PetController comme indiqué ci-dessous, et appliquez le script à l'objet Animal de compagnie.
PetController.ts
import { Transform } from 'UnityEngine'
import { NavMeshAgent } from 'UnityEngine.AI';
import { ZepetoPlayers } from 'ZEPETO.Character.Controller'
import { ZepetoScriptBehaviour } from 'ZEPETO.Script'
import { WorldService } from 'ZEPETO.World';
 
export default class PetController extends ZepetoScriptBehaviour {
 
    private _target: Transform;
    private _navMeshAgent: NavMeshAgent;
 
    Start() {
        this._navMeshAgent = this.GetComponent<NavMeshAgent>();
 
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
            this._target = ZepetoPlayers.instance.GetPlayer(WorldService.userId).character.transform;
        })
    }
 
    Update() {
        if (this._target == null) {
            return;
        }
        this._navMeshAgent.SetDestination(this._target.position);
    }
}
import { Transform } from 'UnityEngine'
import { NavMeshAgent } from 'UnityEngine.AI';
import { ZepetoPlayers } from 'ZEPETO.Character.Controller'
import { ZepetoScriptBehaviour } from 'ZEPETO.Script'
import { WorldService } from 'ZEPETO.World';
 
export default class PetController extends ZepetoScriptBehaviour {
 
    private _target: Transform;
    private _navMeshAgent: NavMeshAgent;
 
    Start() {
        this._navMeshAgent = this.GetComponent<NavMeshAgent>();
 
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
            this._target = ZepetoPlayers.instance.GetPlayer(WorldService.userId).character.transform;
        })
    }
 
    Update() {
        if (this._target == null) {
            return;
        }
        this._navMeshAgent.SetDestination(this._target.position);
    }
}
﻿
﻿
Description du script
Au début du script, spécifiez votre personnage ZEPETO dans _target.
Dans la fonction Update, à chaque image, utilisez la fonction SetDestination de NavMeshAgent pour définir la position de mon personnage ZEPETO au point cible de NavMesh.
﻿
2) Maintenant, appuyez sur le bouton Play pour exécuter et vous verrez que l'objet Animal de compagnie suivra votre personnage et contournera les obstacles comme les murs.
﻿
﻿
Créer un animal de compagnie au-dessus de la tête du personnage
1) Si vous souhaitez implémenter un animal de compagnie qui se trouve sur le corps du personnage au lieu de suivre le personnage, vous pouvez le faire en attachant un objet.
📘 Veuillez vous référer au guide suivant. [Attacher des objets aux personnages de ZEPETO﻿]
﻿
2) Écrivez le script suivant AttachPetController, où la variable Pet spécifie l'objet qui sera créé comme animal de compagnie.
Dans l'onglet bodyBone, ouvrez le menu déroulant pour sélectionner la partie du corps où l'objet Pet sera attaché.
AttachPetController.ts
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { ZepetoCharacter, ZepetoPlayers } from 'ZEPETO.Character.Controller';
import { Transform, Animator, GameObject, HumanBodyBones, Object } from 'UnityEngine';
 
export default class AttachPetController extends ZepetoScriptBehaviour {
 
    public Pet: GameObject;
    public bodyBone: HumanBodyBones;
 
    Start() {
 
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
            const localCharacter = ZepetoPlayers.instance.LocalPlayer.zepetoPlayer.character;           
            const animator: Animator = localCharacter.ZepetoAnimator;           
            const bone: Transform = animator.GetBoneTransform(this.bodyBone);           
            Object.Instantiate(this.Pet, bone) as GameObject;         
        });
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { ZepetoCharacter, ZepetoPlayers } from 'ZEPETO.Character.Controller';
import { Transform, Animator, GameObject, HumanBodyBones, Object } from 'UnityEngine';
 
export default class AttachPetController extends ZepetoScriptBehaviour {
 
    public Pet: GameObject;
    public bodyBone: HumanBodyBones;
 
    Start() {
 
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
            const localCharacter = ZepetoPlayers.instance.LocalPlayer.zepetoPlayer.character;           
            const animator: Animator = localCharacter.ZepetoAnimator;           
            const bone: Transform = animator.GetBoneTransform(this.bodyBone);           
            Object.Instantiate(this.Pet, bone) as GameObject;         
        });
    }
}
﻿
﻿
Description du script
Lorsque le script démarre, il trouvera le joueur local et localisera l'animateur du personnage.
Il trouvera quelle partie du corps sélectionnée dans la variable bodyBone se trouve sur l'animateur du personnage et la localisera.
Instancier un objet animal à l'emplacement que nous avons trouvé et le créer. Vous parenterez l'objet animal à la partie du corps de l'animateur du personnage que vous avez trouvée plus tôt.
﻿
3) Appuyez sur le bouton [▶︎(play)] pour l'exécuter et vous devriez voir l'objet Pet créé sur la partie du corps sélectionnée, comme indiqué dans l'image ci-dessous.
﻿
﻿
﻿
Mis à jour 10 Oct 2024
Cette page vous a-t-elle aidée?
Interagir avec un objet
Attacher des objets aux personnages de ZEPETO