Рейтинг игрока

info

Используйте fetchPlayerRating чтобы получить позицию игрока в рейтинге.

Получение рейтинга игрока

+1 Request

Можно получить позицию игрока в рейтинге через fetchPlayerRating. Это урезанная версия fetch для игрока.

JavaScript

const result = await gp.leaderboard.fetchPlayerRating({
    // Сортировка по полям слева на право
    orderBy: ['level', 'gold'],
    // Сортировка DESC — сначала большие значение, ASC — сначала маленькие
    order: 'DESC',
    // Включить список полей для отображения в таблице, помимо orderBy
    includeFields: ['rank'],
    // Получить N ближайших игроков сверху и снизу, максимум 10
    showNearest: 5,
});

// Результат получения
const { player, fields, abovePlayers, belowPlayers } = result;
// Позиция игрока
player.position;
// Имя игрока
player.name;
// Аватар игрока
player.avatar;
// Переменные игрока
player.level;
player.gold;
player.myVariable;

Unity

// Подписка на события
private void OnEnable()
{
    GP_Leaderboard.OnFetchPlayerRatingSuccess += OnFetchPlayerRatingSuccess;
}
// Отписка от событий
private void OnDisable()
{
    GP_Leaderboard.OnFetchPlayerRatingSuccess -= OnFetchPlayerRatingSuccess;
}

public void FetchPlayerRating() =>
            GP_Leaderboard.FetchPlayerRating(
                //Тэг для метода обработки результата
                tag = "player12",
                // Сортировка по полям слева на право
                orderBy = "score",
                // Сортировка DESC — сначала большие значение, ASC — сначала маленькие
                order = "DESC"
            );

// Результат получения
private void OnFetchPlayerRatingSuccess(string fetchTag, int position) => 
        Debug.Log("LEADERBOARD: " + fetchTag + " PLAYER POSITION: " + position);

Ответ:

Свойство	Тип	Описание
player	LeaderboardPlayer	данные моего игрока с позицией
abovePlayers	LeaderboardPlayer[]	список игроков перед моим игроком
belowPlayers	LeaderboardPlayer[]	список игроков после моего игрока

Получение рейтинга игрока в изолированной таблице

+1 Request

Можно получить позицию игрока в рейтинге через fetchPlayerRatingScoped. Это урезанная версия fetchScoped для игрока.

JavaScript

const result = await gp.leaderboard.fetchPlayerRatingScoped({
    // ID таблицы
    id: 17,
    // Tag таблицы
    tag: 'LEVELS',
    // Название области видимости
    variant: 'level_15',
    // Включить список полей игрока
    includeFields: ['rank'],
    // Получить N ближайших игроков сверху и снизу, максимум 10
    showNearest: 5,
});

// Результат получения
const { player, fields, abovePlayers, belowPlayers } = result;
// Позиция игрока
player.position;
// Имя игрока
player.name;
// Аватар игрока
player.avatar;
// Переменные игрока
player.level;
player.gold;
player.myVariable;

Unity

//Подписка на события
private void OnEnable()
{
    GP_LeaderboardScoped.OnFetchPlayerRating += OnFetchPlayerRating;
    GP_LeaderboardScoped.OnFetchPlayerRatingError += OnFetchPlayerRatingError;
}
//Отписка от событий
private void OnDisable()
{
    GP_LeaderboardScoped.OnFetchPlayerRating -= OnFetchPlayerRating;
    GP_LeaderboardScoped.OnFetchPlayerRatingError -= OnFetchPlayerRatingError;
}

public void FetchPlayerRating() =>
    GP_LeaderboardScoped.FetchPlayerRating(
        idOrTag = "LEVELS",
        variant = "some_variant", 
        includeFields = "rank")
    );

// Результат получения
private void OnFetchPlayerRating(string fetchTag, int position) =>
    Debug.Log("LEADERBOARD SCOPED: " + fetchTag + ": PLAYER POSITION: " + position);

// Ошибка получения
private void OnFetchPlayerRatingError() =>
    Debug.Log("LEADERBOARD SCOPED: ON FETCH PLAYER RATING: ERROR");

Ответ:

Свойство	Тип	Описание
player	LeaderboardPlayer	данные моего игрока с позицией
abovePlayers	LeaderboardPlayer[]	список игроков перед моим игроком
belowPlayers	LeaderboardPlayer[]	список игроков после моего игрока

Оставайтесь на связи

С другими разделами документации вы можете ознакомиться здесь. Для начала работы вы можете ознакомиться с нашими туториалами.

Сообщество GamePush в Telegram: @gs_community.

Для ваших обращений e-mail: [email protected]

Желаем вам успехов!