Перейти к основному содержимому

Unity GameCenter SDK — работа с игровым профилем

GameCenter SDK дает доступ к игровому профилю пользователя: можно получать текущие данные профиля и синхронизировать их с новыми данными.

На текущем этапе SDK работает только если на устройстве установлен RuStore и пользователь авторизован в RuStore. Если RuStore не установлен или пользователь не авторизован, методы вернут ошибку.

Условия подключения

Для подключения GameCenter SDK необходимо, чтобы в приложении уже был подключен Pay SDK.

Чтобы запросить подключение, отправьте письмо на support@rustore.ru с темой «подключение SDK game center».

В письме укажите:

  • <package_name> — имя пакета приложения, в которое планируется интеграция SDK;
  • наименование юридического лица, ИП или ФИО.

Подключение в проект​

Отключение репозитория artifactory-external

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-exposed
  • https://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 в зависимости от способа подключения.

🔹 Автоматическое подключение зависимостей

  1. Откройте файлы зависимостей установленных пакетов:
    • ru.rustore.gamecenter/Editor/GameCenterDependencies.xml.
    • ru.rustore.core/Editor/CoreClientDependencies.xml
  2. В каждом файле замените все вхождения старых адресов на новый.
  3. Принудительно обновите зависимости: Assets → External Dependency Manager → Android Resolver → Force Resolve.

🔹 Ручное подключение зависимостей

  1. Откройте файл Assets/Plugins/Android/settingsTemplate.gradle.
  2. Замените все вхождения старых адресов на новый.

Для подключения скачайте со страницы релизов пакеты:

  • ru.rustore.core-version.tgz
  • ru.rustore.gamecenter-version.tgz

Импортируйте пакеты в проект через Package Manager (Window → Package Manager → + → Add package from tarball...).

подсказка

Если вы используете операционную систему macOS, измените настройки утилиты архивации. В настройках Archive Utility снимите флажок Keep expanding if possible. В противном случае архив проекта будет скачан некорректно.

Для корректной обработки зависимостей SDK выполните следующие настройки.

  1. Откройте настройки проекта: Edit → Project Settings → Player → Android Settings.

  2. В pазделе Publishing Settings включите следующие настройки.

    • Custom Main Manifest.
    • Custom Main Gradle Template.
    • Custom Gradle Properties Template.
  3. В разделе 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 использовать как удобный слой синхронизации.