---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.0
alternate:
  - https://yandex.com.tr/dev/games/doc/en/sdk/defold/leaderboard.md
  - https://yandex.com.tr/dev/games/doc/hi/sdk/defold/leaderboard.md
  - https://yandex.com.tr/dev/games/doc/ko/sdk/defold/leaderboard.md
  - https://yandex.com.tr/dev/games/doc/ru/sdk/defold/leaderboard.md
  - https://yandex.com.tr/dev/games/doc/tr/sdk/defold/leaderboard.md
  - https://yandex.com.tr/dev/games/doc/vi/sdk/defold/leaderboard.md
  - https://yandex.com.tr/dev/games/doc/zh/sdk/defold/leaderboard.md
  - href: https://yandex.com.tr/dev/games/doc/tr/sdk/defold/leaderboard.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

# Skor tabloları

<!-- 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 -->

<!-- source: tr/_includes/sdk/common-with-plugins.md -->
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.
<!-- endsource: tr/_includes/sdk/common-with-plugins.md -->

Aşağıda açıklanan isteklerin çalışması için aşağıdaki koşulların sağlandığını doğrulayın:

- [SDK'yı etkinleştirdiniz ve yapılandırdınız](https://yandex.com.tr/dev/games/doc/tr/sdk/sdk-about.md#use) ve nesnesi `ysdk` değişkeni üzerinden erişilebilir durumda;
- Geliştirici konsolunda skor tablosu [oluşturulmuştur](https://yandex.com.tr/dev/games/doc/tr/concepts/leaderboards.md).

<!-- source: tr/_includes/sdk/common-with-plugins.md -->
{% 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 %}
<!-- endsource: tr/_includes/sdk/common-with-plugins.md -->

## Skor tablosu açıklaması {#leaderboard-description}

Skor tablosu açıklamasını adına göre almak için `ysdk.leaderboards.get_description()` yöntemini kullanın:

```lua showLineNumbers
ysdk.leaderboards.get_description(
    leaderboard_name: string,
    callback: function
)
```

`callback: function` — çağrılan yöntemin işleyicisi. Şu şekilde olur:

```lua
function(self, description: table|nil): nil
```

- `description: table` — lider tablosunun açıklaması. Şu özellikleri içerir:

```lua showLineNumbers
description: {
    app_id: string,
    default: boolean,
    invert_sort_order: boolean,
    decimal_offset: integer,
    type: string,
    name: string,
    title: {
        en: string,
        ru: string
    }
}
```

**Örnek**

```lua showLineNumbers
function display_leaderboard()
    ysdk.leaderboards.get_description("highscores",
        function (self, description)
            if description then
                print(
                    description.name,
                    description.title.en
                )
            end
        end)
end
```

## Yeni sonuç {#new-score}

{% note alert %}

Sadece yetkilendirilmiş kullanıcılar için bu istek geçerlidir. Gerekirse [yetkilendirmeyi](https://yandex.com.tr/dev/games/doc/tr/sdk/defold/player-data.md#auth) kullanın.

{% endnote %}

Oyuncunun yeni skorunu ayarlamak için `ysdk.leaderboards.set_score()` yöntemini kullanın:

```lua showLineNumbers
ysdk.leaderboards.set_score(
    leaderboard_name: string,
    score: integer,
    extraData: string|nil
)
```

{% note info %}

<!-- source: tr/_includes/sdk/common-with-plugins.md -->
İstek 1 saniyede en fazla 1 kez gönderilebilir; aksi takdirde hata ile reddedilir.
<!-- endsource: tr/_includes/sdk/common-with-plugins.md -->

{% endnote %}

## Puan alınması {#getting-ranking}

{% note alert %}

Sorgu yalnızca yetkilendirilmiş kullanıcılar için kullanılabilir. Gerekirse [yetkilendirmeyi](https://yandex.com.tr/dev/games/doc/tr/sdk/defold/player-data.md#auth) kullanın.

{% endnote %}

Kullanıcı puanını almak için `ysdk.leaderboards.get_player_entry()` yöntemini kullanın:

```lua showLineNumbers
ysdk.leaderboards.get_player_entry(
    leaderboard_name: string,
    callback: function
)
```

`callback: function` — çağrılan metodun işleyicisi. Şu şekildedir:

```lua
function(self, player_entry: table|nil): nil
```

- `player_entry: table` — kullanıcının sıralaması. Şu özellikleri içerir:

```lua showLineNumbers
player_entry: {
    score: integer,
    extraData: string,
    rank: integer,
    avatar_src: {
        small: string,
        medium: string,
        large: string
    },
    avatar_srcset: {
        small: string,
        medium: string,
        large: string
    },
    lang: string,
    public_name: string,
    unique_id: string,
    formatted_score: string
}
```

**Örnek**

```lua showLineNumbers
function display_high_score()
    ysdk.leaderboards.get_player_entry("highscores",
        function (self, player_entry)
            if player_entry then
                print("highscore: " .. player_entry.score)
            end
        end)
end
```

## Skor tablosu kayıtları {#leaderboard-entries}

Kullanıcı sıralamasını çıkarmak için `ysdk.leaderboards.get_entries()` yöntemini kullanın:

```lua showLineNumbers
ysdk.leaderboards.get_entries(
    leaderboardName: string,
    callback: function,
    options: {
        include_user: boolean|nil,
        quantity_around: number|nil,
        quantity_top: number|nil
    }
)
```

`callback: function` — çağrılan metodun işleyicisi. Şu şekilde görünür:

```lua
function(self, entries: table|nil): nil
```

`entries: table` — kullanıcı sıralaması. Şu özellikleri içerir:

```lua showLineNumbers
entries: {
    leaderboard: {
        ...
    },
    ranges: [
        {
            start: integer,
            size: integer
        }
    ],
    userRank: integer,
    entries: [
        {
            score: integer,
            extraData: string,
            rank: integer,
            avatar_src: {
                small: string,
                medium: string,
                large: string
            },
            avatar_srcset: {
                small: string,
                medium: string,
                large: string
            },
            lang: string,
            public_name: string,
            unique_id: string,
            formatted_score: string
        },
        ...
    ]
}
```

---


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