Memulai
Membuat karakter Zepeto

17min
LANGKAH 0 : Menambahkan Dasar ke Adegan
Di jendela Hierarchy, klik pada 3D Object → Plane.
﻿
Atur posisi Plane ke X: 0, Y: 0, Z: 0, dan atur ukuran cukup besar ke X: 10, Y: 1, Z: 10.
﻿
👍 Tips
Plane adalah lantai paling dasar untuk tujuan pengujian.
Tidak masalah apa yang Anda gunakan selama itu adalah Objek dengan Collider.
Saat Anda semakin akrab dengan pembuatan Dunia, Anda dapat membuat peta keren untuk menggantikan lantai.
Tanpa platform, karakter akan jatuh segera setelah dibuat dan tidak akan terlihat.
﻿
LANGKAH 1 : Menambahkan komponen Pemain ZEPETO
Di jendela Hierarchy, pilih ZEPETO → tab ZepetoPlayers.
﻿
Sebuah objek bernama ZepetoPlayers akan secara otomatis dibuat seperti yang ditunjukkan di bawah ini.  

ZepetoPlayers adalah komponen yang mengelola modul pengontrol karakter dalam Dunia.
﻿
﻿
Nilai untuk kontrol karakter dan fungsi terkait dapat diatur di jendela Inspector.
Anda biasanya dapat mengatur hal-hal seperti pengaturan kamera ZEPETO, kecepatan gerakan karakter, tinggi lompatan, dll.
Dalam contoh ini, kita akan menggunakan nilai default.
📘 Untuk pengaturan yang lebih rinci, silakan merujuk ke panduan Pengontrol Karakter ZEPETO. Pengontrol Karakter ZEPETO﻿ 
﻿
LANGKAH 2 : Untuk Memuat Karakter
Untuk memuat karakter, Anda perlu membuat file ZEPETOScript baru.
1) Di panel [Proyek], pilih menu [+] di sudut kiri atas atau pilih Aset → Buat → ZEPETO → TypeScript.
﻿
﻿
2) Ketika file ZEPETOScript dibuat, silakan masukkan nama sebagai CharacterController. Sebuah file skrip akan dibuat seperti yang ditunjukkan di bawah ini.
﻿
﻿
3) Di menu Hierarchy → [+] → jalankan menu Create Empty.
﻿
﻿
4) Ketika membuat GameObject Kosong, tulis CharacterController. Sebuah GameObject akan dibuat seperti yang ditunjukkan di bawah ini.
﻿
﻿
5) Seret file ZEPETOScript CharacterController yang telah dibuat sebelumnya ke GameObject sebagai Komponen.
﻿
ZEPETOScript tidak akan berjalan kecuali ditambahkan sebagai komponen ke GameObject di Scene.
﻿
6) Pertama, masukkan ID ZEPETO Anda untuk memuat karakter ke dalam Scene.
Buka file ZEPETOScript CharacterController dan jalankan program editor skrip.
Kemudian terapkan skrip contoh di bawah ini.
Silakan masukkan ID ZEPETO Anda di tempat yang tertulis [ZEPETO_ID].
Jika ID ZEPETO Anda adalah 'abcd', Anda harus memasukkannya sebagai ZepetoPlayers.instance.CreatePlayerWithZepetoId("", "abcd", new SpawnInfo(), true)
﻿
Skrip untuk memuat karakter ZEPETO dengan ID ZEPETO tertentu
Script untuk memuat karakter ZEPETO dengan ZEPETO ID tertentu
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { SpawnInfo, ZepetoPlayers, LocalPlayer } from 'ZEPETO.Character.Controller';

export default class CharacterLoader extends ZepetoScriptBehaviour {

    Start() {
        ZepetoPlayers.instance.CreatePlayerWithZepetoId("", "[ZEPETO_ID]", new SpawnInfo(), true);
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
            const player: LocalPlayer = ZepetoPlayers.instance.LocalPlayer;
        });
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { SpawnInfo, ZepetoPlayers, LocalPlayer } from 'ZEPETO.Character.Controller';

export default class CharacterLoader extends ZepetoScriptBehaviour {

