Status Ruangan Multiplay

8min

﻿
Ruang Multiplay menyediakan properti State untuk mengelola lokasi pemain atau objek yang terhubung.
Definisi data State dapat dikelola dari file Skema, yang berada di bawah paket multiplay.
Peristiwa onStateChange pertama kali dipanggil ketika klien berhasil membangun koneksi ke ruangan, dan kemudian dipanggil setiap kali ada perubahan pada data state.


API Server
API
Deskripsi
state.SCHEMA_NAME
Anda dapat mengakses field SCHEMA_NAME yang didefinisikan dalam file skema dengan state.

Anda dapat memodifikasi nilai field atas permintaan dari klien atau logika server internal.

State yang berubah kemudian secara otomatis disebarkan ke klien menggunakan peristiwa OnStateChange.
📘 Silakan merujuk ke panduan berikut. [ZEPETO.Multiplay(Server) API]
TypeScript
import { Location } from 'ZEPETO.Multiplay.Schema';

export default class extends Sandbox {
 
   ...
   const location: Location = this.state.playerLocation;
   // Menangani State.
   ...
}
import { Location } from 'ZEPETO.Multiplay.Schema';

export default class extends Sandbox {
 
   ...
   const location: Location = this.state.playerLocation;
   // Menangani State.
   ...
}
﻿
API
Deskripsi
room.OnStateChange(State, isFirst)
Anda dapat mendaftar callback perubahan status saat Anda bergabung ke ruangan.

Anda dapat menerima status seluruh ruangan untuk pertama kalinya, dan hanya status yang berubah yang akan diterima setelahnya.
API Klien
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { Location } from 'ZEPETO.Multiplay.Schema';

export default class SampleClient extends ZepetoScriptBehaviour {

    Start() {
        this.multiplay.RoomJoined += (room: Room) => {
            room.OnStateChange += this.OnStateChange;
        };
    }

    private OnStateChange(state: State, isFirst: boolean) {
        const location: Location = state.playerLocation;
        // Menangani lokasi pemain menggunakan Status yang diperbarui.  
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { Location } from 'ZEPETO.Multiplay.Schema';

export default class SampleClient extends ZepetoScriptBehaviour {

    Start() {
        this.multiplay.RoomJoined += (room: Room) => {
            room.OnStateChange += this.OnStateChange;
        };
    }

    private OnStateChange(state: State, isFirst: boolean) {
        const location: Location = state.playerLocation;
        // Menangani lokasi pemain menggunakan Status yang diperbarui.  
    }
}
﻿
﻿
Tentukan file Skema
Skema adalah struktur data untuk mendefinisikan status saat ini di ruangan. Ruangan terutama digunakan untuk mengelola informasi pemain, lokasi pemain atau objek, dll.
Untuk mengedit skema, Anda dapat memilih Tampilan Proyek → Aset MultiplayPackage → schema.json, dan kemudian mengubah tipe data yang akan digunakan untuk Dunia di jendela Inspektor.
Anda dapat mengubah tipe data yang akan digunakan untuk Dunia di jendela Inspektor.
LANGKAH 1 : Mendefinisikan Tipe Skema
Tipe Skema adalah Struktur Data yang digunakan di Dunia. Di Inspektor → Tipe Skema, tekan tombol [+] dan tambahkan data.
4-4-3-1.gif
﻿
﻿
LANGKAH 2 : Tambahkan Status Ruangan
Status Ruangan adalah Properti yang menunjukkan status terkini dari Ruangan Dunia, dan dinyatakan dalam struktur Skema seperti yang didefinisikan di atas.
Di antara Tipe Skema, pilih tipe Status Ruangan yang akan digunakan sebagai status terkini dari Dunia dan atur sebagai NAMA_SKEMA.
﻿
Contoh Schemas.json
JSON
{
"State" : {"players" : {"map" : "Player"}},
"Player" : {"sessionId" : "string","zepetoUserId" : "string","transform" : "Transform","state" : "number","subState" : "number"},
"Transform" : {"position" : "Vector3","rotation" : "Vector3"},
"Vector3" : {"x" : "number","y" : "number","z" : "number"}
}
{
"State" : {"players" : {"map" : "Player"}},
"Player" : {"sessionId" : "string","zepetoUserId" : "string","transform" : "Transform","state" : "number","subState" : "number"},
"Transform" : {"position" : "Vector3","rotation" : "Vector3"},
"Vector3" : {"x" : "number","y" : "number","z" : "number"}
}
﻿
﻿

API	Deskripsi
state.SCHEMA_NAME	Anda dapat mengakses field SCHEMA_NAME yang didefinisikan dalam file skema dengan state. Anda dapat memodifikasi nilai field atas permintaan dari klien atau logika server internal. State yang berubah kemudian secara otomatis disebarkan ke klien menggunakan peristiwa OnStateChange.

API	Deskripsi
room.OnStateChange(State, isFirst)	Anda dapat mendaftar callback perubahan status saat Anda bergabung ke ruangan. Anda dapat menerima status seluruh ruangan untuk pertama kalinya, dan hanya status yang berubah yang akan diterima setelahnya.

Diperbarui 11 Oct 2024

Apakah halaman ini membantu Anda?

SEBELUMNYA

Proses koneksi ruangan

BERIKUTNYA

Mengakses Alamat IP Multiplay