Эта страница переведена с помощью Cloud Translation API.

Таблицы лидеров

Таблицы лидеров могут стать интересным способом стимулировать конкуренцию среди ваших игроков, как среди самых преданных фанатов (которые будут бороться за первое место в публичной таблице лидеров), так и среди более казуальных игроков (которым будет интересно сравнить свой прогресс с прогрессом друзей).

Чтобы узнать, как реализовать таблицы лидеров для вашей платформы, см. раздел «Реализация на стороне клиента» .

Разберитесь в таблицах лидеров.

При создании таблицы лидеров Play Games Services возьмет на себя управление большинством аспектов этой таблицы. Типичный процесс выглядит следующим образом:

В конце игры (или в подходящий момент, который вы определите) игра отправляет результаты игрока в одну или несколько таблиц лидеров, созданных вами для этой игры.
Сервис Play Games Services проверяет, превосходит ли этот результат текущую позицию игрока в таблице лидеров за день, неделю или за все время. Если да, то Play Games Services обновляет соответствующие таблицы лидеров с новым результатом.
Сервисы Play Games Services отправляют отчет о результатах обратно в игровой клиент. Этот отчет сообщает клиенту, является ли это новым дневным, еженедельным или абсолютным рекордом. Если нет, Play Games Services сообщит клиенту текущий дневной, еженедельный или абсолютный рекорд этого игрока.
Чтобы получить результаты игрока в таблице лидеров, можно запросить временной интервал (ежедневно, еженедельно или за все время) и указать, хочет ли пользователь видеть социальную или публичную таблицу лидеров. Сервисы Play Games выполняют всю необходимую фильтрацию, а затем отправляют результаты обратно клиенту.
В случаях, когда необходимо сообщить большое количество результатов, Play Games Services отправляет только данные по лучшим результатам в таблице лидеров. Вы также можете получить необработанные данные по лучшим результатам или результатам, близким к результату игрока.

Несколько таблиц лидеров

В играх может быть несколько таблиц лидеров, максимум до 70. Например, в многоуровневой игре для каждого уровня может быть своя таблица лидеров, а в гоночной игре — отдельная таблица лидеров для каждой трассы.

Временные рамки таблицы лидеров

Play Games SDK автоматически создает ежедневные, еженедельные и общие версии каждой созданной вами таблицы лидеров. Вам не нужно создавать отдельные таблицы лидеров для каждого временного периода.

Ежедневные таблицы лидеров обновляются в полночь по тихоокеанскому летнему времени (UTC-7) в течение всего года.

Еженедельные таблицы лидеров обновляются в полночь в период с субботы по воскресенье, в том же часовом поясе, что и ежедневные таблицы лидеров (UTC-7).

Публичные и социальные рейтинги

Play Games SDK может отображать игроку две разные версии каждой таблицы лидеров:

Социальная таблица лидеров — это таблица, состоящая из людей из круга общения пользователя (или, точнее, участников круга, который пользователь решил показать вашему приложению), которые решили поделиться своей игровой активностью с пользователем.

Публичная таблица лидеров — это таблица, составленная из игроков, которые решили публично делиться своей игровой активностью. Если ваш игрок не решил публично делиться своей игровой активностью, он не будет отображаться в этой таблице лидеров.

Отобразить таблицы лидеров

В библиотеках мобильного клиента все форматирование и отображение таблиц лидеров находятся в руках разработчиков. Вы можете указать, может ли игрок видеть конкретную таблицу лидеров или список всех ваших таблиц лидеров, из которых он может выбирать.

Вы также можете реализовать собственные версии таблиц лидеров, получая доступ к данным непосредственно из клиентских библиотек.

Атрибуты

Для создания и управления таблицами лидеров вам необходимо ознакомиться со следующими атрибутами таблиц лидеров:

Основы

Эти основные элементы присущи каждой таблице лидеров:

ID — это уникальная строка, которую сгенерирует для вас Google Play Console. Вы будете использовать этот уникальный ID для ссылки на таблицу лидеров в своих игровых клиентах.
Название — это короткое название таблицы лидеров (например, «Лучшие результаты» или «Уровень 3»). Оно может содержать до 100 символов.
Значок — это квадратный значок, который будет связан с вашей таблицей лидеров. Рекомендации по созданию значков для таблицы лидеров см. в разделе «Рекомендации по созданию значков» .
Порядок отображения в списке — это порядок, в котором таблица лидеров будет отображаться, когда игрок будет просматривать таблицы лидеров, связанные с вашей игрой.
Параметр Limits — это необязательные значения, определяющие нижний и верхний пределы допустимых результатов в таблице лидеров. Это может помочь вам отбрасывать явно мошеннические результаты. Вы также можете использовать Players.hide , чтобы скрыть игроков, которые, по вашему мнению, представили мошеннические результаты, из всех таблиц лидеров вашего приложения.

