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

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

Facebook Cloud доступен для платформ Android и Desktop(Windows)

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

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

1. Сбор статистики (Модуль MRGService).
2. GDPR & CCPA (Модуль MRGSGDPR). (Только на Android)
3. Платежи через Facebook Cloud (Модуль MRGSBilling).
4. Авторизация в Facebook Cloud (Модуль MRGSAuthentication) - Только функционал Facebook. Amazon, Google, VK и прочие авторизации не поддерживаются.
5. Facebook Cloud уведомления (Модуль MRGSNotifications).

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

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

• Затем заведите приложение на сайте MRGS с параметром платформы "FacebookCloud".

• Заполните Bundle ID указав в нем ID приложения из созданного вами проекта в Facebook Cloud.

Подключение Facebook Cloud SDK (Android)🔗

• Для работы авторизации, платежей и push-уведомлений нужно подключить Facebook Cloud SDK к вашему проекту в gradle файл.

    dependencies {
        // ... other libraries
        implementation 'com.facebook.android:facebook-gamingservices:16.0.1'
    }

• Также добавьте параметры в ваш manifest файл согласно документации Facebook

    <application android:label="@string/app_name" ...>
        ...
        <meta-data android:name="com.facebook.sdk.ApplicationId" android:value="@string/facebook_app_id"/>
        <meta-data android:name="com.facebook.sdk.ClientToken" android:value="@string/facebook_client_token"/>
        ...
    </application>

• При инициализации MRGService SDK крайне важно выставить тип биллинга, от него зависит поведение всех остальных модулей.

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, and FacebookCloud
        serviceParams.AndroidExtraOptions.Platform = MRGSPlatformAndroid.FacebookCloud;

        // 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 and FACEBOOK_CLOUD
        final MRGServiceParams serviceParams
                = MRGServiceParams.init(<MRGS_APP_ID>, <CLIENT_SECRET>, MRGSPlatform.FACEBOOK_CLOUD)

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

Подключение Facebook Cloud SDK (Desktop)🔗

Для включения работы с Facebook Cloud необходимо выставить define MRGS_FACEBOOK_CLOUD_STORE, а также подключить модуль games.my.mrgs.fbcloud (доступен через UPM и как unitypackage, как и все остальные модули MRGS. Содержит в себе Facebook SDK для работы с Cloud, важно отметить, что данное SDK не может быть в проекте вместе с официальным SDK Facebook версии 12 и выше).

Также, при старте MRGS необходимо передать facebook app id:

MRGSExternalSDKParams sdkParams = new MRGSExternalSDKParams();
// ...

sdkParams.FacebookParams = MRGSFacebookParams.initWithAppId("APP_ID");

// MRGS initialization
// ...

GDPR (Android)🔗

Так как Facebook Cloud пока не поддерживает открытие внешних ссылок, нужно выставить доп. флаг в MRGSGDPR, чтобы все кликабельные ссылки в html открывались в WebView.

MRGSGDPR.getInstance().setUseWebViewForExternalLinks(true);
// other settigs if necessary
// then show GDPR

final MRGSGDPR instance = MRGSGDPR.getInstance();
instance.setUseWebViewForExternalLinks(true);
// other settings if necessary
// then show GDPR

Если вы используете свои нативные окна для показа GDPR, то для открытия GDPR ссылок можете воспользоваться следующим методом:

MRGSGDPR.getInstance().openLinkInWebView(url, title (optional));

final MRGSGDPR instance = MRGSGDPR.getInstance();
instance.openLinkInWebView(context, title, url);

Авторизация🔗

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

Пуш-Уведомления🔗

Настройте пуш-уведомления согласно документации Facebook

Настройки окружения🔗

Чтобы получить Секрет приложения для отправки пуш-уведомлений:

1) Зайдите на сайт Facebook for Developers.
2) Перейдите в ваше приложение.
3) Слева на панели, перейдите в Настройки -> Основное.
4) Скопируйте Секрет приложения (См. скриншот ниже).

5) Откройте сайт MRGS и зайдите в меню редактирования приложения

6) Перейдите в раздел Дополнительные возможности и скопируйте секрет из буфера в поле Ключ для отправки PUSH нотификаций

7) Нажмите кнопку Сохранить

Иконка пуш-уведомления🔗

Если вы хотите использовать в уведомлениях иконки отличные от иконок приложения, укажите их имена файлов при инициализации MRGS (имя файла с иконкой, без расширения png, который лежит в директории res/drawable-nodpi/ вашего проекта).

Платежи🔗

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

Настройки окружения🔗

Чтобы получить Секрет приложения для проверки платежей:

1) Зайдите на сайт Facebook for Developers.
2) Перейдите в ваше приложение.
3) Слева на панели, перейдите в Настройки -> Основное.
4) Скопируйте Секрет приложения (См. скриншот ниже).

5) Откройте сайт MRGS и зайдите в меню редактирования приложения

6) Скопируйте секрет из буфера в поле Секретный ключ для проверки платежей

7) Нажмите кнопку Сохранить

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

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

Загрузка сборки (Android)🔗

• Для загрузки дистрибутива в Facebook Cloud, следуйте инструкции.

• Также стоит отметить, что Facebook Cloud не хранит состояние приложения, если вы не укажите ему какие файлы и директории нужно сохранять. Поэтому, перед заливкой приложения, укажите все необходимые вам файлы в специальном поле.

• Добавьте следующие пути для корректной работы MRGS SDK:

/data/data/<your_applicationId>/Documents/*
/data/data/<your_applicationId>/shared_prefs/HOST_SETTINGS.xml
/data/data/<your_applicationId>/shared_prefs/mrgs.gdpr.xml
/data/data/<your_applicationId>/shared_prefs/mrgsccpa.xml
/data/data/<your_applicationId>/shared_prefs/mrgsgdpr.xml
/data/data/<your_applicationId>/shared_prefs/open_udid_cache.xml
/data/data/<your_applicationId>/shared_prefs/idfa_cache.xml
/data/data/<your_applicationId>/shared_prefs/UserDefaultsKey.xml

Где <your_applicationId> - Bundle Id вашего приложения(Это не ID приложения который вы указали в MRGS консоли на этапе Создание проекта).

Поиск проблем (Android)🔗

• Для тестирования и отладки приложения можно воспользоваться Журналом отладки игры в облаке.