rustore / RuStore Unreal Engine Pay
CI/CD
Реестр контейнеров и пакетов

Домашняя страница

RU EN
🏠 Домой ❮ Назад

Unreal-плагин RuStore для приёма платежей

Плагин RuStorePayClient помогает интегрировать в ваш проект механизм оплаты. Поддерживаются версии Unreal Engine 5.3 и выше.

Установка плагина в свой проект

  1. Перейдите в раздел Релизы репозитория проекта на GitFlic.

  2. Скачайте из выбранного релиза артефакты:

    • RuStorePay.zip
    • RuStoreCore.zip

  3. Распакуйте скачанные архивы в папку Plugins внутри своего проекта, чтобы получилась следующая структура:

📁 your_project
└─ 📁 Plugins
   ├─ 📁 RuStorePay
   │  ├─ 📁 Resources
   │  ├─ 📁 Source
   │  └─ RuStorePay.uplugin
   └─ 📁 RuStoreCore
      ├─ 📁 Resources
      ├─ 📁 Source
      └─ RuStoreCore.uplugin

  1. Перезапустите Unreal Engine.

  2. В списке плагинов (Edit ➝ Plugins ➝ PROJECT ➝ Mobile) отметьте плагины RuStore Pay и RuStore Core.

  3. В файле YourProject.Build.cs в списке PublicDependencyModuleNames подключите модули RuStoreCore и RuStorePay.

  4. В настройках проекта (Edit ➝ Project Settings ➝ Android) установите параметры:

  5. Minimum SDK Version — не ниже 24;
  6. Target SDK Version — не ниже 34.

Обработка deeplink

Deeplink в RuStore SDK платежей нужна для корректной работы со сторонними приложениями оплаты. Она помогает пользователям быстрее совершать покупки в стороннем приложении и возвращаться в ваше приложение.

Плагин RuStore Pay автоматически добавит в AndroidManifest.xml активити RuStorePayIntentFilterActivity с intent-filter для обработки deeplink. Изменить это поведение можно в файле RuStorePay_Manifest_UPL.xml.

Подробнее о настройке deeplink см. в руководстве онлайн.

Инициализация SDK

Перед вызовом методов библиотеки необходимо выполнить её инициализацию.

URuStorePayClient::Instance()->Init();

Для работы SDK плагин RuStore Pay через RuStorePay_Manifest_UPL.xml добавит в AndroidManifest.xml данные console_app_id_value, internal_config_key и sdk_pay_scheme_value. Все значения располагаются внутри тэга <application>.

Все значения должны быть заданы в файле ресурсов, например: rustore_pay_values.xml.

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="rustore_PayClientSettings_consoleApplicationId">198332</string>
    <string name="rustore_PayClientSettings_internalConfigKey" translatable="false">unreal-engine</string>
    <string name="rustore_PayClientSettings_deeplinkScheme" translatable="false">yourappscheme</string>
</resources>

Файл ресурсов может быть включен в проект через UPL-файл вашего проекта:

<?xml version="1.0" encoding="utf-8"?>
<root xmlns:android="http://schemas.android.com/apk/res/android">
    <resourceCopies>
        <copyFile src="$S(PluginDir)/rustore_pay_values.xml" dst="$S(BuildDir)/res/values/rustore_pay_values.xml" />
    </resourceCopies>
</root>
  • consoleApplicationId — идентификатор вашего приложения в RuStore Консоли.
  • sdk_pay_scheme_value — схема deeplink.
  • internal_config_key — всегда имеет значение unreal-engine.

Package Name приложения должен совпадать с Package Name APK-файла, который вы публиковали в системе RuStore Консоль. Подпись keystore должна совпадать с подписью опубликованного приложения.

Подробнее об инициализации см. в руководстве онлайн.

Работа с SDK

Начните изучение документации библиотеки RuStore с методов класса URuStorePayClient. Или воспользуйтесь руководством онлайн.

Техническая поддержка

Дополнительная помощь и инструкции доступны в документации RuStore и по электронной почте support@rustore.ru.

Условия распространения

Данное программное обеспечение, включая исходные коды, бинарные библиотеки и другие файлы, распространяется под лицензией MIT. Информация о лицензировании доступна в документе MIT-LICENSE.