---
title: ผู้เล่น ZEPETO
slug: world-sdk-guide-th/QEI1-zepeto
docTags: 
createdAt: 2024-09-02T08:34:13.135Z
---

The **ZepetoPlayer **ทำหน้าที่เป็นหน่วยอินสแตนซ์สำหรับตัวละคร ZEPETO ในโลกหลายผู้เล่น มันแสดงถึงผู้เล่นที่คุณควบคุมโดยตรงและผู้เล่นคนอื่นในฉาก.

ในคู่มือนี้ เราจะสำรวจวิธีการใช้ API ของ ZEPETO Player เพื่อแสดงข้อมูลเกี่ยวกับผู้เล่นท้องถิ่นที่คุณกำลังดำเนินการอยู่.



## API ของ Zepeto Player

หากคุณสนใจใน API ของ ZepetoPlayer โปรดดูเอกสาร:

:::hint{type="info"}
- โปรดดูคู่มือต่อไปนี้. \[[API ของ ZEPETO.Character.Controller](https://developer.zepeto.me/docs/character-controller/)]
:::



## ตัวอย่างการใช้งานผู้เล่นท้องถิ่นพื้นฐาน

### ตรวจสอบสถานะการโหลดของผู้เล่นท้องถิ่น

ใช้ callback 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("Local Player has not finished loading.");
        }
    }

    Start() {
        ZepetoPlayers.instance.CreatePlayerWithUserId(WorldService.userId, new SpawnInfo(), true);
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
            this._localPlayer = ZepetoPlayers.instance.LocalPlayer;
            console.log("Local Player has finished loading.");
        });
    }
}
```



- คำอธิบายสคริปต์:
  - ในตอนแรก, `this._localPlayer` ยังไม่ได้ประกาศ, หมายความว่ามันมีค่าเป็น null. คุณสร้างผู้เล่นท้องถิ่นตาม ID ผู้ใช้ที่เข้าสู่ระบบโดยใช้
  - `ZepetoPlayers.instance.CreatePlayerWithUserId()`. เมื่อผู้เล่นท้องถิ่นเสร็จสิ้นการโหลด, `OnAddedLocalPlayer()` callback จะกำหนดค่าให้กับ `this._localPlayer`.
  - วิธีนี้ช่วยให้คุณโหลดผู้เล่นท้องถิ่นและตรวจสอบสถานะการโหลดของมันได้.

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-nrhiF3s5qDSO8kpdStr64-20240904-102412.gif)



### การแสดงข้อมูลผู้เล่นท้องถิ่น

ด้านล่างนี้คือตัวอย่างวิธีการพิมพ์ zepeto ID, user ID, และชื่อของผู้เล่นท้องถิ่นที่โหลดไปยัง console log.

โปรดทราบว่าในตัวอย่างโค้ดที่ให้ไว้, `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}`);
        });
    }

}
```

::Image[]{src="https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-cPbrP_DKcO4IHjH9BmZvo-20240904-102412.png" size="56" width="388" height="118" position="center" showCaption="false"}