    Start() {
        ZepetoPlayers.instance.CreatePlayerWithZepetoId("", "[ZEPETO_ID]", new SpawnInfo(), true);
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
            const player: LocalPlayer = ZepetoPlayers.instance.LocalPlayer;
        });
    }
}
﻿
7) Setelah menyimpan skrip, silakan kembali ke editor Unity.
Silakan lanjutkan ke pelaksanaan LANGKAH 3.
Jika Anda menggunakan kode ini, Anda hanya akan bermain dengan avatar dari ZEPETO ID tertentu.
Ketika Anda meluncurkan dunia Anda, Anda perlu memodifikasi kode Anda berdasarkan ZEPETO ID pengguna yang mengakses dunia Anda, bukan ZEPETO ID yang Anda masukkan dalam kode Anda. Silakan gunakan skrip di bawah ini.
﻿
Skrip untuk memuat karakter dari ID yang masuk
Skrip untuk memuat karakter dari ID yang masuk
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { SpawnInfo, ZepetoPlayers, LocalPlayer, ZepetoCharacter } from 'ZEPETO.Character.Controller';
import { WorldService } from 'ZEPETO.World'; 
 
export default class CharacterLoader extends ZepetoScriptBehaviour {   
 
    Start() {       
        // Ambil user id yang ditentukan dari login ke zepeto melalui editor.
        ZepetoPlayers.instance.CreatePlayerWithUserId(WorldService.userId, new SpawnInfo(), true);            
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {           
            const player: LocalPlayer = ZepetoPlayers.instance.LocalPlayer;       
        });   
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { SpawnInfo, ZepetoPlayers, LocalPlayer, ZepetoCharacter } from 'ZEPETO.Character.Controller';
import { WorldService } from 'ZEPETO.World'; 
 
export default class CharacterLoader extends ZepetoScriptBehaviour {   
 
    Start() {       
        // Ambil user id yang ditentukan dari login ke zepeto melalui editor.
        ZepetoPlayers.instance.CreatePlayerWithUserId(WorldService.userId, new SpawnInfo(), true);            
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {           
            const player: LocalPlayer = ZepetoPlayers.instance.LocalPlayer;       
        });   
    }
}
﻿
Skrip ini membuat karakter ZEPETO berdasarkan ID yang masuk dan tidak menerima ID ZEPETO tertentu, jadi pastikan untuk masuk ke editor Unity sebelum menguji.
Setelah menyimpan skrip, silakan kembali ke editor Unity.
Silakan lanjutkan ke pelaksanaan LANGKAH 3.
Silakan pastikan bahwa hanya ada satu kode pembuatan pemain lokal dalam skrip klien.
Jika beberapa pemain identik dibuat, skrip CreatePlayerWithUserId() mungkin dipanggil di tempat lain.
Kesalahan umum adalah menerapkan kode contoh multiplayer sambil membiarkan kode pembuatan karakter dalam panduan ini utuh, yang mengakibatkan karakter dibuat dua kali. Silakan kelola ini dengan mengomentari salah satu sisi.
﻿
LANGKAH 3 : Jalankan
Gunakan tombol [▶︎(putar)] di tengah layar untuk memeriksa apakah CharacterController berfungsi dengan baik.
Karakter yang dimuat disebut sebagai karakter pemain lokal, yang berarti karakter ZEPETO yang dapat dikendalikan langsung oleh pengguna di perangkat mereka sendiri.
CharacterController memiliki Pemetaan Kunci kontrol karakter umum untuk setiap Acara Input yang sesuai dengan perangkat (PC/Mobile). Dengan demikian, karakter yang dimuat dapat dikendalikan dalam sebuah Adegan terlepas dari platformnya.
Di PC, karakter dan kamera dapat dioperasikan dengan mouse. Di perangkat mobile, karakter dan kamera dapat dioperasikan dengan pad virtual seperti yang ditunjukkan dalam tangkapan layar di bawah ini.
﻿
👍 Antarmuka input berikut didukung untuk kontrol karakter:
PC
Gerak: Tombol panah keyboard, WASD
Lompat: Spasi
Lompat Ganda: (Kiri) Shift
Zoom: Gulir mouse
Putar: Seret layar
Mobile
Gerak: (Tepi kiri bawah layar) pad virtual
Lompat: (Tepi kanan bawah layar) tombol pad virtual
Zoom: (Dua jari) seret layar
Putar: (Satu jari) seret layar
﻿
Jika pembuatan karakter ZEPETO tidak berfungsi dengan baik, silakan pergi ke Menu Unity > Pengaturan Proyek > Editor > Masukkan Pengaturan Mode Pemutaran.
matikan Opsi Mode Pemutaran Masuk.
﻿
﻿
LANGKAH 4: Ubah posisi awal karakter ZEPETO
Posisi awal karakter ZEPETO dibuat di UnityEngine.Vector3(0,0,0) kecuali jika diatur sebaliknya.
Nilai rotasi juga dihasilkan pada sudut UnityEngine.Quaternion.Euler(0,0,0).
Posisi dan nilai rotasi karakter diatur menggunakan ZepetoPlayers.instance.CreatePlayerWithUserId(WorldService.userId, new SpawnInfo(), true); argumen fungsi, SpawnInfo(), akan dihasilkan.
Jadi Anda dapat mengatur nilai yang diinginkan untuk SpawnInfo() sebelum memanggil fungsi pembuatan karakter untuk memastikan ia muncul di lokasi tertentu.
Kami telah menempatkan Objek 3D > Kubus di lokasi (0,0,0) di peta.
Jika Anda mengubah nilai lokasi muncul untuk karakter menjadi berikut, ia akan muncul di atas Kubus.
CharacterController
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { SpawnInfo, ZepetoPlayers, LocalPlayer, ZepetoCharacter } from 'ZEPETO.Character.Controller';
import { WorldService } from 'ZEPETO.World';
import { Quaternion, Vector3 } from 'UnityEngine';