Таблицы лидеров заказов

В таблицах лидеров может быть один из двух типов упорядочивания:

Чем больше таблица лидеров, тем лучше . Обычно так и бывает в большинстве игр, где игроки зарабатывают очки.
Таблицы лидеров с принципом «чем меньше, тем лучше» иногда используются в случаях, когда меньшее количество очков предпочтительнее. Наиболее распространенные примеры таких таблиц лидеров — гоночные игры, где очки отражают время, затраченное игроком на финиш гонки.

Форматирование партитуры

Хотя все результаты отправляются в таблицы лидеров и хранятся внутри системы в виде целочисленных значений типа long, сервисы Play Games могут отображать их пользователю в нескольких различных форматах:

В числовых таблицах лидеров результаты отображаются в виде чисел. Они могут быть целыми числами или действительными числами с фиксированным числом десятичных знаков. Вы вводите результат в виде целого числа, а десятичная точка вставляется в указанное место. Например, результат 314159 будет отображаться как 3.14159 , 3141.59 или 314159 , в зависимости от указанного вами количества десятичных знаков.
В таблицах результатов время отображается в формате часы / минуты / секунды / сотые доли секунды. Результаты необходимо указывать в миллисекундах, поэтому 66032 будет интерпретировано как 1:06.03 .
В таблицах лидеров по валютным показателям результаты отображаются в валютном формате. Вы указываете результаты в виде 1/1 000 000 основной валюты. Например, результат 19 950 000 будет интерпретироваться как $19.95 , если вы указали валюту USD.

Числовые таблицы лидеров также поддерживают пользовательские единицы измерения. Например, если в вашей игре лучшие результаты измеряются в метрах, вы можете указать «метры» в качестве единицы измерения по умолчанию для вашей таблицы лидеров.

Перевод и форматирование партитур

Когда библиотеки мобильных клиентов запрашивают данные таблицы лидеров у Play Games Services, они указывают язык и локаль, на которых следует отображать эти результаты. REST API также позволяет указать язык на основе локали. Play Games Services возвращает отформатированные результаты таблицы лидеров, соответствующие этому языку и локали. Эти отформатированные результаты будут отображаться независимо от того, добавили ли вы переводы для своей таблицы лидеров.

В числовых таблицах лидеров формат отображения чисел различается в зависимости от языка. (Например, 12,345.78 в США и 12 345,78 во Франции.) Если вы используете пользовательские единицы измерения и добавили переводы в свою игру, вам необходимо предоставить переведенные единицы измерения для каждого добавленного языка. Затем сервис отобразит эти переведенные единицы измерения там, где это необходимо.

В зависимости от выбранного языка вам может потребоваться указать разные варианты названий единиц измерения. В английском языке вам понадобится вариант для одного элемента и другой для всего остального (например, «метр» и «метры»). В польском же языке вам потребуется указать вариант для одной единицы, нескольких единиц, многих единиц и всего остального. Более подробную информацию о правилах использования множественного числа см. в разделе «Строки количества (множественное число)» .

В таблицах лидеров по времени формат времени отображается в соответствии с языком и регионом игрока. Это будет особенно заметно, если вы используете доли секунды или значение часов, содержащее более 3 цифр (например, 4,815:16:23.42 в США и 4.815:16:23,42 в Германии).

В таблицах лидеров по валютам формат валюты будет отображаться в соответствии с языком и регионом игрока. Однако изменить единицу измерения валюты нельзя. Например, если вы укажете доллары США, игра отобразит $19.95 в США и 19,95 $ во Франции. Но вы не можете указать, чтобы ваша игра отображала доллары в США и евро во Франции.

Создать таблицу лидеров

В этом разделе вы узнаете, как создавать таблицы лидеров для новых или существующих игр.

Создайте таблицу лидеров для новой игры.

Чтобы создать таблицу лидеров для новой, еще не опубликованной игры, перейдите в раздел Google Play Console для вашей игры, затем в Grow > Play Games Services > Настройка и управление > Таблицы лидеров и нажмите кнопку «Создать таблицу лидеров» .

Кнопка «Добавить таблицу лидеров» на главной панели таблиц лидеров.

Затем просто заполните необходимую информацию для этой таблицы лидеров.

Заполненная форма для таблицы лидеров «Лучший раунд».

Нажмите «Сохранить как черновик» , и ваша таблица лидеров будет доступна в состоянии «Черновик». После публикации игры все таблицы лидеров вашей игры будут опубликованы вместе с ней.

