Подключение и инициализация

AppMetrica Push Unity — это плагин для игровой платформы Unity3d, включающий поддержку AppMetrica Push SDK для платформ Android и iOS.

Перед началом работы с плагином AppMetrica Push Unity необходимо подключить и инициализировать плагин AppMetrica Unity не ниже версии 4.0.0.

Внимание

Для обновления плагина удалите из проекта директорию Assets/AppMetricaPush и импортируйте плагин новой версии (обратите внимание на особенности настройки Android).

Интеграция плагина

Примечание

Плагин использует External Dependency Manager for Unity для разрешения зависимостей.

Шаг 1. Загрузите AppMetrica Push Unity плагин.

Шаг 2. Добавьте плагин в проект — откройте проект в Unity Editor, импортируйте плагин AppMetricaPush.unitypackage (Assets → Import Package → Custom Package).

Шаг 3. Откройте папку Assets/AppMetricaPush/ и перетащите префаб AppMetricaPush с помощью мыши на главную сцену проекта.

Если плагин интегрирован данным образом, скрипт AppMetricaPush на добавленном префабе автоматически инициализирует AppMetrica Push SDK.

Добавленный префаб AppMetricaPush является синглтоном. Он не удаляется при переходе в новую сцену Unity и удаляет другие объекты, на которых будет установлен скрипт AppMetricaPush.

Настройка плагина

  1. Добавьте SSL-сертификат в AppMetrica по инструкции.

  2. Чтобы получать push-уведомления, запросите у пользователя разрешение. Рекомендуется использовать Unity-пакет Mobile Notifications и запрашивать разрешение по инструкции.

Примечание

AppMetrica Push Unity Plugin использует механизм swizzling для своей работы: перехватывает выполнение некоторых методов класса UnityAppController используя ObjectiveC runtime. Код механизма представлен в файле AppMetricaPush/Plugins/iOS/YMPBridge.m

  1. Настройте приложение для использования Firebase. Получите и добавьте в AppMetrica ключ сервера для использования Firebase Cloud Messaging.

  2. Чтобы настроить AndroidManifest.xml, внесите изменения в элемент application файла AndroidManifest.xml:

    <meta-data android:name="ymp_firebase_default_app_id" android:value="APP_ID"/>
<meta-data android:name="ymp_gcm_default_sender_id" android:value="number:SENDER_ID"/>
<meta-data android:name="ymp_firebase_default_api_key" android:value="API_KEY"/>
<meta-data android:name="ymp_firebase_default_project_id" android:value="PROJECT_ID"/>

    APP_ID — идентификатор приложения в Firebase. Его можно узнать в консоли Firebase: перейдите в Настройки проекта. В разделе Ваши приложения скопируйте значение поля Идентификатор приложения.

    SENDER_ID— уникальный идентификатор отправителя в Firebase. Его можно узнать в консоли Firebase: перейдите во вкладку Настройки проекта → Cloud Messaging и скопируйте значение поля Идентификатор отправителя.

    API_KEY — ключ приложения в Firebase. Его можно найти в поле current_key файла google-services.json. Файл можно скачать из консоли Firebase.

    PROJECT_ID — id приложения в Firebase. Его можно найти в поле project_id файла google-services.json. Файл можно скачать из консоли Firebase.

    Примечание

    Если вы используете пример интеграции AppMetrica Push SDK, измените значение атрибута package в элементе manifest на package id вашего приложения.

    В каталоге Assets/AppMetricaPush/Plugins/Android/ находится пример файла AndroidManifest.xml

См. также

Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.

Написать в службу поддержки
Предыдущая
Примеры использования методов
Следующая
Миграция приложения с GCM на Firebase
В этой статье: