---
title: ZEPETO Player
slug: world-sdk-guide-id/zepeto-player
docTags: 
createdAt: 2024-09-02T08:34:13.135Z
---

The **ZepetoPlayer **berfungsi sebagai instansi unit untuk karakter ZEPETO dalam dunia multiplayer. Ini mewakili baik pemain yang Anda kendalikan secara langsung maupun pemain lain di dalam adegan.

Dalam panduan ini, kita akan menjelajahi cara memanfaatkan API Pemain ZEPETO untuk menampilkan informasi tentang Pemain Lokal yang Anda operasikan.



## API Pemain Zepeto

Jika Anda tertarik dengan API ZepetoPlayer, silakan merujuk ke dokumentasi:

:::hint{type="info"}
- Silakan merujuk ke panduan berikut. \[[API ZEPETO.Character.Controller](https://developer.zepeto.me/docs/character-controller/)]
:::



## Contoh Penggunaan Pemain Lokal Dasar

### Memeriksa Status Pemuatan Pemain Lokal

Gunakan callback OnAddedLocalPlayer() untuk memverifikasi apakah Pemain Lokal telah dimuat.

Berikut adalah contoh kode yang menggambarkan ini:

```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("Pemain Lokal belum selesai dimuat.");
        }
    }

    Start() {
        ZepetoPlayers.instance.CreatePlayerWithUserId(WorldService.userId, new SpawnInfo(), true);
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
            this._localPlayer = ZepetoPlayers.instance.LocalPlayer;
            console.log("Pemain Lokal telah selesai dimuat.");
        });
    }
}
```



- Penjelasan Skrip:
  - Awalnya, `this._localPlayer` tidak dideklarasikan, yang berarti nilainya null. Anda membuat pemain lokal berdasarkan ID pengguna yang masuk menggunakan
  - `ZepetoPlayers.instance.CreatePlayerWithUserId()`. Setelah pemain lokal selesai dimuat, `OnAddedLocalPlayer()` callback memberikan nilai pada `this._localPlayer`.
  - Metode ini memungkinkan Anda untuk memuat pemain lokal dan memverifikasi status pemuatannya.

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



### Menampilkan Informasi Pemain Lokal

Di bawah ini adalah contoh cara mencetak ID zepeto, ID pengguna, dan nama pemain lokal yang dimuat ke log konsol.

Harap dicatat bahwa dalam kode contoh yang diberikan, `ZepetoPlayers.instance.CreatePlayerWithUserId()` tidak ditambahkan secara eksplisit.

```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(`Apakah LocalPlayer : ${this._localPlayer.zepetoPlayer.isLocalPlayer}`);
            console.log(`ID Pengguna : ${this._localPlayer.zepetoPlayer.userId}`);
            console.log(`Nama : ${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"}