ZEPETOキャラクターの現在地を取得する

5 分

このガイドでは、ZEPETO World内でローカルプレイヤーのZEPETOキャラクターの現在の位置を確認する方法を示します。

位置情報は変換オブジェクトの位置に保存されているため、ZEPETOプレイヤーの変換にアクセスしてその位置を見つけることが重要です。

ステップ 1 : スクリプトの作成

[Project]パネルの左上隅にある[+]メニューを選択するか、Assets > Create > ZEPETO > TypeScriptを選択します。
追加したスクリプトの名前をGetPositionに変更し、以下のサンプルスクリプトを書きます。

import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { ZepetoPlayers, ZepetoCharacter } from 'ZEPETO.Character.Controller';
import { Text } from 'UnityEngine.UI';
import { WorldService } from 'ZEPETO.World';
 
export default class GetPosition extends ZepetoScriptBehaviour {
 
    public debugText: Text;
 
    private _zepetoCharacter: ZepetoCharacter;
 
    Start() {   
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
            // ローカルプレイヤーのuserIdを使用してZepetoCharacterを取得します。
            this._zepetoCharacter = ZepetoPlayers.instance.GetPlayer(WorldService.userId).character;
        })
    }
 
    Update() {
        // 現在のプレイヤーの位置でデバッグテキストを更新します。
        this.debugText.text = "現在のプレイヤーの位置 : " + this._zepetoCharacter.transform.position.ToString();
    }
}

❗️ 注意 マルチプレイヤー環境でのGetPlayer()関数を使用するには、sessionIdをパラメータとして使用する必要があります。

📘 以下のガイドを参照してください。 [ZEPETO Players]

シーンにGameObjectを追加し、名前を変更します。CharacterPosition。
- 書かれたGetPosition ZEPETOScriptを追加し、Hierarchyウィンドウからドラッグ＆ドロップすることで、ZEPETO Script InspectorウィンドウのプロパティにボタンUIを接続します。

ステップ2：実行

再生ボタンを押すと、Text UIを通じてキャラクターのリアルタイムの位置を確認できます。