Таблицы лидеров могут стать интересным способом стимулировать конкуренцию среди ваших игроков, как для самых преданных фанатов (которые будут бороться за первое место в публичной таблице лидеров), так и для более случайных игроков (которым будет интересно сравнить свой прогресс с успехами друзей).
Чтобы узнать, как реализовать таблицы лидеров на вашей платформе, ознакомьтесь с разделом Реализации на клиентском устройстве .
Понимать таблицы лидеров
При создании таблицы лидеров сервисы Play Games возьмут на себя управление большинством её аспектов. Типичный процесс выглядит следующим образом:
- В конце игры (или в подходящий момент, который вы определили) игра отправляет счет игрока в одну или несколько таблиц лидеров, созданных вами для игры.
- Сервисы Play Games проверяют, превышает ли этот результат текущий результат игрока в таблице лидеров за день, неделю или за всё время. Если да, сервисы Play Games обновляют соответствующие таблицы лидеров, добавляя новый результат.
- Игровые сервисы Play отправляют отчёт о результатах обратно игровому клиенту. В этом отчёте клиенту сообщается, является ли это новым дневным, еженедельным или абсолютным рекордом. Если это не так, игровые сервисы Play сообщат клиенту текущий дневной, еженедельный или абсолютный рекорд для данного игрока.
- Чтобы получить результаты игрока для таблицы лидеров, можно запросить временной интервал (дневной, еженедельный или за всё время) и указать, хочет ли пользователь видеть социальную или публичную таблицу лидеров. Сервисы Play Games выполняют всю необходимую фильтрацию, а затем отправляют результаты обратно клиенту.
- В случаях, когда необходимо отчитаться о большом количестве результатов, сервисы Play Games отправляют только данные о лучших результатах в таблице лидеров. Вы также можете получить необработанные данные о лучших результатах или результатах, смежных с результатами игрока.
Несколько таблиц лидеров
В играх может быть несколько таблиц лидеров, максимум до 70. Например, в многоуровневой игре для каждого уровня может быть своя таблица лидеров, а в гоночной игре — отдельная таблица лидеров для каждой трассы.
Временные рамки таблицы лидеров
Play Games SDK автоматически создаёт ежедневные, еженедельные и исторические версии каждой созданной вами таблицы лидеров. Вам не нужно создавать отдельные таблицы лидеров для каждого периода времени.
Ежедневные таблицы лидеров обнуляются в течение всего года в соответствии с UTC-7 (то есть в «полночь по тихоокеанскому летнему времени»).
Еженедельные таблицы лидеров сбрасываются в полночь с субботы на воскресенье в том же часовом поясе, что и ежедневные таблицы лидеров (UTC-7).
Публичные и социальные таблицы лидеров
Play Games SDK может отображать игроку две разные версии каждой таблицы лидеров:
Социальная таблица лидеров — это таблица лидеров, состоящая из людей из кругов пользователя (или, точнее, участников кругов, которыми пользователь поделился с вашим приложением), которые решили поделиться с пользователем своей игровой активностью.
Публичная таблица лидеров — это таблица лидеров, составленная из игроков, которые решили публично делиться своей игровой активностью. Если ваш игрок не решил публично делиться своей игровой активностью, он не будет отображаться в этой таблице лидеров.
Отображать таблицы лидеров
В библиотеках мобильного клиента все функции форматирования и отображения таблиц лидеров выполняются библиотеками. Вы можете указать, будет ли игрок видеть конкретную таблицу лидеров или список всех ваших таблиц лидеров, из которых он сможет выбирать.
Вы также можете реализовать собственные версии таблиц лидеров, получая доступ к данным непосредственно из клиентских библиотек.
Атрибуты
Чтобы создавать и управлять таблицами лидеров, вам необходимо ознакомиться со следующими атрибутами таблиц лидеров:
Основы
С каждой таблицей лидеров связаны следующие основные элементы:
- Идентификатор — это уникальная строка, которую Google Play Console сгенерирует для вас. Этот уникальный идентификатор будет использоваться для ссылки на таблицу лидеров в ваших игровых клиентах.
- Название — краткое название таблицы лидеров (например, «Рекорды» или «Уровень 3»). Длина названия может составлять до 100 символов.
- Значок — это квадратный значок, который будет связан с вашей таблицей лидеров. Рекомендации по созданию значков для таблицы лидеров см. в разделе «Руководство по значкам» .
- Порядок списка — это порядок, в котором будет отображаться таблица лидеров, когда игрок просматривает таблицы лидеров, связанные с вашей игрой.
- Лимиты — это необязательные значения, определяющие нижний и верхний пределы допустимых результатов в таблице лидеров. Это поможет вам отсеивать явно мошеннические результаты. Вы также можете использовать
Players.hide, чтобы скрыть игроков, которые, по вашему мнению, отправили мошеннические результаты, из всех таблиц лидеров в вашем приложении.
Заказать таблицы лидеров
Таблицы лидеров могут иметь один из двух типов упорядочивания:
- Таблицы лидеров по умолчанию выглядят так: «Чем больше, тем лучше» . Именно это обычно можно увидеть в большинстве игр, где игроки зарабатывают очки.
- Таблицы лидеров «Чем меньше, тем лучше» иногда используются в случаях, когда меньший счёт был бы предпочтительнее. Наиболее распространённые примеры такого типа таблиц лидеров — гоночные игры, где счёт отражает время, затраченное игроком на финишную прямую.
Форматирование оценок
Хотя все результаты отправляются в таблицы лидеров и хранятся внутри как длинные целые числа, сервисы Play Games могут представлять их пользователю в ряде различных форматов:
В числовых рейтингах результаты представлены в виде чисел. Они могут быть представлены как целые числа или действительные числа с фиксированным количеством знаков после запятой. Вы вводите результаты в виде целых чисел, а десятичная точка вставляется в указанное место. Например, результат
314159будет отображаться как3.14159,3141.59или314159, в зависимости от указанного количества знаков после запятой.В таблицах лидеров по времени результаты представлены в формате «часы/минуты/секунды/сотые доли секунды». Результаты необходимо указывать в миллисекундах, поэтому
66032будет интерпретироваться как1:06.03.Рейтинги валют представлены в формате валюты. Вы указываете баллы в виде 1/1 000 000 основной денежной единицы. Например, балл 19 950 000 будет интерпретироваться как
$19.95, если вы указали в качестве валюты доллар США.
Числовые таблицы лидеров также поддерживают пользовательские единицы измерения. Например, если ваша игра измеряет рекорды в метрах, вы можете указать «метры» в качестве единицы измерения по умолчанию для таблицы лидеров.
Переводы и форматирование партитур
Когда мобильные клиентские библиотеки запрашивают данные таблицы лидеров из игровых сервисов Play, они указывают язык и региональные настройки для отображения этих результатов. REST API также позволяет указать язык, соответствующий региональным настройкам. Игровые сервисы Play возвращают отформатированные результаты таблицы лидеров, соответствующие выбранному языку и региональным настройкам. Эти отформатированные результаты будут отображаться независимо от того, добавили ли вы переводы для своей таблицы лидеров.
В числовых таблицах лидеров формат отображения чисел различается в зависимости от языка. (Например, 12,345.78 в США и 12 345,78 во Франции.) Если вы используете пользовательские единицы измерения и добавили переводы в игру, необходимо предоставить переводы единиц измерения для каждого добавленного языка. Сервис затем отобразит эти переводы там, где это необходимо.
В зависимости от выбранного языка вам может потребоваться указать разные варианты названий единиц измерения. В английском языке вам потребуется указать один вариант для одного элемента и другой для всех остальных (например, «meter» и «meters»). В польском же случае вам потребуется указать один вариант для одной единицы измерения, нескольких единиц измерения, многих единиц измерения и всех остальных. Подробнее о правилах образования множественного числа см. в разделе «Строки количества (Plurals)» .
В таблицах лидеров по времени формат времени отображается в соответствии с языком и региональными настройками игрока. Это особенно заметно, если вы используете доли секунды или значение часа состоит более чем из трёх цифр (например, 4,815:16:23.42 в США и 4.815:16:23,42 в Германии).
В таблице лидеров по валюте формат валюты будет отображаться в соответствии с языком и региональными настройками игрока. Однако изменить единицу измерения невозможно. Например, если указать доллары США, игра отобразит $19.95 в США и 19,95 $ во Франции. Однако нельзя указать, что в игре отображаются доллары в США и евро во Франции.
Руководство по значкам
Значки следует создавать в формате PNG или JPEG размером 512 x 512 пикселей. В большинстве игровых клиентов ваши значки будут масштабироваться, поэтому следует избегать создания значков с большим количеством мелких деталей. Вы можете загрузить значки с альфа-каналом, и прозрачность будет сохранена. Значок таблицы лидеров будет отображаться на тёмно-сером фоне на устройствах Android, поэтому выберите значок, который будет хорошо смотреться в такой ситуации.
Во всех локалях используется один и тот же значок, поэтому мы не рекомендуем включать в значок какой-либо текст или локализованный контент.
Создать таблицу лидеров
В этом разделе рассказывается, как создавать таблицы лидеров для новых или существующих игр.
Создайте таблицу лидеров для новой игры
Чтобы создать таблицу лидеров для новой и неопубликованной игры, перейдите в раздел 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 предоставляют функцию защиты от подделки рейтингов, которая проверяет результаты на наличие предполагаемой подделки и автоматически скрывает их. Эта функция доступна только для игр для Android.
Защита от несанкционированного доступа включена по умолчанию для новых таблиц лидеров, создаваемых в вашей игре для Android, но отключена для существующих. Чтобы включить защиту от несанкционированного доступа для уже опубликованных таблиц лидеров, выполните следующие действия:
- В консоли Google Play откройте вкладку «Игровые сервисы» , затем выберите свою игру из списка.
- Откройте вкладку «Таблицы лидеров» , затем выберите экземпляр таблицы лидеров, для которого вы хотите включить защиту от несанкционированного доступа.
- Включите опцию «Включить защиту от несанкционированного доступа к таблице лидеров ».
- Нажмите «Сохранить» и продолжите.
- Опубликуйте свою игру.
После включения защиты от несанкционированного доступа для таблицы лидеров в Google Play Console эта функция может вступить в силу в течение 24 часов. Результаты, отправленные до включения защиты от несанкционированного доступа, не скрываются задним числом.
В некоторых ситуациях вам может потребоваться отключить защиту от несанкционированного доступа (например, если ваша игра работает не только на Android, но и в Интернете и использует общие таблицы лидеров на этих платформах).
Клиентские реализации
Чтобы узнать, как реализовать таблицы лидеров на вашей платформе, ознакомьтесь со следующими ресурсами: