ZEPETOキャラクターの衝突エリアの変更

3min
ZEPETOキャラクターの体型に関係なく、キャラクターコントローラーの衝突エリアのサイズはすべてのキャラクターで一貫しています。
キャラクターコントローラーの衝突エリアは基本的な体型に合わせて調整されており、円柱形です。
ランタイムのシーンモードでは、生成されたZEPETOキャラクターを選択することで、キャラクターコントローラーの衝突エリアを表示できます。
円柱形のキャラクターコントローラー衝突エリア
﻿
コントローラー衝突エリアのデフォルト値
﻿
﻿
ZEPETOキャラクターの高さは、体型や装備しているアイテムによって異なる場合があります。
基本的な体型から大きく異なる場合、衝突エリアが不自然に見えることがあります。
📘 以下のガイドを参照してください。[キャラクターの高さを知りたい﻿]
﻿
そのような場合、ランタイム中にスクリプトを使用してキャラクターコントローラーのコライダー属性値を変更できます。
高さ: 衝突エリアの高さ
中心: 衝突エリアの中心軸
半径: 衝突エリアの半径
例で使用されている値は、テストワールドとテストアカウント用に設定されています。設定をあなたのワールドに合わせて調整してください。例では、半径の値は変更されていません。
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;
             
             // ローカルキャラクターの高さを測定
             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);
         // ローカルキャラクターの高さ
         console.log(characterHeight);                  
 
        // 基本的な体形の高さを約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;
             
             // ローカルキャラクターの高さを測定
             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);
         // ローカルキャラクターの高さ
         console.log(characterHeight);                  
 
        // 基本的な体形の高さを約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);      
    }
}
﻿
基本的なスクリプトは、キャラクターコントローラーにアクセスし、プロパティの値を変更することを含みます：
this._localPlayer.zepetoPlayer.character.characterController.height = number;
this._localPlayer.zepetoPlayer.character.characterController.center = Vector3;
実行時に小さな体形のための衝突エリアが縮小された外観
﻿
特定のユニークアイテムを着用しているアバターの高さを正しく測定できない場合があります。
﻿
更新日 11 Oct 2024
このページは役に立ちましたか？
ZEPETOキャラクターを基本体型に変更するAPI
カスタムアニメーションを適用する方法