Интегрируем достижения,Интегрируем достижения

Создать достижение

Чтобы получить достижение для новой, ещё не вышедшей игры, выполните следующие шаги:

1. В консоли Google Play выберите игру.
2. На странице «Достижения» в разделе «Службы Play Games» ( Развитие > Службы Play Games > Настройка и управление > Достижения ) выберите «Создать достижение» .
3. На странице «Добавить достижения» заполните форму.
4. Нажмите « Сохранить как черновик» .
5. После создания достижения необходимо опубликовать его .

Импорт достижений

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

1. Создайте ZIP-архив, содержащий ваши достижения.
2. Загрузите файл.

Для получения более подробной информации о ZIP-файле см. раздел «Рекомендации по работе с ZIP-файлами» .

Для импорта достижений:

1. В консоли Google Play выберите игру.
2. На странице «Достижения» в разделе «Службы Play Games» ( Развитие > Службы Play Games > Настройка и управление > Достижения ) выберите «Импорт достижений» .
3. На странице импорта достижений нажмите «Загрузить» .
4. Выберите ZIP-файл для загрузки.
5. Нажмите « Сохранить как черновик» .
6. После импорта достижений вам необходимо опубликовать игру .

Инструкции по заполнению ZIP-архива

С помощью ZIP-архива можно импортировать несколько достижений одновременно. Точные имена файлов для ZIP-архива указаны в таблице:

Требования к ZIP-файлу:

• Подкаталоги отсутствуют.
• Уникальные имена файлов.
• Только файлы CSV, PNG, JPEG или JPG.
• В CSV-файлах не должно быть строки заголовка.
• Размер каждого файла не должен превышать 1 МБ.
• Архив не должен содержать более 403 файлов.
• Общий размер ZIP-архива не должен превышать 800 МБ.

Формат AchievementsMetadata.csv

Файл AchievementsMetadata.csv содержит метаданные для каждого достижения. Информация должна быть представлена ​​в виде значений, разделенных запятыми, в следующем порядке:

    Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order

Эти поля описаны в следующей таблице:

Требования к файлу 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

Эти поля описаны в следующей таблице:

Требования к файлу 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

Эти поля описаны в следующей таблице.

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

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

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

Файлы значков

Значки, на которые вы ссылаетесь в файле AchievementsIconMappings.csv должны присутствовать в текущем импортируемом ZIP-архиве.

Редактировать достижения

Если у вас уже есть достижения и вы хотите их отредактировать:

1. В консоли Google Play выберите игру.
2. На странице «Достижения» в разделе «Службы Play Games» ( Развитие > Службы Play Games > Настройка и управление > Достижения ) выберите достижение.
3. Вы можете редактировать любое из полей.
4. Нажмите « Сохранить как черновик» .
5. На странице «Достижения» в разделе «Сервисы игр Play» отредактированное достижение находится в статусе «Доступно для тестировщиков».
6. После проверки достижения нажмите «Проверить и опубликовать» .

   Это повторно опубликует вашу игру, а также все ваши обновленные достижения.

Удалить достижение

После публикации достижение удалить его невозможно . Удалить достижение можно только в предварительно опубликованном состоянии.

1. На странице «Достижения» в разделе «Игровые сервисы Play Games» выберите достижение.
2. Чтобы удалить достижение, нажмите «Удалить достижение» .

Сбросить достижение

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

1. На странице «Достижения» в разделе «Игровые сервисы Play Games» выберите достижение.
2. Чтобы сбросить достижения, нажмите «Сбросить прогресс» .
3. Для программного сброса данных о достижениях вызовите методы API управления Achievements .