export default class CharacterController extends ZepetoScriptBehaviour {

    Start() {
        // Atur Posisi Spawn Karakter
        const spawnInfo = new SpawnInfo();
        spawnInfo.position = new Vector3(0,2,0);
        // Atur Rotasi Spawn Karakter
        spawnInfo.rotation = Quaternion.Euler(0,0,0);

        // Ambil id pengguna yang ditentukan dari login ke zepeto melalui editor.
        ZepetoPlayers.instance.CreatePlayerWithUserId(WorldService.userId, spawnInfo, true);
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
            const player: LocalPlayer = ZepetoPlayers.instance.LocalPlayer;
        });
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { SpawnInfo, ZepetoPlayers, LocalPlayer, ZepetoCharacter } from 'ZEPETO.Character.Controller';
import { WorldService } from 'ZEPETO.World';
import { Quaternion, Vector3 } from 'UnityEngine';

export default class CharacterController extends ZepetoScriptBehaviour {

    Start() {
        // Atur Posisi Spawn Karakter
        const spawnInfo = new SpawnInfo();
        spawnInfo.position = new Vector3(0,2,0);
        // Atur Rotasi Spawn Karakter
        spawnInfo.rotation = Quaternion.Euler(0,0,0);

        // Ambil id pengguna yang ditentukan dari login ke zepeto melalui editor.
        ZepetoPlayers.instance.CreatePlayerWithUserId(WorldService.userId, spawnInfo, true);
        ZepetoPlayers.instance.OnAddedLocalPlayer.AddListener(() => {
            const player: LocalPlayer = ZepetoPlayers.instance.LocalPlayer;
        });
    }
}
﻿
﻿
Gunakan tombol Putar di tengah layar untuk memeriksa pembuatan karakter.
﻿
﻿
Jika Anda mengubah nilai posisi dan orientasi, Anda juga dapat membuat karakter berbaring seperti ini.
Contoh SpawnInfo
// Atur Posisi Spawn Karakter
const spawnInfo = new SpawnInfo();
spawnInfo.position = new Vector3(2,1,2);
// Atur Rotasi Spawn Karakter
spawnInfo.rotation = Quaternion.Euler(90,0,0);
// Atur Posisi Spawn Karakter
const spawnInfo = new SpawnInfo();
spawnInfo.position = new Vector3(2,1,2);
// Atur Rotasi Spawn Karakter
spawnInfo.rotation = Quaternion.Euler(90,0,0);
﻿
﻿
﻿