#|
|| **पैरामीटर** | **वर्णन** ||
|| `leaderboardName` | लीडरबोर्ड का नाम। ||
|| `score` | स्कोर। केवल `integer` प्रकार ही स्वीकार किया जाता है। 0 से अधिक होना चाहिए। यदि [लीडरबोर्ड का प्रकार](*leaderboardtype) `time` है, तो समय मान को मिलीसेकंड में पास किया जाना चाहिए। ||
|| `extraData` | उपयोगकर्ता का वर्णन। वैकल्पिक। ||
|#
{% note info "नोट" %}
अनुरोध प्रति सेकंड एक बार से ज़्यादा नहीं भेजे जा सकते। अन्यथा, वे एक त्रुटि के साथ अस्वीकृत कर दिए जाएँगे।
{% endnote %}
{% list tabs %}
* उदाहरण अनुरोध
```javascript
// extraData के बिना
ysdk.leaderboards.setScore('leaderboard2021', 120);
// extraData के साथ
ysdk.leaderboards.setScore('leaderboard2021', 120, 'My favourite player!');
```
* सैंपल ES2017 async/await अनुरोध
```javascript
const work = async () => {
// extraData के बिना
await ysdk.leaderboards.setScore('leaderboard2021', 120);
// extraData के साथ
await ysdk.leaderboards.setScore('leaderboard2021', 120, 'My favourite player!');
}
work();
```
{% endlist %}
## कोई रैंकिंग प्राप्त करना {#get-entry}
{% note alert "चेतावनी" %}
केवल पंजीकृत उपयोगकर्ताओं के लिए अनुरोध उपलब्ध है। यदि आवश्यक हो, तो [प्रमाणीकरण](https://yandex.com/dev/games/doc/hi/sdk/sdk-player.md#auth) का उपयोग करें।
उपयोगकर्ता के लिए विधि की उपलब्धता की जांच करने के लिए आप `ysdk.isAvailableMethod('leaderboards.getPlayerEntry')` विधि का उपयोग कर सकते हैं, जो `Promise` लौटाता है, जहाँ बूलियन मान विधि की उपलब्धता को सूचित करता है।
सभी उपयोगकर्ताओं के लिए परिणाम सहेजने के लिए प्रेरित करने के लिए प्रेरित होते हैं, चाहे वे प्रमाणीकरण हो या न हो, हम सुझाव देते हैं कि आप एप्लिकेशन के कोड में कस्टम लीडरबोर्ड को स्वयं लिखें। प्रौद्योगिकी का चयन कोई सीमित नहीं है।
{% endnote %}
किसी उपयोगकर्ता की रैंकिंग प्राप्त करने के लिए, `ysdk.leaderboards.getPlayerEntry()` का उपयोग करें:
```javascript
getPlayerEntry(
[leaderboardName](*key_name): string
)
```
#|
|| **पैरामीटर** | **वर्णन** ||
|| `leaderboardName` | लीडरबोर्ड का नाम। ||
|#
{% note info "नोट" %}
प्रति 5 मिनट में 60 बार से अधिक अनुरोध नहीं किया जा सकता। अन्यथा यह एक त्रुटि के साथ अस्वीकृत होगा।
{% endnote %}
{% list tabs %}
* उदाहरण अनुरोध
```javascript
ysdk.leaderboards.getPlayerEntry('leaderboard2021')
.then(res => console.log(res))
.catch(err => {
if (err.code === 'LEADERBOARD_PLAYER_NOT_PRESENT') {
// यदि लीडरबोर्ड में प्लेयर के लिए प्रविष्टि नहीं है तो चालू होता है
}
});
```
* सैंपल ES2017 async/await अनुरोध
```javascript
const work = async () => {
try {
const res = await ysdk.leaderboards.getPlayerEntry('leaderboard2021');
console.log(res);
} catch (err) {
if (err.code === 'LEADERBOARD_PLAYER_NOT_PRESENT') {
// यदि लीडरबोर्ड में प्लेयर के लिए प्रविष्टि नहीं है तो चालू होता है
}
}
}
work();
```
{% endlist %}
#### अनुरोध फ़ॉर्मेट
```javascript
{
[score](*key_score): integer,
[extraData](*key_extraData): string,
rank: integer,
player: {
[getAvatarSrc](*key_getAvatarSrc): (size: string) => string,
[getAvatarSrcSet](*key_getAvatarSrcSet): (size: string) => string,
lang: string,
publicName: string,
scopePermissions: {
avatar: string,
public_name: string
},
uniqueID: string,
},
formattedScore: string
}
```
#|
|| **पैरामीटर** | **वर्णन** ||
|| `score` | स्कोर। केवल `integer` प्रकार ही स्वीकार किया जाता है। 0 से अधिक होना चाहिए। यदि [लीडरबोर्ड का प्रकार](*leaderboardtype) `time` है, तो समय मान को मिलीसेकंड में पास किया जाना चाहिए। ||
|| `extraData` | उपयोगकर्ता का वर्णन। वैकल्पिक। ||
|| `getAvatarSrc` | उपयोगकर्ता के फ़ोटो का URL लौटाता है। `size` के लिए उपलब्ध मान: `small`, `medium`, और `large`। ||
|| `getAvatarSrcSet` | उपयोगकर्ता के फ़ोटो का एक srcset लौटाता है जो रेटिना डिस्प्ले के लिए उपयुक्त हो। `size` के लिए उपलब्ध मान: `small`, `medium`, और `large`। ||
|#
## लीडरबोर्ड प्रविष्टियाँ {#get-entries}
उपयोगकर्ता रैंकिंग प्रदर्शित करने के लिए, `ysdk.leaderboards.getEntries()` का उपयोग करें:
```javascript
getEntries(
[leaderboardName](*key_name): string,
{
[includeUser](*key_includeUser): boolean,
[quantityAround](*key_quantityAround): integer,
[quantityTop](*key_quantityTop): integer
}
)
```
#|
|| **पैरामीटर** | **वर्णन** ||
|| `leaderboardName` | लीडरबोर्ड का नाम। ||
|| `includeUser` | निर्दिष्ट करता है कि जवाब में लॉग-इन किए हुए उपयोगकर्ता को शामिल करना है या नहीं:
* `true`: जवाब को शामिल करता है।
* `false` (डिफ़ॉल्ट): शामिल न करें। ||
|| `quantityAround` | लीडरबोर्ड में उपयोगकर्ता के नीचे और ऊपर लौटाई जाने वाली प्रविष्टियों की संख्या। न्यूनतम मान 1 है, अधिकतम मान 10 है। डिफ़ॉल्ट 5 है। ||
|| `quantityTop` | लीडरबोर्ड के शीर्ष की प्रविष्टियों की संख्या। न्यूनतम मान 1 है, अधिकतम मान 20 है। डिफ़ॉल्ट 5 है। ||
|#
{% note info "नोट" %}
प्रति 5 मिनट में 60 बार से अधिक अनुरोध नहीं किया जा सकता। अन्यथा यह एक त्रुटि के साथ अस्वीकृत होगा।
{% endnote %}
{% list tabs %}
* उदाहरण अनुरोध
```javascript
// सभी डिफ़ॉल्ट का उपयोग करना
ysdk.leaderboards.getEntries('leaderboard2021')
.then(res => console.log(res));
// शीर्ष 10 में वापसी
ysdk.leaderboards.getEntries('leaderboard2021', { quantityTop: 10 })
.then(res => console.log(res));
// उपयोगकर्ता के दोनों ओर शीर्ष 10 और 3 प्रविष्टियों को लौटाना
ysdk.leaderboards.getEntries('leaderboard2021', { quantityTop: 10, includeUser: true, quantityAround: 3 })
.then(res => console.log(res));
```
* सैंपल ES2017 async/await अनुरोध
```javascript
const work = async () => {
let res;
// सभी डिफ़ॉल्ट का उपयोग करना
res = await ysdk.leaderboards.getEntries('leaderboard2021');
console.log(res);
// शीर्ष 10 प्राप्त करना
res = await ysdk.leaderboards.getEntries('leaderboard2021', { quantityTop: 10 });
console.log(res);
// उपयोगकर्ता के दोनों ओर शीर्ष 10 और 3 प्रविष्टियों को लौटाना
res = await ysdk.leaderboards.getEntries('leaderboard2021', { quantityTop: 10, includeUser: true, quantityAround: 3 });
console.log(res);
}
work();
```
{% endlist %}
#### अनुरोध फ़ॉर्मेट
```javascript
{
[leaderboard](*key_leaderboard): {
...
},
[ranges](*key_ranges): [
{
[start](*key_start): integer,
[size](*key_size): integer
}
],
[userRank](*key_userRank): integer,
[entries](*key_entries): [
{
[score](*key_score): integer,
[extraData](*key_extraData): string,
rank: integer,
player: {
[getAvatarSrc](*key_getAvatarSrc): (size: string) => string,
[getAvatarSrcSet](*key_getAvatarSrcSet): (size: string) => string,
lang: string,
publicName: string,
scopePermissions: {
avatar: string,
public_name: string
},
uniqueID: string,
},
formattedScore: string
},
...
]
}
```
#|
|| **पैरामीटर** | **वर्णन** ||
|| `leaderboard` | [लीडरबोर्ड का वर्णन](#description)। ||
|| `ranges` | जवाब में रैंकिंग श्रेणियाँ। ||
|| `start` | रैंकिंग में प्लेसमेंट। गणना 0 पर शुरू होती है, इसलिए पहले स्थान को 0वाँ तत्व माना जाता है। ||
|| `size` | अनुरोधित प्रविष्टियों की संख्या। यदि पर्याप्त डेटा नहीं है, तो हो सकता है कि दिखाए जाने वाली संख्या वह नहीं हो जिसका अनुरोध किया गया था। ||
|| `userRank` | उपयोगकर्ता का रैंक। यदि कुछ नहीं हो या यदि अनुरोध उपयोगकर्ता को शामिल किए बिना तालिका के शीर्ष के लिए है तो 0 दिखाता है। ||
|| `entries` | अनुरोधित प्रविष्टियाँ। ||
|| `score` | स्कोर। केवल `integer` प्रकार ही स्वीकार किया जाता है। 0 से अधिक होना चाहिए। यदि [लीडरबोर्ड का प्रकार](*leaderboardtype) `time` है, तो समय मान को मिलीसेकंड में पास किया जाना चाहिए। ||
|| `extraData` | उपयोगकर्ता का वर्णन। वैकल्पिक। ||
|| `getAvatarSrc` | उपयोगकर्ता के फ़ोटो का URL लौटाता है। `size` के लिए उपलब्ध मान: `small`, `medium`, और `large`। ||
|| `getAvatarSrcSet` | उपयोगकर्ता के फ़ोटो का एक srcset लौटाता है जो रेटिना डिस्प्ले के लिए उपयुक्त हो। `size` के लिए उपलब्ध मान: `small`, `medium`, और `large`। ||
|#
## विधियों की पाबंदियाँ {#limits}
#|
|| **विधि** | **विवरण** | **प्रतिबंध** | **उपयोगकर्ता प्रमाणीकरण** ||
|| `ysdk.leaderboards.setScore()` | [खिलाड़ी का नया स्कोर सेट करें](#set-score) | 1 सेकंड में 1 अनुरोध | अनिवार्य ||
|| `ysdk.leaderboards.getPlayerEntry()` | [एक उपयोगकर्ता का लीडरबोर्ड प्रविष्टी लाओ](#get-entry) | 5 मिनट में 60 अनुरोध | अनिवार्य ||
|| `ysdk.leaderboards.getEntries()` | [कई उपयोगकर्ताओं का लीडरबोर्ड प्राप्त करें](#get-entries) | 5 मिनट में 20 अनुरोध | वैकल्पिक ||
|#
अन्य अनुरोधों पर पाबंदी: 5 मिनट में 20 अनुरोध।
## लीडरबोर्ड संबंधित समस्याएँ {#problems}
{% note tip "सुझाव" %}
`ysdk.isAvailableMethod()` और `ysdk.leaderboards.setScore()` विधियों को संयोजित करने पर अप्रमाणित उपयोगकर्ताओं को लीडरबोर्ड में नहीं दिखाया जाता और वे अपनी प्रगति को नहीं देख सकते। हम सुझाव देते हैं कि आप एक अलग लीडरबोर्ड तालिका बनाएं, जहाँ किसी भी उपयोगकर्ता के परिणाम सहेजें और उन्हें सभी के लिए प्रदर्शित करें। आप ऐप्लिकेशन कोड में कस्टम लीडरबोर्ड b बना सकते हैं, प्रौद्योगिकी का चयन किया जा सकता है।
{% endnote %}
### ऑब्जेक्ट पहले से मौजूद है {#object-already-exists}
नए नाम के साथ एक नया लीडरबोर्ड बनाने का प्रयास करने पर यह त्रुटि उत्पन्न होती है। उस नाम का उपयोग करें जो पहले से उपयोग नहीं हुआ है।
### उपयोगकर्ता छिपा हुआ {#player-hidden}
"छुपा हुआ उपयोगकर्ता" लेख तब दिखाई देता है जब खिलाड़ी ने अपनी प्रोफ़ाइल तस्वीर और नाम का उपयोग करने की अनुमति नहीं दी है। उपयोगकर्ता डेटा तक पहुंच उसके [प्रोफ़ाइल](https://yandex.com/games/user) में सेटिंग्स पर निर्भर करती है। अधिक जानकारी के लिए [खिलाड़ी डेटा](https://yandex.com/dev/games/doc/hi/sdk/sdk-player.md#getplayer) सेक्शन देखें।
### त्रुटि 404 {#leaderboard-404}
अगर लीडरबोर्ड के लिए SDK के तरीकों को बुलाने का प्रयास करते समय त्रुटि 404 आती है, तो सुनिश्चित करें कि डेवलपर कंसोल में **Technical leaderboard name** क्षेत्र में संबंधित नाम के लीडरबोर्ड बनाया गया है।
---
{% note info "नोट" %}
टीम सपोर्ट के कर्मचारी यंडेक्स गेम्स प्लेटफॉर्म पर तैयार खेल को डालने में मदद करते हैं। डेवलपमेंट और परीक्षण के संबंध में आवेदनिक प्रश्नों का उत्तर अन्य डेवलपर्स देंगे [Discord चैनल](https://discord.com/invite/wU4p3whr4T)।
{% endnote %}
यदि आप किसी समस्या का सामना कर रहे हैं या Yandex Games SDK के इस्तेमाल के बारे में आपका कोई प्रश्न है, तो कृपया समर्थन से संपर्क करें:
चैट करने के लिए लिखें
[*key_name]: लीडरबोर्ड का नाम।
[*key_appID]: ऐप्लिकेशन ID।
[*key_default]: यदि `true` है, तो फिर यह प्राथमिक लीडरबोर्ड है।
[*key_invert_sort_order]: क्रमबद्धता क्रम:
* `false`: रैंकिंग घटते क्रम में क्रमबद्ध की जाती हैं।
* `true`: रैंकिंग बढ़ते क्रम में क्रमबद्ध की जाती हैं।
[*key_decimal_offset]: स्कोर ऑफ़सेट।
उदाहरण के लिए, जब `decimal_offset: 2` 1234 को 12.34 के रूप में प्रदर्शित किया जाएगा।
[*key_type]: लीडरबोर्ड परिणाम प्रकार। उपलब्ध पैरामीटर: `numeric` (अंक), `time` (सेकंड)।
[*key_title]: स्थानीयकृत नाम। कानूनी सरणी पैरामीटर: `ru`, `en`, `be`, `uk`, `kk`, `uz`, `tr`।
[*key_score]: स्कोर। केवल `integer` प्रकार ही स्वीकार किया जाता है। 0 से अधिक होना चाहिए। यदि लीडरबोर्ड का प्रकार `time` है, तो समय मान को मिलीसेकंड में पास किया जाना चाहिए।
[*key_extraData]: उपयोगकर्ता का वर्णन। वैकल्पिक।
[*leaderboardtype]: लीडरबोर्ड परिणाम प्रकार। उपलब्ध पैरामीटर: `numeric` (अंक), `time` (सेकंड)।
[*key_getAvatarSrc]: उपयोगकर्ता के फ़ोटो का URL दिखाता है। `size` के लिए उपलब्ध मान: `small`, `medium`, और `large`।
[*key_getAvatarSrcSet]: उपयोगकर्ता के फ़ोटो का एक srcset दिखाता है जो रेटिना डिस्प्ले के लिए उपयुक्त हो। `size` के लिए उपलब्ध मान: `small`, `medium`, और `large`।
[*key_includeUser]: निर्दिष्ट करता है कि जवाब में लॉग-इन किए हुए उपयोगकर्ता को शामिल करना है या नहीं:
* `true`: जवाब को शामिल करता है।
* `false` (डिफ़ॉल्ट): शामिल न करें।
[*key_quantityAround]: लीडरबोर्ड में उपयोगकर्ता के नीचे और ऊपर दिखाई जाने वाली प्रविष्टियों की संख्या। न्यूनतम मान 1 है। अधिकतम मान 10 है। डिफ़ॉल्ट 5 है।
[*key_quantityTop]: लीडरबोर्ड के शीर्ष की प्रविष्टियों की संख्या। न्यूनतम मान 1 है, अधिकतम मान 20 है। डिफ़ॉल्ट 5 है।
[*key_leaderboard]: [लीडरबोर्ड का वर्णन।](#description)
[*key_ranges]: जवाब में रैंकिंग श्रेणियाँ।
[*key_start]: रैंकिंग में प्लेसमेंट। गणना 0 पर शुरू होती है, इसलिए पहले स्थान को 0वाँ तत्व माना जाता है।
[*key_size]: अनुरोधित प्रविष्टियों की संख्या। यदि पर्याप्त डेटा नहीं है, तो हो सकता है कि दिखाए जाने वाली संख्या वह नहीं हो जिसका अनुरोध किया गया था।
[*key_userRank]: उपयोगकर्ता का रैंक। यदि कुछ नहीं हो या यदि अनुरोध उपयोगकर्ता को शामिल किए बिना तालिका के शीर्ष के लिए है तो 0 दिखाता है।
[*key_entries]: अनुरोधित प्रविष्टियाँ।