ZEPETOプレーヤー

5min
その ZepetoPlayer は、マルチプレイヤーの世界におけるZEPETOキャラクターのユニットインスタンスとして機能します。これは、あなたが直接操作するプレイヤーと、シーン内の他のプレイヤーの両方を表します。
このガイドでは、操作しているローカルプレイヤーに関する情報を表示するために、ZEPETO PlayerのAPIを利用する方法を探ります。
﻿
Zepeto Player API
ZepetoPlayer APIに興味がある場合は、ドキュメントを参照してください：
以下のガイドを参照してください。 [ZEPETO.Character.Controller API]
﻿
基本的なローカルプレイヤーの使用例
ローカルプレイヤーの読み込み状態を確認する
OnAddedLocalPlayer()コールバックを利用して、ローカルプレイヤーが読み込まれたかどうかを確認します。
以下は、これを示すサンプルコードです：
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { SpawnInfo, ZepetoPlayers, LocalPlayer, ZepetoCharacter } from 'ZEPETO.Character.Controller';
import { WorldService } from 'ZEPETO.World';

export default class LocalPlayerLoader extends ZepetoScriptBehaviour {

    private _localPlayer: LocalPlayer;
    
    Awake() {
        if(!this._localPlayer) {
            console.log("ローカルプレイヤーの読み込みが完了していません。");
        }
    }

    Start() {
        ZepetoPlayers.instance.CreatePlayerWithUserId(WorldService.userId, new SpawnInfo(), true);
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
            this._localPlayer = ZepetoPlayers.instance.LocalPlayer;
            console.log("ローカルプレイヤーの読み込みが完了しました。");
        });
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { SpawnInfo, ZepetoPlayers, LocalPlayer, ZepetoCharacter } from 'ZEPETO.Character.Controller';
import { WorldService } from 'ZEPETO.World';

export default class LocalPlayerLoader extends ZepetoScriptBehaviour {

    private _localPlayer: LocalPlayer;
    
    Awake() {
        if(!this._localPlayer) {
            console.log("ローカルプレイヤーの読み込みが完了していません。");
        }
    }

    Start() {
        ZepetoPlayers.instance.CreatePlayerWithUserId(WorldService.userId, new SpawnInfo(), true);
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
            this._localPlayer = ZepetoPlayers.instance.LocalPlayer;
            console.log("ローカルプレイヤーの読み込みが完了しました。");
        });
    }
}
﻿
﻿
スクリプトの説明：
最初は、this._localPlayerは未宣言であり、null値を持っています。ログインユーザーIDを使用してローカルプレイヤーを作成します。
ZepetoPlayers.instance.CreatePlayerWithUserId()。ローカルプレイヤーの読み込みが完了すると、OnAddedLocalPlayer()コールバックが値をthis._localPlayerに割り当てます。
このメソッドを使用すると、ローカルプレイヤーを読み込み、その読み込み状況を確認できます。
﻿
﻿
ローカルプレイヤー情報の表示
以下は、読み込まれたローカルプレイヤーのzepeto ID、ユーザーID、および名前をコンソールログに印刷する方法の例です。
提供されたサンプルコードでは、ZepetoPlayers.instance.CreatePlayerWithUserId()は明示的に追加されていません。
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script'
import {LocalPlayer, ZepetoPlayers} from "ZEPETO.Character.Controller";

export default class LocalPlayerInfo extends ZepetoScriptBehaviour {

    private _localPlayer: LocalPlayer;
    
    Start() {
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
            this._localPlayer = ZepetoPlayers.instance.LocalPlayer;
            console.log(`ローカルプレイヤーですか : ${this._localPlayer.zepetoPlayer.isLocalPlayer}`);
            console.log(`ユーザーID : ${this._localPlayer.zepetoPlayer.userId}`);
            console.log(`名前 : ${this._localPlayer.zepetoPlayer.name}`);
        });
    }

}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script'
import {LocalPlayer, ZepetoPlayers} from "ZEPETO.Character.Controller";

export default class LocalPlayerInfo extends ZepetoScriptBehaviour {

    private _localPlayer: LocalPlayer;
    
    Start() {
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
            this._localPlayer = ZepetoPlayers.instance.LocalPlayer;
            console.log(`ローカルプレイヤーですか : ${this._localPlayer.zepetoPlayer.isLocalPlayer}`);
            console.log(`ユーザーID : ${this._localPlayer.zepetoPlayer.userId}`);
            console.log(`名前 : ${this._localPlayer.zepetoPlayer.name}`);
        });
    }

}
﻿
﻿
ZEPETO Players
ZEPETOキャラクター