С помощью игровых сервисов Google Play в игру можно добавить режим для нескольких участников и социальные функции.
Чтобы больше узнать об отдельных функциях и способах их настройки, выберите нужный вариант из приведенного ниже списка.
Начало работы
Как интегрировать пакет разработчика игровых сервисов Google PlayЧтобы узнать, как интегрировать SDK игровых сервисов Google Play, ознакомьтесь с инструкциями и примерами на сайте Google Developers.
Чтобы использовать игровые сервисы Google Play, добавьте сведения об игре в Play Console. Это не то же самое, что данные для Google Play.
Вот как это сделать:
- Откройте Google Play Console.
- Нажмите Настройка
> Проекты игр.
- Нажмите Добавить игру в правом верхнем углу экрана.
Функции
ДостиженияДостижения – это способ поощрения игроков за выполнение заданий, который делает игру ещё более увлекательной. Достигая определенных уровней, игроки зарабатывают очки опыта (XP).
Узнайте больше о достижениях на сайте Google Developers.
Примечание. Опубликованные достижения нельзя удалить.
Как добавить достижения
Если вы впервые добавляете достижения для игры с помощью Google Play Console, это можно сделать двумя способами:
- Создать, указав определения и прочие метаданные для каждого достижения по отдельности.
- Импортировать определения и прочие метаданные для нескольких достижений одновременно.
Примечание. Чтобы разблокировать достижения у игроков, вошедших в аккаунт, используйте API. При этом им станут доступны сведения о скрытых достижениях.
Как создать достижение
Чтобы добавить достижение в ещё не опубликованную игру, сделайте следующее:
- Выберите игру в Google Play Console.
- В разделе игровых сервисов Play перейдите к достижениям (Развитие > Игровые сервисы Play > Настройка и управление > Достижения) и нажмите Создать достижение.
- Заполните форму на открывшейся странице.
- Нажмите Сохранить как проект.
После этого вам потребуется опубликовать игру.
Как добавить больше достижений
Если в игре уже есть достижения, но вы хотите добавить другие, сделайте следующее:
-
Выберите игру в Google Play Console.
-
В разделе игровых сервисов Play перейдите к достижениям (Развитие > Игровые сервисы Play > Настройка и управление > Достижения) и нажмите Добавить достижения.
Как импортировать достижения
Чтобы добавить в игру несколько достижений одновременно, сделайте следующее:
1. Создайте ZIP-архив с достижениями.
2. Загрузите получившийся файл.
Дополнительную информацию о требованиях к ZIP-файлам можно найти в этом разделе.
Чтобы импортировать достижения, следуйте инструкциям ниже.
- Выберите игру в Google Play Console.
- В разделе игровых сервисов Play перейдите к достижениям (Развитие > Игровые сервисы Play > Настройка и управление > Достижения) и выберите Импортировать достижения.
- На открывшейся странице нажмите Загрузить.
- Выберите ZIP-файл.
- Нажмите Сохранить как проект.
- После этого вам потребуется опубликовать игру.
Как опубликовать достижения
Как изменить достижение
Чтобы изменить достижение, выберите его на вкладке Достижения в Google Play Console. Отредактируйте нужные поля в открывшейся форме.
Когда закончите, нажмите Сохранить как проект. После этого вы сможете протестировать достижение. Если оно работает правильно, выберите Повторная публикация в раскрывающемся списке. Игра будет опубликована, а достижения в ней обновятся.
Примечание. После публикации достижения изменить его исходный статус (скрытое или открытое) и тип (стандартное или пошаговое) нельзя.
Как отменить изменения
Как удалить достижение
Опубликованные достижения нельзя удалить.
Чтобы сделать это до публикации, нажмите Удалить внизу формы со сведениями о достижении.
Как сбросить достижения
Вы можете сбросить данные о прогрессе игроков только на этапе тестирования достижений.
- Для этого откройте форму со сведениями о достижении в Google Play Console и нажмите Сбросить текущие результаты в ее нижней части.
- Чтобы сбросить данные программно, используйте набор методов Achievements из Management API.
Требования к значкам
Разрешены значки размером 512 x 512 пикселей в формате PNG, JPEG или JPG. Необходимо предоставить значки только для разблокированных достижений. Версии в серых оттенках для открытых достижений будут генерироваться автоматически. Чтобы игрокам было проще понять, разблокировано достижение или нет, используйте значки с яркими элементами.
На устройствах Android значок показывается на тостах под круглой маской. Убедитесь, что при этом не обрезаются важные детали.
Пример значка достижения
Вид значка не меняется в зависимости от региона, поэтому не используйте текст и другой локализованный контент при оформлении.
Рекомендации по созданию ZIP-архива
Вы можете импортировать несколько достижений одновременно, загрузив ZIP-архив. В таблице ниже указаны допустимые названия и типы файлов в нем.
|
Название файла |
Наличие в архиве |
Допустимое содержимое |
|
|
Обязательно |
Метаданные для каждого достижения. Больше информации можно найти в этом разделе. |
|
|
Необязательно |
Переводы названий и описаний. |
|
|
Необязательно |
Сведения для сопоставления достижений с файлами значков. |
|
Необязательно |
Значки в формате PNG, JPEG или JPG. |
Требования к архиву:
- Архив не должен содержать подкаталоги.
- Названия файлов не могут повторяться.
- Допустимы форматы файлов CSV, PNG, JPEG или JPG.
- В файлах CSV не должно быть строк заголовков.
- Размер каждого файла – до 1 МБ.
- Максимальное количество файлов – 203.
- Размер архива – до 200 МБ.
Формат файла AchievementsMetadata.csv
Файл AchievementsMetadata.csv содержит метаданные для каждого достижения. Значения указываются через запятую в следующем порядке:
В таблице ниже представлены описания полей.
|
Заголовок столбца в файле CSV |
Наличие в файле |
Допустимое значение |
|
Name |
Обязательно |
Строка длиной до 100 символов. |
|
Description |
Необязательно |
Строка длиной до 500 символов. |
|
Incremental Value |
Необязательно |
True или False. |
|
Steps Needed |
Обязательно, если значение Incremental Value – True |
Целое число. |
|
Initial State |
Обязательно |
Hidden или Revealed. |
|
Points |
Обязательно |
Число, кратное пяти, максимальное значение – 200. |
|
List Order |
Необязательно |
Целое положительное число. |
Требования к файлу AchievementsMetadata.csv
- В каждой строке должно быть семь значений. Если какое-то из них вам не нужно, оставьте его поле пустым.
- Поля Name и Description используются для задания региональных настроек по умолчанию.
- Значение в поле Name должно быть уникальным для каждого достижения.
- В полях Name и Description нельзя использовать запятые.
Пример файла AchievementsMetadata.csv
Achievement1,,True,100,Hidden,5,20
Achievement2,,False,,Revealed,10,30
Формат файла AchievementsLocalizations.csv
Файл AchievementsLocalizations.csv содержит данные, необходимые для локализации достижений. Добавлять его в архив необязательно. Достижения переводятся на те же языки, которые указаны в сведениях об игре.
Значения указываются через запятую в следующем порядке:
В таблице ниже представлены описания полей.
|
Заголовок столбца в файле CSV |
Наличие в файле |
Описание |
Допустимое значение |
|
Name |
Обязательно |
Должно совпадать с полем Name в |
Строка длиной до 100 символов. |
|
Localized name |
Обязательно |
Локализованное название достижения. |
Строка длиной до 100 символов. |
|
Localized description |
Необязательно |
Локализованное описание достижения в указанном регионе. |
Строка длиной до 500 символов. |
|
Locale |
Обязательно |
Код языка, например en-US. |
Прежде чем указать код, убедитесь, что игра переведена на этот язык. Задать региональные настройки по умолчанию нельзя. Поддерживаемые коды перечислены в списке языков. |
Требования к файлу AchievementsLocalizations.csv
- Названия достижений могут повторяться только в разных языках. Например, если игра доступна на английском и французском языках, то английское название достижения может совпадать с французским.
- В каждой строке должно быть четыре значения. Если локализованного описания нет, оставьте поле Localized Description пустым.
Пример файла 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 используется, чтобы сопоставлять достижения со значками. Значения указываются через запятую в следующем порядке:
В таблице ниже представлены описания полей.
|
Заголовок столбца в файле CSV |
Наличие в файле |
Описание |
|
Name |
Обязательно |
Должно совпадать с полем 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
Файлы значков
AchievementsIconMappings.csv. Дополнительную информацию о требованиях к значкам можно найти в этом разделе.Как локализовать достижения
Вы можете добавить переводы достижений в вашу игру. Перед этим убедитесь, что сама игра уже переведена.
Добавить перевод можно двумя способами:
- Импортировать данные для нескольких достижений одновременно. Этот вариант не подходит, если достижения уже опубликованы.
- Указать перевод для каждого достижения по отдельности. Для этого сделайте следующее:
- Выберите игру в Google Play Console, перейдите на вкладку Достижения и нажмите на нужное.
- На странице достижения откройте вкладку языка, который ранее указали в сведениях об игре.
- Добавьте перевод в форму.
- Нажмите Сохранить.
Участники рейтингов могут сравнивать свои успехи с достижениями друзей и соревноваться с опытными игроками.
Примечание. Рейтинг игроков нельзя сбросить, но можно удалить или скрыть.
Чтобы автоматически скрывать подозрительные результаты, включите защиту от вмешательства. Это можно сделать на странице Рейтинги игроков вашей игры в Play Console.
Как создать рейтинг игроков
Чтобы добавить рейтинг в ещё не опубликованную игру, сделайте следующее:
- Выберите игру в Google Play Console.
- Нажмите Развитие > Игровые сервисы Play > Настройка и управление > Рейтинги игроков и выберите Создать рейтинг игроков.
- Укажите необходимые сведения.
- Нажмите Сохранить как проект.
- Когда вы опубликуете игру, рейтинги будут опубликованы вместе с ней.
Как создать рейтинг в опубликованной игре
Чтобы добавить рейтинг в опубликованную игру, следуйте инструкциям ниже. Дополнительную информацию о тестировании можно найти на этой странице.
Когда вы убедитесь, что рейтинг работает без ошибок, опубликуйте игру снова.
Как изменить рейтинг игроков
Чтобы изменить опубликованный рейтинг, выберите его на вкладке Рейтинги игроков в Google Play Console. Отредактируйте нужные поля в открывшейся форме.
Когда закончите, нажмите Сохранить как проект. После этого вы сможете протестировать рейтинг.
Если он работает правильно, выберите Опубликовать изменения в верхней части формы со сведениями о нем. Теперь обновленный рейтинг будет опубликован вместе с игрой.
Как отменить изменения
Как удалить рейтинг игроков
Рейтинг можно удалить, даже если он опубликован. Для этого откройте форму со сведениями о рейтинге в Google Play Console и нажмите Удалить рейтинг игроков в ее верхней части.
Чтобы скрыть рейтинги игроков в приложении, вы также можете использовать метод Players: hide.
Как сбросить рейтинг игроков
Вы можете сбросить данные о прогрессе игроков только на этапе тестирования рейтинга.
- Для этого нажмите Сбросить прогресс в верхней части страницы с рейтингом в Google Play Console.
- Чтобы сбросить данные программно, используйте набор методов Scores из Management API.
Как локализовать рейтинги
Вы можете добавить переводы рейтингов в вашу игру. Перед этим убедитесь, что сама игра уже переведена и в ней опубликован хотя бы один рейтинг.
Чтобы добавить перевод рейтинга, выберите его на вкладке Рейтинги игроков в Google Play Console. На странице рейтинга откройте вкладку языка, который ранее указали в сведениях об игре. Добавьте перевод в форму. Нажмите Сохранить.
Как скрыть результаты в рейтинге игроков
В игровых сервисах Google Play есть защита от вмешательства, автоматически скрывающая в рейтинге результаты, которые могли быть получены нечестным путем. Эта функция поддерживает только игры для Android.
Защита от вмешательства включена по умолчанию для новых рейтингов. Чтобы включить ее для уже опубликованных рейтингов, сделайте следующее:
- Выберите игру из списка на вкладке игровых сервисов в Google Play Console.
- Перейдите к Рейтингам игроков и выберите нужный.
- Включите защиту от вмешательства.
- Нажмите Сохранить и продолжить.
- Опубликуйте игру.
После этого функция включится в течение 24 часов. Результаты, добавленные в рейтинг до того, как вы включили защиту от вмешательства, скрыты не будут.
В некоторых случаях защиту лучше отключать. Например, если у вашей игры есть не только мобильная, но и веб-версия, а результаты игроков попадают в один рейтинг.
Узнайте больше о сохранении игр на сайте Google Developers.
Как включить сохранение игр
Чтобы включить сервис сохранения игр, сделайте следующее:
- Выберите игру в Google Play Console.
- Откройте страницу Конфигурация (Развитие > Игровые сервисы Play > Настройка и управление > Конфигурация) и выберите Изменить свойства.
- Включите параметр Сохраненные игры.
- Нажмите Сохранить.
После этого функция включится в течение 24 часов. Если вы хотите протестировать ее сразу, удалите вручную данные приложения "Сервисы Google Play" на устройстве для тестирования.
Чтобы очистить кеш на устройстве Android, откройте Настройки > Приложения > Сервисы Google Play. Выберите Управление местом, а затем Удалить все данные.
Дополнительную информацию о сохранении игр можно найти на этой странице.
Как локализовать сохраненные игры
Вы можете добавить переводы игровых данных, например отображаемого названия, описания и графических объектов, а также достижений и рейтингов игроков.
Чтобы перевести сведения об игре, сделайте следующее:
- Выберите игру в Google Play Console.
- Откройте страницу Конфигурация (Развитие > Игровые сервисы Play > Настройка и управление > Конфигурация).
- Нажмите Изменить свойства.
- Выберите Переводы > Управлять собственными переводами.
- Укажите нужные языки и нажмите Применить. Нажмите на язык в списке на странице Свойства.
- Добавьте перевод для отображаемого названия, описания и графических объектов.
- Нажмите Сохранить изменения.
Дополнительную информацию можно найти в разделах о локализации достижений и рейтингов игроков.
Чтобы показывать сведения об игре, рейтинги и достижения, игровые сервисы Play используют наиболее подходящий язык из поддерживаемых игрой. Например, если в языковых настройках устройства выбран канадский вариант французского, а в игре его нет, пользователь увидит информацию на стандартном французском.
Как разрешить пользователям изменять настройки игровых сервисов
С помощью Google Play Game Services Publishing API можно автоматизировать настройку приложений и интегрировать выпуски в существующие инструменты и процессы. Вот как включить доступ к API:
- Откройте Google Play Console.
- Нажмите Настройка
> Доступ к API.
- При необходимости создайте связанный проект.
- Рядом с Games configuration API нажмите кнопку Включить.
Как управлять аккаунтами нескольких пользователей
Чтобы позволить управлять играми в своем аккаунте разработчика нескольким пользователям, настройте для них разрешения в Play Console на странице Пользователи и разрешения.