В этом документе объясняется, как интегрировать достижения в игру с помощью Google Play Console или вызовов API. В нём рассматриваются основные элементы и состояния достижений, а также описывается их создание, импорт и управление.
Прежде чем начать
Ознакомьтесь с руководящими принципами достижения высоких показателей качества дизайна .
Повторите терминологию в разделе «Основы достижений» .
Создавайте или импортируйте новые достижения
Чтобы реализовать достижения с нуля, выполните следующие действия:
Добавить достижения
Создать достижения впервые с помощью Google Play Console можно двумя способами:
- Создайте достижение : добавляйте определения и метаданные для каждого достижения по одному за раз.
- Импорт достижений : импортируйте определения и другие метаданные для нескольких достижений за один шаг.
Создать достижение
Чтобы создать достижение для новой и неопубликованной игры, выполните следующие действия:
- В консоли Google Play выберите игру.
- На странице «Сервисы Play Игр» — «Достижения» ( Grow > Сервисы Play Игр > Настройка и управление > Достижения ) выберите «Создать достижение» .
- На странице «Добавить достижения» заполните форму.
- Нажмите Сохранить как черновик .
- После того как вы создали достижение, вам необходимо опубликовать свои достижения .
Импорт достижений
Чтобы добавить в игру сразу несколько достижений, выполните следующие действия:
- Создайте zip-файл, содержащий ваши достижения.
- Загрузите файл.
Дополнительную информацию о zip-файле см. в разделе «Руководство по созданию zip-файлов» .
Чтобы импортировать достижения:
- В консоли Google Play выберите игру.
- На странице «Сервисы Play Игр» — «Достижения» ( Grow > Сервисы Play Игр > Настройка и управление > Достижения ) выберите «Импорт достижений» .
- На странице «Импорт достижений» нажмите кнопку «Загрузить» .
- Выберите zip-файл для загрузки.
- Нажмите Сохранить как черновик .
- После импорта достижений вам необходимо опубликовать свою игру .
Руководство по созданию 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
Руководство по значкам
Значки должны быть созданы в формате PNG, JPEG или JPG размером 512 x 512 пикселей. Вам нужно предоставить нам только значок разблокированного достижения. Мы автоматически создадим черно-белую версию для открытого значка. Поэтому мы рекомендуем использовать в значках достижений яркие элементы, чтобы пользователи могли различать открытые и разблокированные достижения.
Когда значок достижения отображается в [toast][a] на Android, он обрамлён кругом, а его внешние углы скрыты. Убедитесь, что ваш значок по-прежнему выглядит хорошо в этих условиях.
Во всех локалях используется один и тот же значок, поэтому мы не рекомендуем включать в значок какой-либо текст или локализованный контент.
Файлы значков
Значки, на которые вы ссылаетесь в файле AchievementsIconMappings.csv , должны существовать в текущем импортируемом вами zip-архиве.
Обновите игры с существующими достижениями
Вы можете добавить новые достижения в игру и обновить существующие в Google Play Console.
Добавить больше достижений
Если у вас уже есть достижения и вы хотите добавить новые:
- В консоли Google Play выберите игру.
- На странице «Сервисы Play Игр» — «Достижения» ( Grow > Сервисы Play Игр > Настройка и управление > Достижения ) выберите «Добавить достижения» .
Редактировать достижения
Если у вас уже есть достижения и вы хотите их отредактировать:
- В консоли Google Play выберите игру.
- На странице «Сервисы Play Игр» — «Достижения» ( Развитие > Сервисы Play Игр > Настройка и управление > Достижения ) выберите достижение.
- Вы можете редактировать любое из полей.
- Нажмите Сохранить как черновик .
- На странице «Игровые сервисы Play» — «Достижения» отредактированное достижение имеет статус «Доступно для тестировщиков».
- После проверки достижения нажмите кнопку «Просмотреть и опубликовать» .
Это приведет к повторной публикации вашей игры вместе со всеми вашими обновленными достижениями.
Удалить достижение
После публикации ваше достижение невозможно удалить. Удалить можно только достижение, которое находится в состоянии предварительной публикации.
- На странице «Игровые сервисы Play» — «Достижения» выберите достижение.
- Чтобы удалить достижение, нажмите «Удалить достижение» .
Сбросить достижение
Вы можете сбросить данные о прогрессе игрока только для своих достижений в проекте.
- На странице «Игровые сервисы Play» — «Достижения» выберите достижение.
- Чтобы сбросить достижения, нажмите Сбросить прогресс .
- Чтобы программно сбросить данные о достижениях, вызовите методы API управления
Achievements.
Добавить переводы для достижений
Вы можете добавить собственные переводы для достижений, связанных с вашей игрой. Перед этим выполните шаги, описанные в разделе «Добавление переводов для вашей игры» .
Добавить переводы для вашей игры можно двумя способами:
Вы можете импортировать достижения , чтобы загрузить переводы сразу для нескольких новых достижений. Эту функцию нельзя использовать для загрузки переводов уже существующих достижений.
Вы можете добавить переводы для каждого достижения в вашей игре. Чтобы добавить собственный перевод для каждого достижения:
- В консоли Google Play откройте вкладку «Достижения» для вашей игры, затем выберите существующее достижение.
- На странице сведений о достижениях выберите вкладку языка, который вы ранее добавили на вкладке «Сведения об игре» .
- На странице сведений о достижении для этого языка отредактируйте форму, добавив в нее переводы для этого достижения.
- Нажмите «Сохранить» , чтобы сохранить переведенные сведения о достижении.
Клиентские реализации
Чтобы узнать, как реализовать достижения на вашей платформе, ознакомьтесь со следующими ресурсами:
Тестирование достижений
Чтобы убедиться, что достижения работают так, как задумано, выполните следующие действия по их тестированию:
- Организуйте внутренний испытательный полигон .
- Добавьте тестовые аккаунты в свой игровой проект для тестировщиков.
- Создайте профиль Play Games Services для одной из тестовых учетных записей с помощью приложения Play Games.
- Откройте игру, используя ту же тестовую учетную запись, для которой вы создали профиль Play Games Services.
- Убедитесь, что на экране отображается приветственное сообщение Play Games Services в качестве подтверждения успешной автоматической аутентификации при запуске игры.
- Играйте в игру и выполните необходимые действия, чтобы разблокировать достижения.
Для проверки достижений:
Убедитесь, что после выполнения достижения на экране отображается всплывающее окно «Достижение разблокировано».
Откройте приложение Play Store и убедитесь, что в разделе достижений на YouTab отображаются как выполненные, так и находящиеся в процессе выполнения достижения (с подробной информацией о ходе выполнения).
Отслеживайте достижения в Play Console
Вот как можно найти быструю статистику по индивидуальным достижениям:
- В консоли Google Play .
- Перейдите в Настройки > Игровые проекты .
- Выберите игру.
- В левом меню нажмите «Достижения» .
- На странице «Достижения» вы можете найти статистику, которая поможет вам понять, открывают ли ваши игроки достижения. Для тех, чьи достижения не скрыты, вы можете увидеть процент их открытия. Для достижений на ранних этапах процент открытия обычно близок к 100%.
Вы также можете отслеживать временные ряды динамики достижений на странице Grow > Play Games Services > Статистика игр .
Опубликуйте достижения
После завершения тестирования необходимо опубликовать игру. Все достижения в ней публикуются вместе с ней. Публикация достижений — это необходимый шаг для корректной работы достижений.
Чтобы опубликовать, выполните следующие действия:
- В консоли Google Play выберите игру.
- На странице «Сервисы Play Игр» — «Достижения» ( Развитие > Сервисы Play Игр > Настройка и управление > Достижения ) нажмите «Просмотреть и опубликовать» .
- На странице «Службы Play Игр» — «Публикация» ( Развитие > Службы Play Игр > Настройка и управление > Публикация ) просмотрите действия и исправьте проблемы.
- Нажмите «Опубликовать» .
Все ваши игровые достижения опубликованы.
Распространенные ошибки, которых следует избегать
Эти пункты освещают распространённые ошибки, которых следует избегать при реализации достижений в игре. Они подчёркивают важность:
В Play Console перейдите в раздел Grow > Play Games Services > Настройка и управление > Достижения .
- Перед публикацией убедитесь, что достижения, настроенные в Play Console, не находятся в состоянии «Черновик».
- Не добавляйте значения идентификаторов достижений из Play Console в код игры. Вместо этого используйте клиентские реализации .
Убедитесь, что вы также реализовали логику разблокировки на своем клиенте.
- Игроки не могут пропустить этап триггера, где вызывается API разблокировки. Например, прохождение обучения считается достижением, но игроки могут пропустить само обучение.