# Guia de integração básica do SDK do Unity
Este guia orienta você na integração do SDK do Pushwoosh para Unity em seu aplicativo.
## Pré-requisitos
## Passos de integração
### 1. Adicionar o SDK do Pushwoosh para Unity
Adicione o seguinte ao seu `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"]
}
]
}
```
Adicione apenas os pacotes de plataforma que você precisa. Por exemplo, omita `com.pushwoosh.unity.android` se você visa apenas o iOS.
No Unity, vá para **Window > Package Manager > + > Add package from git URL** e adicione as seguintes URLs uma por uma:
```
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
```
Baixe o `Pushwoosh.unitypackage` dos [Lançamentos do GitHub](https://github.com/Pushwoosh/pushwoosh-unity/releases) e importe via **Assets > Import Package > Custom Package**.
### 2. Instalar o External Dependency Manager
O SDK requer o [External Dependency Manager for Unity (EDM4U)](https://github.com/googlesamples/unity-jar-resolver) para resolver as dependências nativas do Android e iOS.
Adicione o seguinte registro com escopo ao seu `Packages/manifest.json`:
```json
{
"scopedRegistries": [
{
"name": "package.openupm.com",
"url": "https://package.openupm.com",
"scopes": ["com.google.external-dependency-manager"]
}
]
}
```
Em seguida, adicione o pacote às suas dependências:
```json
"com.google.external-dependency-manager": "1.2.183"
```
### 3. Inicializar o SDK
Crie um script `PushNotificator.cs` e anexe-o a qualquer GameObject na cena:
```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();
}
}
```
Substitua:
- `XXXXX-XXXXX` pelo seu Código de Aplicativo Pushwoosh.
- `XXXXXXXXXXXX` pelo número do seu projeto Firebase (apenas Android).
### 4. Configuração nativa do iOS
#### 4.1 Capabilities
Após construir o projeto iOS a partir do Unity, abra o projeto Xcode gerado e adicione as seguintes capabilities em **Signing & Capabilities**:
- **Push Notifications**
- **Background Modes** com **Remote notifications** marcado
Para Time Sensitive Notifications (iOS 15+), adicione também a capability **Time Sensitive Notifications**.
#### 4.2 Info.plist
Adicione o [Token de API de Dispositivo Pushwoosh](/pt/developer/api-reference/api-access-token/#device-api-token) ao seu `Info.plist`:
```xml title="Info.plist"
Pushwoosh_API_TOKEN__PUSHWOOSH_DEVICE_API_TOKEN__
```
#### 4.3 Rastreamento de entrega de mensagens
Adicione um alvo de Notification Service Extension ao seu projeto Xcode. Isso é necessário para o rastreamento preciso da entrega e Rich Media no iOS.
Siga o [guia nativo](/pt/developer/pushwoosh-sdk/ios-sdk/setting-up-pushwoosh-ios-sdk/basic-integration-guide/#4-message-delivery-tracking) para adicionar o alvo da extensão.
### 5. Configuração nativa do Android
#### 5.1 Adicionar arquivo de configuração do Firebase
Coloque o arquivo `google-services.json` no diretório **Assets** do seu projeto Unity.
#### 5.2 Adicionar metadados do Pushwoosh
Adicione o [Token de API de Dispositivo Pushwoosh](/pt/developer/api-reference/api-access-token/#device-api-token) ao seu `Assets/Plugins/Android/AndroidManifest.xml` dentro da tag ``:
```xml title="AndroidManifest.xml"
```
### 6. Executar o projeto
1. Compile e execute o projeto na sua plataforma de destino.
2. Conceda permissão para notificações push quando solicitado.
3. Vá para o Painel de Controle Pushwoosh e [envie uma notificação push](/pt/product/messaging-channels/push-notifications/send-push-notifications/one-time-push).
## Integração estendida
Nesta fase, você pode enviar e receber notificações push. As seções abaixo cobrem a funcionalidade principal do SDK.
### Listeners de eventos de notificação push
O SDK fornece dois listeners de eventos para lidar com notificações push:
- `OnPushNotificationsReceived` — acionado quando uma notificação push chega
- `OnPushNotificationsOpened` — acionado quando um usuário toca em uma notificação
Configure esses listeners durante a inicialização do 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();
}
```
### Configuração do usuário
Personalize as notificações push identificando usuários e definindo suas propriedades:
```csharp
// Define o ID do usuário para rastreamento entre dispositivos
Pushwoosh.Instance.SetUserId("user-123");
// Define o e-mail do usuário
Pushwoosh.Instance.SetEmail("user@example.com");
// Define o usuário com ID e e-mail
Pushwoosh.Instance.SetUser("user-123", new List { "user@example.com" });
// Define o idioma preferido
Pushwoosh.Instance.SetLanguage("en");
```
### Tags
Tags são pares de chave-valor atribuídos a dispositivos, permitindo a segmentação de usuários e o envio de mensagens direcionadas:
```csharp
// Tag de string
Pushwoosh.Instance.SetStringTag("favorite_category", "electronics");
// Tag de inteiro
Pushwoosh.Instance.SetIntTag("purchase_count", 5);
// Tag de lista
Pushwoosh.Instance.SetListTag("interests", new List