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

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

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

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

Понимать таблицы лидеров

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

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

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

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

Таймфреймы таблицы лидеров

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

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

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

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

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

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

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

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

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

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

Атрибуты

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

Основы

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

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

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

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

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

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

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

Числовые таблицы лидеров представляют результаты в виде чисел. Они могут отображаться как целые числа или как действительные числа с фиксированным количеством десятичных знаков. Вы отправляете оценку в виде целых чисел, а десятичная точка вставляется в указанное место. Например, оценка 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 возвращают результаты таблицы лидеров в формате, соответствующем этому языку и региональным настройкам. Эти отформатированные результаты появятся независимо от того, добавили ли вы переводы в свою таблицу лидеров или нет.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Клиентские реализации

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