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