Создайте таблицу лидеров для опубликованной игры.

Чтобы создать дополнительную таблицу лидеров для уже опубликованной игры, выполните те же действия, что и выше. Более подробную информацию о тестировании обновленной версии игры см. в разделе «Публикация изменений в игре» .

После того, как вы протестируете свою таблицу лидеров и останетесь довольны результатом, вы можете повторно опубликовать свою игру с новыми таблицами лидеров, и они будут доступны всему миру.

Редактировать таблицу лидеров

Чтобы отредактировать уже созданную таблицу лидеров, щелкните по ней во вкладке «Таблицы лидеров » в Google Play Console. После этого вы увидите ту же форму, которую использовали при первом создании таблицы лидеров, и сможете редактировать любые поля по своему усмотрению.

После завершения редактирования таблицы лидеров нажмите кнопку « Сохранить как черновик» . Отредактированная таблица лидеров будет находиться в состоянии «Черновик», что позволит вам её протестировать.

Если все работает правильно, выберите «Опубликовать изменения» в поле вверху формы таблицы лидеров, и вы сможете повторно опубликовать свою игру вместе со всеми обновленными таблицами лидеров для всеобщего доступа.

Отменить редактирование

Если вы решите, что вам не нравится отредактированная таблица лидеров, и захотите вернуться к предыдущей версии, просто выберите «Отменить» в поле вверху формы таблицы лидеров. Ваша таблица лидеров вернется к уже опубликованной версии.

Удалить таблицу лидеров

Вы можете удалить таблицы лидеров, находящиеся в состоянии «Черновик» или уже опубликованные. Чтобы удалить таблицу лидеров в Google Play Console, перейдите к форме для этой таблицы и нажмите «Удалить таблицу лидеров» в верхней части формы.

В качестве альтернативы вы можете вызвать метод Players.hide , чтобы скрыть таблицу лидеров игрока в приложении.

Сбросить таблицу лидеров

Вы можете сбросить данные о прогрессе игроков только для таблиц лидеров драфта.

Чтобы сбросить таблицу лидеров в Google Play Console, нажмите «Сбросить прогресс» в верхней части формы для соответствующего события.
Для программного сброса данных таблицы лидеров вызовите методы Management API Scores .

Добавить переводы для таблиц лидеров

Вы можете указать собственные переводы для таблиц лидеров, связанных с вашей игрой. Прежде чем это сделать, убедитесь, что вы выполнили шаги, описанные в разделе «Добавление переводов для вашей игры» . Вы также должны создать одну или несколько таблиц лидеров для своей игры.

Чтобы добавить собственные переводы для таблиц лидеров, откройте вкладку «Таблицы лидеров» для вашей игры в Google Play Console, затем выберите существующую таблицу лидеров. На странице сведений о таблице лидеров нажмите вкладку для языка, который вы ранее добавили на вкладке « Сведения об игре» . На странице сведений о таблице лидеров для этого языка отредактируйте форму, добавив свои переводы для этой таблицы лидеров. Нажмите «Сохранить» , чтобы сохранить переведенные данные таблицы лидеров.

Скрыть результаты в таблице лидеров

Сервисы Google Play Games предоставляют функцию защиты от подделки результатов в таблице лидеров, которая проверяет подозрительные показатели и автоматически скрывает их. Эта функция доступна только для игр на Android.

Защита от несанкционированного изменения данных включена по умолчанию для новых таблиц лидеров, которые вы создаете для своей игры на Android, но отключена для существующих таблиц лидеров. Чтобы включить защиту от несанкционированного изменения данных для уже опубликованных таблиц лидеров, выполните следующие действия:

В Google Play Console откройте вкладку «Игровые сервисы» , затем выберите свою игру из списка.
Откройте вкладку «Таблицы лидеров» , затем выберите экземпляр таблицы лидеров, для которого вы хотите включить защиту от несанкционированного доступа.
Включите параметр « Включить защиту от несанкционированного изменения данных в таблице лидеров» .
Нажмите «Сохранить и продолжить».
Опубликуйте свою игру.

После включения защиты от подделки для таблицы лидеров в Google Play Console может потребоваться до 24 часов, прежде чем эта функция начнет действовать. Результаты, отправленные до включения защиты от подделки, не скрываются задним числом.

В некоторых ситуациях может потребоваться отключить защиту от несанкционированного доступа (например, если ваша игра работает не только на Android, но и в веб-версии, и использует общие таблицы лидеров на этих платформах).

Внедрение клиентских решений

Чтобы узнать, как внедрить таблицы лидеров на вашей платформе, ознакомьтесь со следующими ресурсами: