Lider panoları

Oyun sayfasında, en iyi oyuncuların sonuçlarını ve yetkili kullanıcının sıralamadaki yerini gösteren kişiselleştirilmiş lider tabloları gösterebilirsiniz.

Aşağıda açıklanan isteklerin çalışması için Geliştirici Konsolu'nda oluşturulmuş bir liderlik tablosu olduğunu doğrulayın.

Dikkat

Konsolda Technical leaderboard name alanında karşılık gelen ada sahip bir lider tablosu yoksa, istekler 404 hatası döndürür.

Puan gönderme

Dikkat

İstek yalnızca giriş yapmış kullanıcılar için kullanılabilir. Önceden yetkilendirme talep etmeniz ve liderlik tablolarını yalnızca kullanıcı kişisel verilerini sağladıysa kullanmanız önerilir.

Construct 3 ekran görüntüsü: YandexGamesSDK eklentisini kullanarak liderlik tabloları ayar ekranı. Üç sütunlu tablo (üçüncü sütunun her hücresinde "+ Eylem Ekle" ve "+ Ekle..." düğmeleri vardır) ve üç satır. 1. satır — "Sistem" ayarlar simgesi, "Bir kez çalıştır", "Yan... | Oyuncu hakkında bilgi iste. Kişisel veriler: False". 2. satır — "YandexGames…", "Oyuncu bilgileri yüklendi", boş hücre. 3. satır — "YandexGames…", "Oyuncu yetkilendirildi", "Sis..." ayarlar simgesi. | authorized değerini True olarak ayarla".

Yeni bir skoru liderlik tablosuna göndermek için Set leaderboard score eylemini şu parametrelerle kullanın:

Parametre

Tür

Açıklama

Name

string

Lider panosunun teknik adı.

Score

number

Oyuncunun lider panosundaki puanı.

Additional data

string

Puanla birlikte gönderilen isteğe bağlı meta veriler.

Örneğin, liderlik tablosuna skor gönderme şu şekilde görünebilir:

Construct 3 ekran görüntüsü: YandexGamesSDK eklentisini kullanarak liderlik tabloları ayar ekranı. Üç sütunlu tablo (üçüncü sütunun her hücresinde "+ Eylem Ekle" ve "+ Ekle..." düğmeleri vardır) ve iki satır. 1. satır — "Düğme", "Tıklandığında", boş hücre. 2. satır — "Sistem" ayarlar simgesi, "authorized doğru", "Yan... | "score" liderlik tablosuna "" verileriyle 10 skorunu gönder".

Not

İstek 1 saniyede en fazla 1 kez gönderilebilir; aksi takdirde hata ile reddedilir.

Puan gönderimini gecikmeli olay ile kullanmanız önerilir.

Construct 3 ekran görüntüsü: YandexGamesSDK eklentisini kullanarak liderlik tabloları ayar ekranı. Üç sütunlu tablo (üçüncü sütunun her hücresinde "+ Eylem Ekle" ve "+ Ekle..." düğmeleri vardır) ve üç satır. 1. satır — "Düğme", "Tıklandığında", "Yan... | setScore olayını 1 saniye ertele". 2. satır — "YandexGames…", ""setScore" ertelenmiş olayına", boş hücre. 3. satır — "Sistem" ayarlar simgesi, "authorized doğru", "Yan... | "score" liderlik tablosuna "" verileriyle 10 skorunu gönder".

Lider panosu kayıtları

Liderlik tablosuyla ç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 şu parametreleri kabul eder:

Parametre

Tür

Açıklama

Name

string

Lider panosunun teknik adı.

Top positions

number

Lider panosunun üstünden istenen kayıt sayısı.

Request player position

boolean

Kullanıcı konumunun istenip istenmediğini belirler.

Positions around the player's position

number

Tabloda kullanıcının altında ve üstünde istenen kayıt sayısı.

Eklenti, Yandex Oyun SDK'sı aracılığıyla liderlik tablosu verilerini ister ve istek başarılı olursa bir döngü başlar. 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 çağrılmadığından emin olun. Bunu işlevler veya tetikleyiciler içinde kullanmanız önerilir.

Construct 3 ekran görüntüsü: YandexGamesSDK eklentisini kullanarak liderlik tabloları ayar ekranı. Üç sütunlu tablo (üçüncü sütunun her hücresinde "+ Eylem Ekle" ve "+ Ekle..." düğmeleri vardır) ve 4 satır. 1. satır — "Sistem" ayarlar simgesi, "Bir kez çalıştır", "Yan... | "score" liderlik tablosunu iste. İlk 5: 5, kullanıcı: True, çevresinde: 5. 2. satır — "YandexGames…", ""score" lider tablosu yüklendi. İlk 5: 5, kullanıcı: True, çevresinde: 5.", boş hücre. 3. satır — "YandexGames…", "Geçerli lider tablosundaki her oyuncu için", "Sis..." ayarlar simgesi. | currentUsernameInLeaderboard değerini YandexGamesSDK.Geçerli oyuncunun liderlik tablosundaki adı olarak ayarla". 4. satır — "YandexGames…", ""score" lider tablosu yüklenirken hata oluştu. İlk 5: 5, kullanıcı: True, çevresinde: 5.", boş hücre.

Döngü içinde Leaderboards listesindeki ifadelere erişebilirsiniz.

Construct 3 ekran görüntüsü: ekranın sol üst kısmında "Liderlik tabloları" yazısı. Altında iki sütunlu ve 14 satırlı bir tablo. 1. satır: Geçerli oyuncunun lider tablosundaki avatarı | dize, oyuncunun avatarına bağlantı. Avatar erişimi yoksa "" değerine eşit olabilir. 2. satır: Geçerli oyuncunun lider tablosundaki büyük avatarı | dize, oyuncunun büyük avatarına bağlantı. 3. satır: Geçerli oyuncunun lider tablosundaki ek verileri | skorla birlikte gönderilen isteğe bağlı meta veriler. 4. satır: Geçerli oyuncunun lider tablosundaki adı | dize, oyuncunun adı. İsme erişim yoksa "" değerine eşit olabilir. 5. satır: Lider tablosunda istenen aralığın indeksi | lider tablosundan konumlar istendiğinde değerlerden oluşan birden fazla aralık oluşabilir. 6. satır: Geçerli oyuncunun lider tablosundaki küçük avatarı | dize, oyuncunun küçük avatarına bağlantı. 7. satır: Lider tablosunun adı | lider tablosunun yerelleştirilmiş adı. 8. satır: Geçerli oyuncunun lider tablosundaki konumu | tüm oyuncuların skorlarının karşılaştırılmasıyla elde edilen konum. 9. satır: Lider tablosunun ondalık nokta kayması | skorun ondalık kısmının boyutu. Örneğin, decimal_offset: 2 olduğunda 1234 sayısı 12.34 olarak görüntülenir. 10. satır: Geçerli oyuncunun lider tablosundaki orta avatarı | dize, oyuncunun orta avatarına bağlantı. 11. satır: Geçerli oyuncunun lider tablosundaki skoru | oyuncunun oyun sürecinde kazandığı skor. 12. satır: Lider tablosunun teknik adı | dize, lider tablosunun teknik adı (kullanıcılara gösterilmek için tasarlanmamıştır). 13. satır: Lider tablosunun türü | oyuncunun lider tablosundaki skor türü. Olası değerler: numeric (sayı), time (saniye). 14. satır: Geçerli oyuncunun lider tablosundaki benzersiz tanımlayıcısı | dize, oyuncunun benzersiz tanımlayıcısı.


Depo