Papan Peringkat

19min
Mengatur papan peringkat
Papan peringkat adalah modul yang menyediakan fungsi untuk menyimpan dan mengelola peringkat dan skor tertinggi setiap pemain.
﻿
LANGKAH 1 : Buat Papan Peringkat
Untuk membuat papan peringkat, pilih tombol [Dapatkan Informasi Papan Peringkat] di menu ProjectSettings → Zepeto → ZepetoLeaderboard.
﻿
﻿
Pilih [Tambahkan Papan Peringkat] untuk menambahkan papan peringkat baru.
Jika ada papan peringkat yang sudah ada, papan peringkat tersebut akan muncul di layar pengaturan.
﻿
﻿
LANGKAH 2 : Sesuaikan Papan Peringkat
Jendela pop up yang ditunjukkan di bawah ini akan muncul ketika tombol [Tambahkan Papan Peringkat] dipilih. Anda akan dapat menyesuaikan nilai setiap parameter.
﻿
Parameter
Deskripsi
Nama
Nama papan peringkat
Aturan Pembaruan
Aturan pembaruan skor
Skor maksimum
Catat skor tertinggi pengguna
Skor minimum
Catat skor terendah pengguna
Akumulasi skor
Tambahkan skor pengguna dan simpan sebagai catatan
ResetInfo(s)
Anda dapat mengatur periode untuk mereset skor.
- Ini berguna jika papan peringkat perlu diperbarui setiap musim.
- Skor tidak akan direset secara default, tetapi Anda dapat melakukan penyesuaian dengan mengatur periode reset (bulanan, mingguan, harian).
LANGKAH 3 : Atur reset skor
﻿
﻿
Aturan reset skor adalah sebagai berikut:
Periode
Deskripsi
Tidak ada
Skor tidak akan direset
Hari
Skor akan direset setiap hari pada waktu yang ditentukan (mis. peringkat harian)
Minggu
Skor akan direset setiap minggu pada tanggal dan waktu yang ditentukan (mis: peringkat mingguan)
Bulan
Skor akan direset setiap bulan pada tanggal dan waktu yang ditentukan (mis: peringkat bulanan; nilai Hari maksimum adalah 31, tetapi jika bulan tidak memiliki 31 hari, itu akan secara otomatis disesuaikan dengan hari terakhir bulan tersebut)
﻿
LANGKAH 4 : ID Papan Peringkat
Untuk menggunakan ZEPETOScript dan papan peringkat, Anda harus memiliki informasi ID Papan Peringkat.
Untuk mengakses informasi Papan Peringkat, Anda dapat pergi ke Pengaturan (di bawah Edit di menu Pengaturan Proyek, pergi ke Zepeto → Papan Peringkat Zepeto → Edit), atau memuat dari api ZEPETOScript.
📘 Silakan merujuk ke panduan berikut. [Mencari Detail Papan Peringkat﻿]
﻿
﻿
Setelah aturan reset ditetapkan, papan peringkat tidak dapat dimodifikasi.
Untuk mengubah Aturan Reset, Anda harus membuat papan peringkat baru.
Waktu reset berdasarkan UTC+0. Offset akan disediakan sehingga zona waktu dapat diubah di masa depan.
﻿
Merekam Skor
LeaderboardAPI.SetScore() adalah API yang mencatat skor pengguna di papan peringkat.
ID papan peringkat, nilai skor, titik penyelesaian, dan titik kesalahan diteruskan sebagai argumen.
Informasi pengguna untuk skor akan secara otomatis disimpan.
Berikut adalah contoh untuk memuat fungsi LeaderboardAPI.SetScore.
TypeScript
LeaderboardAPI.SetScore(this.leaderBoardId, this.score, this.OnResult, this.OnError);
LeaderboardAPI.SetScore(this.leaderBoardId, this.score, this.OnResult, this.OnError);
﻿
﻿
Berikut adalah template kode untuk mengambil skor pengguna ke papan peringkat.
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { SetScoreResponse, LeaderboardAPI } from 'ZEPETO.Script.Leaderboard';

