Достижения могут стать отличным способом повысить вовлечённость пользователей в игру. Вы можете внедрить достижения в игру, чтобы побудить игроков экспериментировать с функциями, которыми они обычно не пользуются, или попробовать совершенно другой стиль игры. Достижения также могут стать для игроков увлекательным способом сравнить свой прогресс и поучаствовать в непринуждённом соревновании.
Чтобы узнать, как реализовать достижения для вашей платформы, см. раздел Реализации клиентов .
Атрибуты
Чтобы понять, как работают достижения, вам нужно ознакомиться с некоторыми атрибутами, связанными с ними.
Эти основные элементы связаны с каждым достижением:
- Id — это уникальная строка, генерируемая Google Play Console. Этот уникальный идентификатор будет использоваться для ссылки на достижение в ваших игровых клиентах.
- Имя — краткое название достижения (например, «Пирог»). Длина значения может составлять до 100 символов.
- Описание — это краткое описание вашего достижения. Обычно оно объясняет, как получить достижение (например, «Испеките лимонный пирог с безе до заката»). Длина описания может составлять до 500 символов.
- Значок — это квадратный значок, связанный с вашим достижением. Рекомендации по созданию значков достижений см. в разделе «Рекомендации по значкам» .
- Порядок списка — это порядок, в котором заблокированные достижения отображаются при просмотре достижений, связанных с вашей игрой. Этот порядок может быть любым. Разблокированные достижения отображаются вверху списка в порядке их получения.
Состояние
Достижения могут находиться в одном из трех различных состояний:
- Скрытое достижение означает, что информация о нём скрыта от игрока. Игровые сервисы Play предоставляют общее описание и значок достижения, пока оно скрыто. Мы рекомендуем сделать достижение скрытым, если оно содержит спойлер об игре, который вы не хотите раскрывать слишком рано (например, «Узнайте, что вы всё это время были призраком!»).
- Открытое достижение означает, что игрок знает о нём, но ещё не получил его. Большинство достижений начинаются в раскрытом состоянии.
- Разблокированное достижение означает, что игрок успешно его получил. Достижение можно разблокировать офлайн. При выходе в онлайн игра синхронизируется с игровыми сервисами Play, чтобы обновить статус разблокировки достижения.
Дополнительные достижения
Достижения могут быть стандартными или постепенными . Как правило, постепенный прогресс подразумевает, что игрок постепенно продвигается к получению достижения в течение длительного периода времени. По мере продвижения игрока к постепенным достижениям вы можете сообщить о его частичном прогрессе в игровые сервисы Play.
Сервис Google Play отслеживает информацию о прогрессе, оповещает игру, когда игрок достигает критериев, необходимых для разблокировки достижения, и сообщает игроку, насколько он продвинулся к достижению этой цели.
Достижения, накапливающиеся в течение игровых сессий, накапливаются, и прогресс нельзя удалить или сбросить внутри игры. Например, «Выиграть 50 игр» будет считаться достижением, накапливающимся в течение игрового сеанса. «Выиграть 3 игры подряд» — нет, так как прогресс игрока обнуляется после проигрыша. «Иметь 5000 покерных фишек» также не будет считаться достижением, так как игрок может получать и терять фишки по ходу игры. Для последних двух достижений вы сами решаете, сколько фишек игрок выиграл подряд или сколько фишек у него есть, и разблокируете стандартные достижения, когда игрок их зарабатывает.
При создании пошагового достижения необходимо указать общее количество шагов, необходимых для его разблокировки (это число должно быть от 2 до 10 000). По мере продвижения пользователя к разблокировке достижения необходимо сообщать в игровые сервисы Play количество дополнительных шагов, которые он сделал. Как только общее количество шагов достигнет значения, необходимого для разблокировки, достижение разблокируется (даже если оно было скрыто). Вам не нужно хранить совокупный прогресс пользователя.
Очки
Достижения имеют свою ценность в очках. Счёт игрока должен быть кратен 5, и сумма очков за все достижения в игре не может превышать 1000 (хотя может быть и меньше). Кроме того, ни одно достижение не может стоить более 200 очков.
Отслеживайте очки опыта (XP)
Игроки могут повышать уровни своего игрового профиля, получая достижения в играх с поддержкой Play Games. За каждое очко , связанное с достижением, игрок получает 100 очков опыта (XP) при его получении. Другими словами:
XP for an achievement = 100 * (point value for the achievement)
Сервисы Play Games отслеживают количество очков опыта, заработанных каждым игроком, и отправляют уведомление в приложение Google Play Games, когда игрок набирает достаточно очков для повышения уровня. Игроки могут просматривать свой уровень и историю опыта на странице своего профиля в приложении Google Play Games.
Минимальные достижения
Игра, в которой интегрированы достижения, должна иметь не менее пяти достижений перед публикацией. Вы можете протестировать игру с меньшим количеством достижений, но рекомендуется создать хотя бы пять достижений перед публикацией.
Максимальные достижения
Количество достижений ограничено лимитом баллов и их распределением. Максимальное количество баллов — 1000, а каждому достижению присваивается 5 баллов, то есть максимальное количество достижений составляет 200. Однако чем больше баллов присваивается достижению, тем меньше становится количество доступных достижений.
Добавить достижения
Создать достижения впервые с помощью Google Play Console можно двумя способами:
- Создайте достижение : добавляйте определения и метаданные для каждого достижения по одному за раз.
- Импорт достижений : импортируйте определения и другие метаданные для нескольких достижений за один шаг.
Создать достижение
Чтобы создать достижение для новой и неопубликованной игры, выполните следующие действия:
- В консоли Google Play выберите игру.
- На странице «Сервисы Play Игр» — «Достижения» ( Grow > Сервисы Play Игр > Настройка и управление > Достижения ) выберите «Создать достижение» .
- На странице «Добавить достижения» заполните форму.
- Нажмите Сохранить как черновик .
- После того как вы создали достижение, вам необходимо опубликовать свою игру .
Добавить больше достижений
Если у вас уже есть достижения и вы хотите добавить новые:
- В консоли Google Play выберите игру.
- На странице «Сервисы Play Игр» — «Достижения» ( Grow > Сервисы Play Игр > Настройка и управление > Достижения ) выберите «Добавить достижения» .
Импорт достижений
Чтобы добавить в игру сразу несколько достижений, выполните следующие действия:
- Создайте zip-файл, содержащий ваши достижения.
- Загрузите файл.
Дополнительную информацию о zip-файле см. в разделе «Руководство по созданию zip-файлов» .
Чтобы импортировать достижения:
- В консоли Google Play выберите игру.
- На странице «Сервисы Play Игр» — «Достижения» ( Grow > Сервисы Play Игр > Настройка и управление > Достижения ) выберите «Импорт достижений» .
- На странице «Импорт достижений» нажмите кнопку «Загрузить» .
- Выберите zip-файл для загрузки.
- Нажмите Сохранить как черновик .
- После импорта достижений вам необходимо опубликовать свою игру .
Опубликуйте свою игру
После того, как вы протестируете и опубликуете свою игру , все ваши игровые достижения будут опубликованы вместе с ней.
Редактировать достижение
Чтобы отредактировать уже созданное достижение, выберите его на вкладке «Достижения» в Google Play Console. Откроется та же форма, которую вы использовали при создании достижения, и вы сможете отредактировать любые поля по своему усмотрению.
Завершив редактирование достижения, нажмите кнопку « Сохранить как черновик ». Отредактированное достижение будет готово к тестированию, и вы сможете его протестировать. Если всё работает корректно, выберите «Опубликовать повторно» в раскрывающемся списке. Это позволит повторно опубликовать вашу игру вместе со всеми обновлёнными достижениями.
Отменить редактирование
Если вы решили, что вам не нравится ваше текущее достижение, и вы хотите вернуться к прежнему виду достижения, выберите «Вернуть» в раскрывающемся списке в Google Play Console, и все ваши достижения вернутся к ранее опубликованной версии.
Удалить достижение
После публикации вашего достижения его невозможно удалить.
Удалить достижение, находящееся в предварительно опубликованном состоянии, можно только нажав кнопку « Удалить » в нижней части формы для этого достижения.
Сбросить достижение
Вы можете сбросить данные о прогрессе игрока только для своих достижений в проекте.
- Чтобы сбросить достижения в Google Play Console, нажмите кнопку Сбросить прогресс достижения в нижней части формы для этого события.
- Чтобы программно сбросить данные о достижениях, вызовите методы API управления
Achievements.
Руководство по значкам
Значки должны быть созданы в формате PNG, JPEG или JPG размером 512 x 512 пикселей. Вам нужно предоставить нам только значок разблокированного достижения. Мы автоматически создадим черно-белую версию для открытого значка. Поэтому мы рекомендуем использовать в значках достижений яркие элементы, чтобы пользователи могли различать открытые и разблокированные достижения.
Когда значок достижения отображается во всплывающем окне Android, он накладывается на круг, а его внешние углы скрываются. Убедитесь, что ваш значок по-прежнему выглядит хорошо в этих условиях.
Во всех локалях используется один и тот же значок, поэтому мы не рекомендуем включать в значок какой-либо текст или локализованный контент.
Руководство по созданию zip-файлов
Вы можете импортировать несколько достижений одновременно, используя ZIP-файл. Точные имена файлов для использования в ZIP-файле см. в таблице:
| Имя файла | Обязательно или необязательно | Принятые значения |
|---|---|---|
AchievementsMetadata.csv | Необходимый | Метаданные для каждого достижения. См. раздел «Атрибуты» . |
AchievementsLocalizations.csv | Необязательный | Предоставляет переводы названий и описаний достижений. |
AchievementsIconMappings.csv | Необязательный | Связывает достижения с файлами их значков. |
| Файлы значков | Необязательный | Иконки в формате PNG, JPEG или JPG. |
Требования к zip-файлу:
- Подкаталогов нет.
- Уникальные имена файлов.
- Только файлы CSV, PNG, JPEG или JPG.
- CSV-файлы не должны иметь строку заголовка.
- Размер каждого файла не должен превышать 1 МБ.
- ZIP-архив не должен содержать более 203 файлов.
- Общий размер zip-файла должен быть менее 200 МБ.
Формат AchievementsMetadata.csv
Файл AchievementsMetadata.csv содержит метаданные для каждого достижения. Информация должна быть представлена в виде значений, разделенных запятыми, в следующем порядке:
Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order
Эти поля описаны в следующей таблице:
| Заголовки столбцов CSV | Обязательно или необязательно | Принятые значения |
|---|---|---|
| Имя | Необходимый | Максимум 100 символов |
| Описание | Необязательный | Максимум 500 символов |
| Приростная ценность | Необязательный | True или False |
| Необходимые шаги | Обязательно, если Incremental Value равно True. | Число (без дробей и десятичных знаков) |
| Начальное состояние | Необходимый | Hidden или Revealed |
| Очки | Необходимый | Число, кратное 5, и значение должно быть в диапазоне от 5 до 200. |
| Порядок списка | Необязательный | Число (без дробей и десятичных знаков, больше нуля) |
Требования к файлу AchievementsMetadata.csv :
- Каждая строка должна содержать семь значений. Если вы хотите пропустить значение, оставьте его пустым.
- Поля
NameиDescriptionиспользуются в качестве локали по умолчанию. - Поле
Nameдолжно быть уникальным для всех достижений. - Следующие поля не должны содержать запятых:
NameиDescription.
Пример файла AchievementsMetadata.csv :
Achievement1,Achievement One,True,100,Hidden,5,20
Achievement2,Achievement Two,False,,Revealed,10,30
Формат AchievementsLocalizations.csv
Файл AchievementsLocalizations.csv — это необязательный файл, который содержит все данные, необходимые для описания каждого достижения для пользователей в разных регионах. Достижения переводятся в соответствии с региональными настройками игры.
Информацию следует указывать в виде значений, разделенных запятыми, в следующем порядке:
Name, Localized name, Localized description, locale
Эти поля описаны в следующей таблице:
| Заголовки столбцов CSV | Обязательно или необязательно | Описание | Принятые значения |
|---|---|---|---|
| Имя | Необходимый | Должно соответствовать столбцу Name из AchievementsMetadata.csv . | Максимум 100 символов |
| Локализованное имя | Необходимый | Локализованное название достижения. | Максимум 100 символов |
| Локализованное описание | Необязательный | Локализованное описание достижения в указанной локали. | Максимум 500 символов |
| Локаль | Необходимый | Код локали, например en-US . | Добавьте переводы для вашей игры, прежде чем указывать локаль. Обратите внимание, что вы не можете указать локаль по умолчанию. Поддерживаемые коды локалей можно найти в списке поддерживаемых языков . |
Требования к файлу AchievementsLocalizations.csv :
- Названия достижений в игре должны быть уникальными для каждой локали. Например, если игра поддерживает как локали en-US, так и fr-FR, достижение с названием «Achievement1» для en-US также может быть названо «Achievement1» для fr-FR.
- Каждая строка должна содержать четыре значения. Если вы хотите пропустить значение «Локализованное описание», оставьте его пустым.
Пример файла AchievementsLocalizations.csv :
Achievement1,Achievement One,This is the description of achievement one in English.,en-US
Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR
Achievement2,Achievement Two,Description of achievement two.,en-US
Achievement2,Logro Dos,Descripción del logro dos.,es-ES
Achievement3,Achievement Three,,en-US
Achievement3,Erfolg Drei,,de-DE
Формат AchievementsIconMappings.csv
Файл AchievementsIconMappings.csv — это необязательный файл, который используется для сопоставления ваших достижений с заданным значком. Информация должна содержаться в виде значений, разделенных запятыми, в следующем порядке:
Name, icon filename
Эти поля описаны в следующей таблице:
| Заголовки столбцов CSV | Обязательно или необязательно | Описание |
|---|---|---|
| Имя | Необходимый | Должно соответствовать столбцу Name из AchievementsMetadata.csv . |
| Имя файла значка | Необходимый | Имя файла вашего значка. |
Требования к файлу AchievementsIconMappings.csv :
- Каждая строка должна иметь два значения.
- Файлы иконок могут быть только в форматах PNG или JPEG.
Пример файла AchievementsIconMappings.csv :
Valid Achievement,valid-achievement-icon.png
Incremental Achievement,incremental-achievement-icon.jpeg
No Description,no-description-icon.png
Hidden Initial State,hidden-initial-state-icon.png
Large Point Value,large-point-value-icon.jpeg
Файлы значков
Значки, на которые вы ссылаетесь в файле AchievementsIconMappings.csv , должны присутствовать в текущем импортируемом ZIP-архиве. Подробнее см. в разделе «Руководство по значкам» .
Добавить переводы для достижений
Вы можете добавить собственные переводы для достижений, связанных с вашей игрой. Перед этим выполните шаги, описанные в разделе «Добавление переводов для вашей игры» .
Добавить переводы для вашей игры можно двумя способами:
Вы можете импортировать достижения , чтобы загрузить переводы сразу для нескольких новых достижений. Эту функцию нельзя использовать для загрузки переводов уже существующих достижений.
Вы можете добавить переводы для каждого достижения в вашей игре. Чтобы добавить собственный перевод для каждого достижения:
- В консоли Google Play откройте вкладку «Достижения» для вашей игры, затем выберите существующее достижение.
- На странице сведений о достижениях выберите вкладку языка, который вы ранее добавили на вкладке «Сведения об игре» .
- На странице сведений о достижении для этого языка отредактируйте форму, добавив в нее переводы для этого достижения.
- Нажмите «Сохранить» , чтобы сохранить переведенные сведения о достижении.
Клиентские реализации
Чтобы узнать, как реализовать достижения на вашей платформе, ознакомьтесь со следующими ресурсами: