# Базовое руководство по интеграции Unity SDK
В этом руководстве рассказывается, как интегрировать Pushwoosh Unity SDK в ваше приложение.
## Предварительные требования
## Шаги интеграции
### 1. Добавьте Pushwoosh Unity SDK
Добавьте следующее в ваш файл `Packages/manifest.json`:
```json title="Packages/manifest.json"
{
"dependencies": {
"com.pushwoosh.unity.core": "6.2.7",
"com.pushwoosh.unity.android": "6.2.7",
"com.pushwoosh.unity.ios": "6.2.7"
},
"scopedRegistries": [
{
"name": "npmjs",
"url": "https://registry.npmjs.org",
"scopes": ["com.pushwoosh"]
}
]
}
```
Добавляйте только те пакеты платформ, которые вам нужны. Например, опустите `com.pushwoosh.unity.android`, если вы ориентируетесь только на iOS.
В Unity перейдите в **Window > Package Manager > + > Add package from git URL** и добавьте следующие URL-адреса один за другим:
```
https://github.com/Pushwoosh/pushwoosh-unity.git?path=com.pushwoosh.unity.core
https://github.com/Pushwoosh/pushwoosh-unity.git?path=com.pushwoosh.unity.android
https://github.com/Pushwoosh/pushwoosh-unity.git?path=com.pushwoosh.unity.ios
```
Загрузите `Pushwoosh.unitypackage` из [релизов на GitHub](https://github.com/Pushwoosh/pushwoosh-unity/releases) и импортируйте через **Assets > Import Package > Custom Package**.
### 2. Установите External Dependency Manager
SDK требует [External Dependency Manager for Unity (EDM4U)](https://github.com/googlesamples/unity-jar-resolver) для разрешения нативных зависимостей Android и iOS.
Добавьте следующий scoped registry в ваш файл `Packages/manifest.json`:
```json
{
"scopedRegistries": [
{
"name": "package.openupm.com",
"url": "https://package.openupm.com",
"scopes": ["com.google.external-dependency-manager"]
}
]
}
```
Затем добавьте пакет в ваши зависимости:
```json
"com.google.external-dependency-manager": "1.2.183"
```
### 3. Инициализируйте SDK
Создайте скрипт `PushNotificator.cs` и прикрепите его к любому GameObject на сцене:
```csharp title="PushNotificator.cs"
using UnityEngine;
using System.Collections.Generic;
public class PushNotificator : MonoBehaviour
{
void Start()
{
Pushwoosh.ApplicationCode = "XXXXX-XXXXX";
Pushwoosh.FcmProjectNumber = "XXXXXXXXXXXX";
Pushwoosh.Instance.OnRegisteredForPushNotifications += (token) => {
Debug.Log("Push token: " + token);
};
Pushwoosh.Instance.OnFailedToRegisteredForPushNotifications += (error) => {
Debug.Log("Registration failed: " + error);
};
Pushwoosh.Instance.RegisterForPushNotifications();
}
}
```
Замените:
- `XXXXX-XXXXX` на ваш Pushwoosh Application Code.
- `XXXXXXXXXXXX` на номер вашего проекта Firebase (только для Android).
### 4. Нативная настройка для iOS
#### 4.1 Capabilities
После сборки проекта iOS из Unity откройте сгенерированный проект Xcode и добавьте следующие capabilities в **Signing & Capabilities**:
- **Push Notifications**
- **Background Modes** с отмеченным пунктом **Remote notifications**
Для Time Sensitive Notifications (iOS 15+) также добавьте capability **Time Sensitive Notifications**.
#### 4.2 Info.plist
Добавьте [Pushwoosh Device API Token](/ru/developer/api-reference/api-access-token/#device-api-token) в ваш `Info.plist`:
```xml title="Info.plist"
Pushwoosh_API_TOKEN__PUSHWOOSH_DEVICE_API_TOKEN__
```
#### 4.3 Отслеживание доставки сообщений
Добавьте Notification Service Extension target в ваш проект Xcode. Это необходимо для точного отслеживания доставки и Rich Media на iOS.
Следуйте [нативному руководству](/ru/developer/pushwoosh-sdk/ios-sdk/setting-up-pushwoosh-ios-sdk/basic-integration-guide/#4-message-delivery-tracking), чтобы добавить extension target.
### 5. Нативная настройка для Android
#### 5.1 Добавьте файл конфигурации Firebase
Поместите файл `google-services.json` в директорию **Assets** вашего проекта Unity.
#### 5.2 Добавьте метаданные Pushwoosh
Добавьте [Pushwoosh Device API Token](/ru/developer/api-reference/api-access-token/#device-api-token) в ваш файл `Assets/Plugins/Android/AndroidManifest.xml` внутри тега ``:
```xml title="AndroidManifest.xml"
```
### 6. Запустите проект
1. Соберите и запустите проект на целевой платформе.
2. Предоставьте разрешение на получение push-уведомлений при запросе.
3. Перейдите в панель управления Pushwoosh и [отправьте push-уведомление](/ru/product/messaging-channels/push-notifications/send-push-notifications/one-time-push).
## Расширенная интеграция
На этом этапе вы можете отправлять и получать push-уведомления. В разделах ниже рассматривается основная функциональность SDK.
### Слушатели событий push-уведомлений
SDK предоставляет два слушателя событий для обработки push-уведомлений:
- `OnPushNotificationsReceived` — срабатывает при поступлении push-уведомления
- `OnPushNotificationsOpened` — срабатывает, когда пользователь нажимает на уведомление
Настройте этих слушателей во время инициализации SDK:
```csharp title="PushNotificator.cs"
void Start()
{
Pushwoosh.ApplicationCode = "XXXXX-XXXXX";
Pushwoosh.FcmProjectNumber = "XXXXXXXXXXXX";
Pushwoosh.Instance.OnPushNotificationsReceived += (payload) => {
Debug.Log("Push received: " + payload);
};
Pushwoosh.Instance.OnPushNotificationsOpened += (payload) => {
Debug.Log("Push opened: " + payload);
};
Pushwoosh.Instance.RegisterForPushNotifications();
}
```
### Конфигурация пользователя
Персонализируйте push-уведомления, идентифицируя пользователей и устанавливая их свойства:
```csharp
// Установить User ID для отслеживания на разных устройствах
Pushwoosh.Instance.SetUserId("user-123");
// Установить email пользователя
Pushwoosh.Instance.SetEmail("user@example.com");
// Установить пользователя с ID и email
Pushwoosh.Instance.SetUser("user-123", new List { "user@example.com" });
// Установить предпочитаемый язык
Pushwoosh.Instance.SetLanguage("en");
```
### Теги
Теги — это пары ключ-значение, присваиваемые устройствам, которые позволяют сегментировать пользователей и отправлять целевые сообщения:
```csharp
// Строковый тег
Pushwoosh.Instance.SetStringTag("favorite_category", "electronics");
// Целочисленный тег
Pushwoosh.Instance.SetIntTag("purchase_count", 5);
// Тег-список
Pushwoosh.Instance.SetListTag("interests", new List