Подключение MRGS ONEstore🔗

MRGS ONEstore является дополнительным поведением для уже имеющегося модуля MRGS (MRGSBilling). Поэтому достаточно будет указать платформу ONESTORE при конфигурации и инициализации MRGS SDK чтобы изменить поведение. На данной странице будут отмечены лишь основные нюансы подключения и использования MRGS ONEstore.

ONEStore доступен только для платформы Android.

Поддерживаемые модули🔗

На данный момент поддерживаются следующие модули:

1. Платежи через ONEStore (Модуль MRGSBilling).

Создание проекта🔗

• Для создания проекта в ONEstore следуйте документации
• Затем заведите приложение на сайте MRGS с параметром платформы "OneStore".

Подключение ONEstore🔗

• Добавьте в ваш root build.gradle файл репозиторий

buildscript {
    repositories {
        ...
        maven { url 'https://repo.onestore.co.kr/repository/onestore-sdk-public' }
        ...
    }
    ...
}

• При инициализации MRGService SDK крайне важно указать платформу ONESTORE, от нее зависит поведение модуля платежей.

using MRGS;

public class MasterController : MonoBehaviour
{
    void Awake()
    {
        var serviceParams = new MRGServiceParams(appId: APP_ID, appSecret: APP_SECRET);
        // Setting MRGServiceParams
        // ...

        // Requires Platform for Android application
        // Available platforms: Amazon, Android, Huawei, Samsung, FacebookCloud, RStore, Onestore
        serviceParams.AndroidExtraOptions.Platform = MRGSPlatformAndroid.Onestore;

        // Settings external SDK and initializing MRGS SDK
        // ...
    }
}

import games.my.mrgs.MRGSPlatform;
import games.my.mrgs.MRGService;
import games.my.mrgs.MRGServiceParams;

public class YourApplicationClass extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        // Setting MRGService
        // Available MRGSPlatform: AMAZON, ANDROID, HUAWEI, SAMSUNG, FACEBOOK_CLOUD, RSTORE, ONESTORE
        final MRGServiceParams serviceParams
                = MRGServiceParams.init(<MRGS_APP_ID>, <CLIENT_SECRET>, MRGSPlatform.ONESTORE)

        // Settings external SDK and initialization MRGS SDK
        // ...
    }
}

In-app платежи🔗

• Для создания платежей в ONEstore, следуйте инструкции.

• Добавьте модуль MRGSBank (MRGSBilling)

  Unity:

  Добавление в проект (общая инструкция)

  Unity Package ManagerРучная интеграция (unitypackage или tgz)

  Шаг 1. Добавьте источники

  Для того, чтобы добавить MRGS в проект через Unity Package Manager (доступно с Unity 2018+) просто добавьте в файл Packages/manifest.json раздел scopedRegistries, добавив в него следующую запись:

  {
      "dependencies": {
          ...
      },
      "scopedRegistries": [
              {
                  "name": "MRGS",
                  "url": "https://mrgs-nexus.my.games/repository/mrgs-uninty-plugins/",
                  "scopes": [
                      "games.my.mrgs"
                  ]
              }
      ]
  }
  

  Альтернативно, можно нажать Edit -> Project Settings -> Package Manager -> '+' in scoped registry section, и заполнить поля в соответствии с данными выше.

  Шаг 2. Добавьте зависимость

  • Нажмите Window -> Package Manager -> select 'Packages: MyRegistries' from dropdown list, выберите пакет MRGSBank из списка, затем нажмите "Install"
  • Импортируйте модуль: using MRGS;

  • Загрузите последнюю версию библиотеки. Распакуйте архив.
  • (Для интеграции unitypackage) В Unity нажмите Assets -> Import Package -> Custom Package, и выберите пакет games.my.mrgs.bank.unitypackage из скачанного архива.
  • (Для интеграции tgz) В Unity нажмите Window -> Package Manager -> '+' -> Add package from tarball, и выберите пакет games.my.mrgs.bank-<version>.tgz из скачанного архива.
  • Импортируйте модуль: using MRGS;

  Android:

  Gradle установкаРучная установка

  dependencies {
  def mrgsVersion = "6.x.x"
  implementation "games.my.mrgs:billing:$mrgsVersion"
  }
  

  Скопируйте файл MRGSBilling.aar в директорию libs вашего проекта. Добавьте необходимые зависимости в файл build.gradle

  1 2 3 4 5 6 7 8 9 10

  ```Java dependencies { ... implementation(name: 'MRGSBilling', ext:'aar') implementation 'androidx.appcompat:appcompat:1.6.1' implementation 'com.android.billingclient:billing:6.0.1' implementation 'com.onestorecorp.sdk:sdk-iap:21.01.00' ... } ```

Совершение платежей🔗

Механизм платежей в SDK не претерпел каких либо изменений, поэтому для работы с функционалом MRGSBank можно обратиться к инструкции.