BUAT DUNIAMU
Bermain Ganda

14min
ZEPETO Multiplay adalah modul yang memungkinkan banyak pengguna untuk terhubung dan bermain di Dunia secara bersamaan.
Ini menyediakan pengembangan server/klien dan lingkungan pengujian lokal.
📘 Contoh Dunia Multiplay Resmi
GitHub: https://github.com/naverz/zepeto-multiplay-example﻿
Tutorial : Tutorial Bermain Ganda﻿﻿
LANGKAH 1 : Instal
Pilih ZEPETO → Server Multiplay di menu [+] di kiri atas panel [Proyek], atau pergi ke Aset → Buat → ZEPETO → Server Multiplay.
﻿
Paket World.multiplay terdiri dari item-item berikut, dan secara otomatis diperbarui saat Dunia diterbitkan.
index.ts: Kode logika utama server
schemas: Struktur Data untuk komunikasi server/klien
﻿
❗️ Peringatan
Hanya satu paket World.multiplay yang dapat dibuat per game.

LANGKAH 2 : Pengaturan
Klik [Buka Pengaturan Dunia] seperti yang ditunjukkan pada gambar di bawah untuk mengatur Pengaturan Dunia.
﻿
﻿
Properti
Deskripsi
Versi
Masukkan versi file Anda untuk didaftarkan.
MaxClients
Atur jumlah maksimum orang yang dapat mengakses ruangan.
Orientasi
Pilih orientasi layar.
Nonaktifkan Undangan
Menonaktifkan fungsi undangan ruangan.
Nonaktifkan Daftar Ruangan
Menonaktifkan kemampuan untuk memeriksa daftar ruangan.
Nonaktifkan Ruangan Pribadi
Menonaktifkan kemampuan untuk membuat ruangan pribadi.
👍 Nonaktifkan Undangan 
Bahkan jika fungsi undangan ruangan dimatikan, Anda dapat mengirim undangan melalui tautan uji.
LANGKAH 3 : Menjalankan Server Uji
ZEPETO Multiplay menyediakan lingkungan server lokal di mana pencipta dapat menguji server/klien selama pengembangan.
Untuk memeriksa tindakan server lokal, pilih menu atas Unity → Jendela → ZEPETO → Server Multiplay untuk membuka jendela status server.
﻿
Klik tombol server di sebelah tombol [▶︎(Play)] di tengah layar editor.
Anda akan melihat log server berikut di panel Status Server.
﻿
LANGKAH 4 : Menghubungkan ke Klien (Menghubungkan ke Server Lokal)
Komponen ZepetoWorldMultiplay adalah Kelas Manajer Multiplay yang digunakan di Sisi Klien.
Buat GameObject di jendela Hierarki, dan tambahkan komponen ZepetoWorldMultiplay.
Komponen ZepetoWorldMultiplay akan secara otomatis terhubung ke Paket Multiplay.
﻿
Klik pada tombol [▶︎(Putar)] di tengah layar Editor untuk melihat log koneksi klien di jendela Log Server.
﻿
Server pengembangan berjalan di localhost(127.0.0.1), dan port diatur saat proyek pertama kali dimuat.
Saat terhubung melalui multi-proyek, atur lingkungan koneksi ke yang berikut
📘 Silakan merujuk ke panduan berikut Mengakses Alamat IP Multiplay﻿  
👍 Setelah Dunia didistribusikan, itu akan berjalan di server ZEPETO.
﻿
LANGKAH 5 : Contoh Komunikasi Server / Klien Default
Mengimplementasikan Logika Server
File index.ts dalam paket World.multiplay adalah kode yang bertanggung jawab untuk logika utama server.
Buka file index.ts, dan tambahkan logika yang dikirim ke klien setelah menerima jenis pesan, echo, dalam acara onCreate().
📘 Silakan merujuk ke panduan berikut [Zepeto.Multiplay(Server) API]﻿
JS
import { Sandbox, SandboxOptions, SandboxPlayer } from 'ZEPETO.Multiplay';
import { Player } from 'ZEPETO.Multiplay.Schema';

export default class extends Sandbox {

    onCreate(options: SandboxOptions) {
        this.onMessage("echo", (client, message) => {
            console.log(`Echo onMessage dari ${client.sessionId}, -> ${message}`);

            // Kirim ke klien saat ini
            client.send("echo", "echo ke pengirim : " + message);

            // Siarkan ke semua klien yang terhubung
            this.broadcast("echo", "echo ke semua : " + message);
        });
    }

    onJoin(client: SandboxPlayer) {
        const player = new Player();
        player.sessionId = client.sessionId;
        player.userId = client.userId;
        const players = this.state.players;

        players.set(client.sessionId, player);

        console.log('onJoin!!!!');
    }

