---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.4
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: tr/sdk/construct-3/leaderboards.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/games/doc/tr/llms.txt

# Lider panoları

<!-- source: tr/_includes/script-common.md -->
<!-- source: tr/_includes/script/index-js.md -->

<!-- endsource: tr/_includes/script/index-js.md -->

<!-- source: tr/_includes/script/requirements-js.md -->

<!-- endsource: tr/_includes/script/requirements-js.md -->

<!-- source: tr/_includes/script/image-modal-js.md -->

<!-- endsource: tr/_includes/script/image-modal-js.md -->
<!-- endsource: tr/_includes/script-common.md -->

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](https://yandex.com.tr/dev/games/doc/tr/sdk/sdk-leaderboard.md) oluşturduğunuzu kontrol edin.



## Puan gönderme {#set-score}

{% note info %}

İ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.

![](../../_images/construct-3/leaderboards/player-pre-auth.webp)

{% endnote %}

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** | `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, lider panosuna puan göndermek şöyle görünebilir:

![](../../_images/construct-3/leaderboards/set-score.webp)

{% note info %}

İstek, saniyede bir kezden daha sık gönderilemez, aksi takdirde hatayla reddedilecektir.

Puan gönderimini [gecikmeli olay](https://yandex.com.tr/dev/games/doc/tr/sdk/construct-3/throttle-debounce.md) ile kullanmanız önerilir.

![](../../_images/construct-3/leaderboards/debounce.webp)

{% endnote %}



## Lider panosu kayıtları {#get-leaderboard}

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** | `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 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.

{% note warning %}

Bu döngünün sürekli olarak çağrılmadığından emin olun. Fonksiyonlar veya tetikleyiciler içinde kullanmanız önerilir.

{% endnote %}

![](../../_images/construct-3/leaderboards/request-leaderboard.webp)

Döngü içinde **Leaderboards** listesinden ifadelere erişiminiz olacak.

![](../../_images/construct-3/leaderboards/expressions.webp)


---


<!-- source: tr/_includes/button-git.md -->
<a href="https://github.com/yandex-games-plugins/construct3">
  <span class="button">Depo</span>
</a>
<!-- endsource: tr/_includes/button-git.md -->