export default class SetScoreExample extends ZepetoScriptBehaviour {

    public leaderboardId: string;
    public score: number;

    Start() {
        LeaderboardAPI.SetScore(this.leaderboardId, this.score, this.OnResult, this.OnError);
    }

    OnResult(result: SetScoreResponse) {
        console.log(`result.isSuccess: ${result.isSuccess}`);
    }

    OnError(error: string) {
        console.error(error);
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { SetScoreResponse, LeaderboardAPI } from 'ZEPETO.Script.Leaderboard';

export default class SetScoreExample extends ZepetoScriptBehaviour {

    public leaderboardId: string;
    public score: number;

    Start() {
        LeaderboardAPI.SetScore(this.leaderboardId, this.score, this.OnResult, this.OnError);
    }

    OnResult(result: SetScoreResponse) {
        console.log(`result.isSuccess: ${result.isSuccess}`);
    }

    OnError(error: string) {
        console.error(error);
    }
}
﻿
﻿
Mencari Detail Peringkat
Dapatkan informasi peringkat dalam rentang tertentu
Gunakan fungsi LeaderboardAPI.GetRangeRank() untuk memuat rentang tertentu dari detail peringkat.
Nilai Boolean untuk mengambil ID papan peringkat, peringkat awal, peringkat terakhir, aturan reset dan informasi peringkat musim terakhir, serta fungsi callback dari waktu penyelesaian dan waktu terjadinya kesalahan diteruskan sebagai argumen.
Informasi pengguna yang menanyakan informasi peringkat secara otomatis dimasukkan, dan hingga 100 informasi peringkat dapat diproses per pertanyaan (mis: paging dalam format 1100, 101200 untuk implementasi)
❗️ Peringatan
Jika lebih dari 100 data dimuat sekaligus, mungkin tidak berfungsi dengan baik karena masalah beban API dan batasan laju.
﻿
Contoh panggilan fungsi
Contoh pemanggilan fungsi LeaderboardAPI.GetRangeRank() adalah sebagai berikut:
TypeScript
LeaderboardAPI.GetRangeRank(this.leaderboardId, this.startRank, this.endRank, this.resetRule, false, this.OnResult, this.OnError);
LeaderboardAPI.GetRangeRank(this.leaderboardId, this.startRank, this.endRank, this.resetRule, false, this.OnResult, this.OnError);
﻿
Kode berikut adalah contoh untuk memuat rentang tertentu dari informasi peringkat.
Anda dapat menggunakan nilai Member dari OnResult untuk memuat foto profil.
﻿
📘 Silakan merujuk ke panduan berikut. [Informasi Pengguna﻿]
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { GetRangeRankResponse, LeaderboardAPI, ResetRule } from 'ZEPETO.Script.Leaderboard';

export default class GetRangeRankExample extends ZepetoScriptBehaviour {

    public leaderboardId: string;
    public startRank: number;
    public endRank: number;
    public resetRule: ResetRule;

    Start() {
        LeaderboardAPI.GetRangeRank(this.leaderboardId, this.startRank, this.endRank, this.resetRule, false, 
            this.OnResult, this.OnError);
    }

    OnResult(result: GetRangeRankResponse) {
        console.log(`result.isSuccess: ${result.isSuccess}`);
        if (result.rankInfo.myRank) {
            console.log(`member: ${result.rankInfo.myRank.member}, rank: ${result.rankInfo.myRank.rank}, 
			            score: ${result.rankInfo.myRank.score}, name: ${result.rankInfo.myRank.name}`);
        }

        if (result.rankInfo.rankList) {
            for (let i = 0; i < result.rankInfo.rankList.length; ++i) {
                const rank = result.rankInfo.rankList.get_Item(i);
                console.log(`i: ${i}, member: ${rank.member}, rank: ${rank.rank}, score: ${rank.score}, name: ${rank.name}`);
            }
        }
    }

    OnError(error: string) {
        console.error(error);
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { GetRangeRankResponse, LeaderboardAPI, ResetRule } from 'ZEPETO.Script.Leaderboard';

export default class GetRangeRankExample extends ZepetoScriptBehaviour {

    public leaderboardId: string;
    public startRank: number;
    public endRank: number;
    public resetRule: ResetRule;

    Start() {
        LeaderboardAPI.GetRangeRank(this.leaderboardId, this.startRank, this.endRank, this.resetRule, false, 
            this.OnResult, this.OnError);
    }

    OnResult(result: GetRangeRankResponse) {
        console.log(`result.isSuccess: ${result.isSuccess}`);
        if (result.rankInfo.myRank) {
            console.log(`member: ${result.rankInfo.myRank.member}, rank: ${result.rankInfo.myRank.rank}, 
			            score: ${result.rankInfo.myRank.score}, name: ${result.rankInfo.myRank.name}`);
        }

        if (result.rankInfo.rankList) {
            for (let i = 0; i < result.rankInfo.rankList.length; ++i) {
                const rank = result.rankInfo.rankList.get_Item(i);
                console.log(`i: ${i}, member: ${rank.member}, rank: ${rank.rank}, score: ${rank.score}, name: ${rank.name}`);
            }
        }
    }

    OnError(error: string) {
        console.error(error);
    }
}
﻿
﻿
﻿
Mencari Detail Papan Peringkat
Cari Semua Papan Peringkat
Gunakan fungsi LeaderboardAPI.GetAllLeaderboards untuk memuat semua informasi papan peringkat di Dunia yang ditentukan.
Fungsi callback dari waktu penyelesaian hingga waktu terjadinya kesalahan diteruskan sebagai argumen.
Contoh pemuatan fungsi LeaderboardAPI.GetAllLeaderboards adalah sebagai berikut:
TypeScript
LeaderboardAPI.GetAllLeaderboards(this.OnResult, this.OnError);
LeaderboardAPI.GetAllLeaderboards(this.OnResult, this.OnError);
﻿
﻿
Berikut adalah contoh untuk memuat informasi seluruh papan peringkat.
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { GetAllLeaderboardsResponse, LeaderboardAPI } from 'ZEPETO.Script.Leaderboard';

export default class GetAllLeaderboardExample extends ZepetoScriptBehaviour {

    Start() {
        LeaderboardAPI.GetAllLeaderboards(this.OnResult, this.OnError);
    }

    OnResult(result: GetAllLeaderboardsResponse) {
        console.log(`result.isSuccess: ${result.isSuccess}`);

        if (result.leaderboards) {
            for (let i = 0; i < result.leaderboards.length; ++i) {
                const leaderboard = result.leaderboards[i];
                console.log(`i: ${i}, id: ${leaderboard.id}, name: ${leaderboard.name}`);
            }
        }
    }

    OnError(error: string) {
        console.error(error);
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { GetAllLeaderboardsResponse, LeaderboardAPI } from 'ZEPETO.Script.Leaderboard';

export default class GetAllLeaderboardExample extends ZepetoScriptBehaviour {

    Start() {
        LeaderboardAPI.GetAllLeaderboards(this.OnResult, this.OnError);
    }

    OnResult(result: GetAllLeaderboardsResponse) {
        console.log(`result.isSuccess: ${result.isSuccess}`);

        if (result.leaderboards) {
            for (let i = 0; i < result.leaderboards.length; ++i) {
                const leaderboard = result.leaderboards[i];
                console.log(`i: ${i}, id: ${leaderboard.id}, name: ${leaderboard.name}`);
            }
        }
    }

    OnError(error: string) {
        console.error(error);
    }
}
﻿
﻿
﻿
Cari Papan Peringkat Spesifik
Gunakan fungsi LeaderboardAPI.GetLeaderboards untuk memuat informasi papan peringkat tertentu.
Fungsi callback untuk ID papan peringkat, waktu penyelesaian, dan waktu terjadinya kesalahan diteruskan sebagai argumen.
Contoh memuat fungsi LeaderboardAPI.GetLeaderboard adalah sebagai berikut:
TypeScript
LeaderboardAPI.GetLeaderboard(this.leaderboardId, this.OnResult, this.OnError);
LeaderboardAPI.GetLeaderboard(this.leaderboardId, this.OnResult, this.OnError);
﻿
﻿
Berikut adalah contoh untuk memuat informasi papan peringkat tertentu.
TypeScript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { GetLeaderboardResponse, LeaderboardAPI } from 'ZEPETO.Script.Leaderboard';

export default class GetLeaderboardExample extends ZepetoScriptBehaviour {

    public leaderboardId: string;

    Start() {
        LeaderboardAPI.GetLeaderboard(this.leaderboardId, this.OnResult, this.OnError);
    }
    
    OnResult(result: GetLeaderboardResponse) {
        console.log(`result.isSuccess: ${result.isSuccess}`);

        if (result.leaderboard) {
            console.log(`id: ${result.leaderboard.id}, name: ${result.leaderboard.name}`);
        }
    }

    OnError(error: string) {
        console.error(error);
    }
}
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { GetLeaderboardResponse, LeaderboardAPI } from 'ZEPETO.Script.Leaderboard';

export default class GetLeaderboardExample extends ZepetoScriptBehaviour {

    public leaderboardId: string;

    Start() {
        LeaderboardAPI.GetLeaderboard(this.leaderboardId, this.OnResult, this.OnError);
    }
    
    OnResult(result: GetLeaderboardResponse) {
        console.log(`result.isSuccess: ${result.isSuccess}`);

        if (result.leaderboard) {
            console.log(`id: ${result.leaderboard.id}, name: ${result.leaderboard.name}`);
        }
    }

    OnError(error: string) {
        console.error(error);
    }
}
﻿
﻿
﻿
Contoh Penggunaan Papan Peringkat
Berikut adalah contoh papan peringkat yang diterapkan pada ZEPETO World Slime Party resmi.
Dengan mengatur, membaca, dan memanfaatkan panggilan API untuk mengambil peringkat dalam rentang tertentu, Anda dapat menyusunnya sebagai berikut di UI.
﻿
﻿
Parameter	Deskripsi
Nama	Nama papan peringkat
Aturan Pembaruan	Aturan pembaruan skor
Skor maksimum	Catat skor tertinggi pengguna
Skor minimum	Catat skor terendah pengguna
Akumulasi skor	Tambahkan skor pengguna dan simpan sebagai catatan
ResetInfo(s)	Anda dapat mengatur periode untuk mereset skor. - Ini berguna jika papan peringkat perlu diperbarui setiap musim. - Skor tidak akan direset secara default, tetapi Anda dapat melakukan penyesuaian dengan mengatur periode reset (bulanan, mingguan, harian).
Periode	Deskripsi
Tidak ada	Skor tidak akan direset
Hari	Skor akan direset setiap hari pada waktu yang ditentukan (mis. peringkat harian)
Minggu	Skor akan direset setiap minggu pada tanggal dan waktu yang ditentukan (mis: peringkat mingguan)
Bulan	Skor akan direset setiap bulan pada tanggal dan waktu yang ditentukan (mis: peringkat bulanan; nilai Hari maksimum adalah 31, tetapi jika bulan tidak memiliki 31 hari, itu akan secara otomatis disesuaikan dengan hari terakhir bulan tersebut)
Diperbarui 11 Oct 2024
Apakah halaman ini membantu Anda?
SEBELUMNYA
Informasi Pengguna
BERIKUTNYA
Kirim API Pesan Langsung