Lider panoları
Oyun sayfasında kişiselleştirilmiş lider panolarını (en iyi oyuncuların sonuçlarını ve yetkilendirilmiş kullanıcının sırasını gösteren tablolar) gösterebilirsiniz.
Aşağıda açıklanan isteklerin çalışması için, Geliştirici Konsolunda bir lider panosu oluşturduğunuzu kontrol edin.
Puan gönderme
Not
İstek yalnızca yetkilendirilmiş kullanıcılar için kullanılabilir. Lider panolarını kullanmadan önce yetkilendirme işlemini gerçekleştirmek ve kullanıcının kişisel verileri sağlamasını istemek önerilir.
Lider panosuna yeni bir puan göndermek için Set leaderboard score eylemini aşağıdaki parametrelerle kullanın:
Parametre |
Tür |
Açıklama |
Name |
|
Lider panosunun teknik adı. |
Score |
|
Oyuncunun lider panosundaki puanı. |
Additional data |
|
Puanla birlikte gönderilen isteğe bağlı meta veriler. |
Örneğin, lider panosuna puan göndermek şöyle görünebilir:
Not
İstek, saniyede bir kezden daha sık gönderilemez, aksi takdirde hatayla reddedilecektir.
Puan gönderimini gecikmeli olay ile kullanmanız önerilir.
Lider panosu kayıtları
Lider panosu ile çalışmaya başlamak için Fetch leaderboard eylemini Leaderboard is successfully fetched ve Failure to fetch leaderboard tetikleyici koşullarıyla birlikte kullanın. Eylem ve koşullar aşağıdaki parametreleri kabul eder:
Parametre |
Tür |
Açıklama |
Name |
|
Lider panosunun teknik adı. |
Top positions |
|
Lider panosunun üstünden istenen kayıt sayısı. |
Request player position |
|
Kullanıcı konumunun istenip istenmediğini belirler. |
Positions around the player's position |
|
Tabloda kullanıcının altında ve üstünde istenen kayıt sayısı. |
Eklenti, Yandex Oyunlar SDK'sı aracılığıyla lider panosu verilerini isteyecek ve başarılı bir istek sonrasında bir döngü başlayacaktır. Bu işlem biraz zaman alır.
İşlem devam ederken ekranda bir yükleme göstergesi bırakmanız önerilir.
Önemli
Bu döngünün sürekli olarak çağrılmadığından emin olun. Fonksiyonlar veya tetikleyiciler içinde kullanmanız önerilir.
Döngü içinde Leaderboards listesinden ifadelere erişiminiz olacak.