    onLeave(client: SandboxPlayer, consented?: boolean) {

    }
}
import { Sandbox, SandboxOptions, SandboxPlayer } from 'ZEPETO.Multiplay';
import { Player } from 'ZEPETO.Multiplay.Schema';

export default class extends Sandbox {

    onCreate(options: SandboxOptions) {
        this.onMessage("echo", (client, message) => {
            console.log(`Echo onMessage dari ${client.sessionId}, -> ${message}`);

            // Kirim ke klien saat ini
            client.send("echo", "echo ke pengirim : " + message);

            // Siarkan ke semua klien yang terhubung
            this.broadcast("echo", "echo ke semua : " + message);
        });
    }

    onJoin(client: SandboxPlayer) {
        const player = new Player();
        player.sessionId = client.sessionId;
        player.userId = client.userId;
        const players = this.state.players;

        players.set(client.sessionId, player);

        console.log('onJoin!!!!');
    }

    onLeave(client: SandboxPlayer, consented?: boolean) {

    }
}
﻿
Mengimplementasikan Logika Klien
Buat dan tambahkan skrip ZEPETO di GameObject ZepetoWorldMultiplay yang digunakan untuk mengirim/menerima peristiwa server sebagai berikut:
﻿
MultiplaySample.ts
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { ZepetoWorldMultiplay } from 'ZEPETO.World';
import { Room } from 'ZEPETO.Multiplay';

export default class MultiplaySample extends ZepetoScriptBehaviour {

    private _multiplay: ZepetoWorldMultiplay;

    Start() {
        this._multiplay = this.gameObject.GetComponent<ZepetoWorldMultiplay>();

        this._multiplay.RoomJoined += (room: Room) => {
            console.log(`RoomCreated, my session id is ${room.SessionId}`);

            // Kirim pesan ke server
            room.Send("echo", "halo ZEPETO Multiplay");

            // Tambahkan pendengar pesan server
            room.AddMessageHandler("echo", (message) => {
                // Cetak pesan server
                console.log(message);
            });
        };
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { ZepetoWorldMultiplay } from 'ZEPETO.World';
import { Room } from 'ZEPETO.Multiplay';

export default class MultiplaySample extends ZepetoScriptBehaviour {

    private _multiplay: ZepetoWorldMultiplay;

    Start() {
        this._multiplay = this.gameObject.GetComponent<ZepetoWorldMultiplay>();

        this._multiplay.RoomJoined += (room: Room) => {
            console.log(`RoomCreated, my session id is ${room.SessionId}`);

            // Kirim pesan ke server
            room.Send("echo", "halo ZEPETO Multiplay");

            // Tambahkan pendengar pesan server
            room.AddMessageHandler("echo", (message) => {
                // Cetak pesan server
                console.log(message);
            });
        };
    }
}
﻿
📘 Silakan merujuk ke panduan berikut [err] ﻿ 
LANGKAH 6 : Uji Hasil Keluaran
Klik [▶︎(Putar)] di tengah layar Editor untuk menjalankan server/klien. Anda harus melihat contoh pesan tipe 'echo' seperti yang ditunjukkan di bawah ini:
﻿
① Log keluaran saat pesan klien diterima di server.
② Log pesan yang diterima dari server dari klien.

Langkah-langkah pencegahan saat menggunakan kode server
 ❗️ Peringatan
[Penggunaan variabel dalam kode server]
Variabel juga dapat dideklarasikan dalam kode server.
Namun, memori cache yang tersedia di server saat ini terbatas hingga 512KB. (Ini mungkin berubah nanti.)
Jika melebihi 512KB, ruang mungkin akan disembunyikan, jadi harap kembangkan dengan ini dalam pikiran.
[Penggunaan loop dalam kode server]
Batas Waktu Loop ditetapkan selama 2 detik (2000ms) dalam kode server.
Harap pertimbangkan ini saat mengembangkan, karena menggunakan kode yang memblokir atau loop yang berjalan lama dapat menyebabkan program gagal dieksekusi dengan benar karena Batas Waktu Loop.
﻿
Properti	Deskripsi
Versi	Masukkan versi file Anda untuk didaftarkan.
MaxClients	Atur jumlah maksimum orang yang dapat mengakses ruangan.
Orientasi	Pilih orientasi layar.
Nonaktifkan Undangan	Menonaktifkan fungsi undangan ruangan.
Nonaktifkan Daftar Ruangan	Menonaktifkan kemampuan untuk memeriksa daftar ruangan.
Nonaktifkan Ruangan Pribadi	Menonaktifkan kemampuan untuk membuat ruangan pribadi.
Diperbarui 11 Oct 2024
Apakah halaman ini membantu Anda?
SEBELUMNYA
API perpindahan antar dunia
BERIKUTNYA
Ruang Multipemain