--- metadata: - name: generator content: Diplodoc Platform v5.66.0 alternate: - https://yandex.com.tr/dev/games/doc/en/sdk/construct-3/leaderboards.md - https://yandex.com.tr/dev/games/doc/hi/sdk/construct-3/leaderboards.md - https://yandex.com.tr/dev/games/doc/ko/sdk/construct-3/leaderboards.md - https://yandex.com.tr/dev/games/doc/ru/sdk/construct-3/leaderboards.md - https://yandex.com.tr/dev/games/doc/tr/sdk/construct-3/leaderboards.md - https://yandex.com.tr/dev/games/doc/vi/sdk/construct-3/leaderboards.md - https://yandex.com.tr/dev/games/doc/zh/sdk/construct-3/leaderboards.md - href: https://yandex.com.tr/dev/games/doc/tr/sdk/construct-3/leaderboards.md type: text/markdown title: Markdown version - href: https://yandex.com.tr/dev/games/doc/tr/llms.txt?revision=r21993288 rel: describedby --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/games/doc/tr/llms.txt?revision=r21993288 # 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ş](https://yandex.com.tr/dev/games/doc/tr/concepts/leaderboards.md#create) bir liderlik tablosu olduğunu doğrulayın. {% note alert %} [Konsolda](https://games.yandex.com/console){.external} **Technical leaderboard name** alanında karşılık gelen ada sahip bir lider tablosu yoksa, istekler 404 hatası döndürür. {% endnote %} ## Puan gönderme {#set-score} {% note alert %} İ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".](../../_images/construct-3/leaderboards/player-pre-auth.webp) {% endnote %} 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".](../../_images/construct-3/leaderboards/set-score.webp) {% note info %} İstek 1 saniyede en fazla 1 kez gönderilebilir; aksi takdirde hata ile reddedilir. Puan gönderimini [gecikmeli olay](https://yandex.com.tr/dev/games/doc/tr/sdk/construct-3/throttle-debounce.md) 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".](../../_images/construct-3/leaderboards/debounce.webp) {% endnote %} ## Lider panosu kayıtları {#get-leaderboard} 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. {% note warning %} Bu döngünün sürekli çağrılmadığından emin olun. Bunu işlevler veya tetikleyiciler içinde kullanmanız önerilir. {% endnote %} ![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.](../../_images/construct-3/leaderboards/request-leaderboard.webp) 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ı.](../../_images/construct-3/leaderboards/expressions.webp) --- Depo