Démarrage rapide du SDK Unity

Démarrez avec le SDK Unity de Pushwoosh en utilisant cet exemple simple et rapide.

Prérequis

Pour intégrer le SDK Unity de Pushwoosh dans votre application, vous aurez besoin des éléments suivants :

Un compte Pushwoosh.
Un projet Pushwoosh configuré dans votre compte.
Pour l’intégration iOS :
- Une plateforme iOS configurée pour envoyer des notifications push. Nous recommandons d’utiliser la configuration d’authentification basée sur un token (Token-Based Authentication) car c’est l’approche la plus simple.
- Lors de la configuration, réglez la passerelle (Gateway) sur Sandbox pour envoyer des pushes à un simulateur.
Pour l’intégration Android :
- Une plateforme Android configurée
- Le numéro de projet (également appelé Sender ID), le fichier google-services.json et le nom du package de votre projet Firebase.
- Un projet Firebase connecté à votre application Android. Suivez le guide de configuration Firebase si nécessaire.
Votre Pushwoosh Application Code et votre jeton d’API de l’appareil Pushwoosh, disponibles dans le panneau de contrôle Pushwoosh (Pushwoosh Control Panel) de votre application.

Télécharger le projet d’exemple

Clonez le dépôt du projet d’exemple :

git clone https://github.com/Pushwoosh/pushwoosh-unity-sample.git

Configurer le projet

Ouvrez Assets/Scripts/PushNotificator.cs et définissez les valeurs d’initialisation de Pushwoosh :

Pushwoosh.ApplicationCode = "XXXXX-XXXXX";
Pushwoosh.FcmProjectNumber = "XXXXXXXXXXXX";

Remplacez les valeurs ApplicationCode et FcmProjectNumber par votre code d’application Pushwoosh et votre numéro de projet Firebase.

iOS

1. Définir l’identifiant de l’ensemble (Bundle Identifier)

Dans Unity, allez dans Edit > Project Settings > Player > iOS > Other Settings et définissez le Bundle Identifier sur l’ID de votre ensemble (par exemple, com.example.pushwoosh).

2. Compiler et installer les dépendances

Compilez le projet iOS depuis Unity. Ensuite, naviguez vers le répertoire du projet Xcode généré et installez les dépendances CocoaPods :

cd ios && pod install

3. Définir le jeton d’API

Ouvrez le fichier ios/Unity-iPhone.xcworkspace dans Xcode. Dans votre Info.plist, ajoutez le jeton d’API de l’appareil Pushwoosh :

<key>Pushwoosh_API_TOKEN</key>
<string>__PUSHWOOSH_DEVICE_API_TOKEN__</string>

Android

1. Définir le nom du package

Dans Unity, allez dans Edit > Project Settings > Player > Android > Other Settings et définissez le Package Name sur le nom du package de votre application (par exemple, com.example.pushwoosh).

2. Ajouter google-services.json

Copiez votre fichier google-services.json dans le répertoire Assets de votre projet Unity.

3. Définir le jeton d’API

Dans votre Assets/Plugins/Android/AndroidManifest.xml, ajoutez le jeton d’API de l’appareil Pushwoosh à l’intérieur de la balise <application> :

<meta-data android:name="com.pushwoosh.apitoken" android:value="__YOUR_DEVICE_API_TOKEN__" />

Exécuter le projet

Compilez et exécutez le projet.
Appuyez sur le bouton S’inscrire aux notifications push.
Accordez l’autorisation pour les notifications push. L’appareil sera enregistré auprès de Pushwoosh.

Envoyer une notification push

Allez dans le panneau de contrôle de Pushwoosh et envoyez une notification push à votre appareil enregistré.