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。您可以使用
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(`Is LocalPlayer : ${this._localPlayer.zepetoPlayer.isLocalPlayer}`);
            console.log(`User ID : ${this._localPlayer.zepetoPlayer.userId}`);
            console.log(`Name : ${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(`Is LocalPlayer : ${this._localPlayer.zepetoPlayer.isLocalPlayer}`);
            console.log(`User ID : ${this._localPlayer.zepetoPlayer.userId}`);
            console.log(`Name : ${this._localPlayer.zepetoPlayer.name}`);
        });
    }

}
﻿
﻿
﻿
更新日期 11 Oct 2024
此页面是否对您有帮助？