Unity GameCenter SDK — работа с игровым профилем
GameCenter SDK дает доступ к игровому профилю пользователя: можно получать текущие данные профиля и синхронизировать их с новыми данными.
На текущем этапе SDK работает только если на устройстве установлен RuStore и пользователь авторизован в RuStore. Если RuStore не установлен или пользователь не авторизован, методы вернут ошибку.
Для подключения GameCenter SDK необходимо, чтобы в приложении уже был подключен Pay SDK.
Чтобы запросить подключение, отправьте письмо на support@rustore.ru с темой «подключение SDK game center».
В письме укажите:
<package_name>— имя пакета приложения, в которое планируется интеграция SDK;- наименование юридического лица, ИП или ФИО.
Подключение в проект
30.09.2026 репозиторий artifactory-external.vkpartner.ru будет отключён. При использовании этого URL Gradle больше не сможет загрузить зависимости RuStore.
В плагинах версии 10.5.1 и выше используется рабочий репозиторий https://nexus-external.rustore.ru/repository/maven-rustore-exposed.
Если обновление в настоящий момент невозможно, замените в проекте все старые адреса репозитория:
https://artifactory-external.vkpartner.ru/artifactory/maven-rustore-exposedhttps://artifactory-external.vkpartner.ru/artifactory/maven
на новый адрес:
https://nexus-external.rustore.ru/repository/maven-rustore-exposed.
Устаревший адрес репозитория можно заменить вручную
Ручная замена устаревшего адреса репозитория
Замените https://artifactory-external.vkpartner.ru/... на новый https://nexus-external.rustore.ru/repository/maven-rustore-exposed в зависимости от способа подключения.
🔹 Автоматическое подключение зависимостей
- Откройте файлы зависимостей установленных пакетов:
ru.rustore.gamecenter/Editor/GameCenterDependencies.xml.ru.rustore.core/Editor/CoreClientDependencies.xml
- В каждом файле замените все вхождения старых адресов на новый.
- Принудительно обновите зависимости: Assets → External Dependency Manager → Android Resolver → Force Resolve.
🔹 Ручное подключение зависимостей
- Откройте файл
Assets/Plugins/Android/settingsTemplate.gradle. - Замените все вхождения старых адресов на новый.
- Установка через Package Manager
- Установка через .unitypackage
- Клонирование репозитория
Для подключения скачайте со страницы релизов пакеты:
ru.rustore.core-version.tgzru.rustore.gamecenter-version.tgz
Импортируйте пакеты в проект через Package Manager (Window → Package Manager → + → Add package from tarball...).
Если вы используете операционную систему macOS, измените настройки утилиты архивации. В настройках Archive Utility снимите флажок Keep expanding if possible. В противном случае архив проекта будет скачан некорректно.
Для подключения скачайте файл RuStoreUnityGameCenterSDK-version.unitypackage со страницы релизов и импортируйте его в проект (Assets → Import Package → Custom Package). Зависимости подключаются автоматически с помощью External Dependency Manager (включен в .unitypackage).
Если вы используете операционную систему macOS, измените настройки утилиты архивации. В настройках Archive Utility снимите флажок Keep expanding if possible. В противном случае архив проекта будет скачан некорректно.
Репозиторий содержит исходный код плагина и демонстрационный проект, содержащий представление работы всех методов SDK.
Не используйте кнопку "Код → Скачать" на сайте GitFlic – этот метод не загружает файлы из Git LFS.
Перед клонированием репозитория скачайте и установите инструменты:
После установки выполните в командной строке:
git lfs install
Для клонирования репозитория воспользуйтесь набором команд:
git clone https://gitflic.ru/project/rustore/unity-rustore-game-center-sdk.git
cd unity-rustore-game-center-sdk
git lfs pull
Для корректной обработки зависимостей SDK выполните следующие настройки.
-
Откройте настройки проекта: Edit → Project Settings → Player → Android Settings.
-
В pазделе Publishing Settings включите следующие настройки.
- Custom Main Manifest.
- Custom Main Gradle Template.
- Custom Gradle Properties Template.
-
В разделе Other Settings настройте:
- package name.
- Minimum API Level = 24.
- Target API Level = 34.
Работа с игровым профилем
Получение игрового профиля
Используйте метод GetGameProfile для асинхронного получения текущего профиля пользователя.
GameCenterClient.Instance.GetGameProfile(
onFailure: (error) => {
// Process error
},
onSuccess: (result) => {
// Process success
}
);
Синхронизация игрового профиля
Используйте метод SyncGameProfile для синхронизации профиля с новыми данными.
Рекомендуем экранировать JSON, передаваемый в параметр
data, чтобы вложенный JSON корректно передавался как строка (во избежание ошибок сериализации/десериализации).
var data = "{}";
GameCenterClient.Instance.SyncGameProfile(
data,
onFailure: (error) => {
// Process error
},
onSuccess: (result) => {
// Process success
}
);
Модель данных
GameProfile
Игровой профиль пользователя.
public class GameProfile {
public string data { get; }
}
data— строка с данными игрового профиля (формат определяете вы, обычно JSON).
Обработка ошибок
GameCenter SDK выбрасывает исключения — подклассы RuStoreGameCenterException.
Обрабатывайте их, чтобы показать пользователю корректные сообщения и предпринять действия.
GameCenterClient.Instance.GetGameProfile()
onFailure: (error) => {
switch (error) {
case RuStoreGameCenterException.RuStoreGameCenterUserUnauthorizedException:
// Пользователь не авторизован в RuStore
break;
case RuStoreGameCenterException.RuStoreGameCenterNetworkException:
// Сетевая ошибка
break;
case RuStoreGameCenterException.RuStoreGameCenterCommonException:
// Общая ошибка GameCenter (ошибка при извлечении данных из приложения RuStore)
break;
case RuStoreGameCenterException.RuStoreGameCenterClientAlreadyExist:
// Повторное создание клиента (экземпляр уже существует)
break;
case RuStoreGameCenterException.RuStoreGameCenterClientNotCreated:
// Доступ к клиенту до его создания
break;
default:
// Другая ошибка
},
onSuccess: (result) => {
// Process success
}
};
Доступные исключения:
RuStoreGameCenterException.RuStoreGameCenterUserUnauthorizedException— пользователь не авторизован в RuStore.RuStoreGameCenterException.RuStoreGameCenterNetworkException— сетевая ошибка.RuStoreGameCenterException.RuStoreGameCenterCommonException— общая ошибка GameCenter (не удалось получить данные из приложения RuStore).RuStoreGameCenterException.RuStoreGameCenterClientAlreadyExist— попытка создать несколько экземпляровGameCenterClient.RuStoreGameCenterException.RuStoreGameCenterClientNotCreated— обращение к клиенту до его инициализации.
Требования и рекомендации
-
Устройство пользователя: Android с установленным RuStore.
-
Пользователь должен быть вошедшим в RuStore.
-
Рекомендуем:
- Проверять авторизацию пользователя в RuStore перед вызовом методов SDK.
- Логировать ошибки
RuStoreGameCenterExceptionдля диагностики. - Хранить критичные данные прогресса и на стороне сервера, а GameCenter использовать как удобный слой синхронизации.