La technologie "push" est l'un des moyens les plus rapides de transmettre des notifications aux utilisateurs de votre application. Pour les recevoir, l'utilisateur n'a pas besoin d'effectuer d'actions. Elles sont lancées côté serveur et apparaissent directement dans la barre de notification sur l'écran de l'appareil mobile. Dans cette leçon, nous allons comprendre comment mettre en œuvre les notifications push dans les applications construites sur la plateforme AppMaster.
Send Push bloc
Pour envoyer des notifications push, Send Push on utilise des blocs qui correspondent au système d'exploitation de l'appareil cible (iOS ou Android).
Obtenir Push Token et Bundle ID
Pour effectuer un envoi, vous devez spécifier au moins deux paramètres : Push Token et IOS (Android) Bundle ID. Il est donc utile de commencer par la partie préparatoire et de trouver comment obtenir ces paramètres.
Par défaut, la base de données de chaque projet contient un modèle Mobile Instance qui est lié au modèle User et qui contient les champs obligatoires : push_token et bundle_id.
Créons un processus métier distinct pour l'application mobile, qui formera le Mobile Instance modèle. Pour obtenir un jeton push, utilisez le bloc Get Push Token bloc.
L'étape suivante consiste à obtenir des informations sur l'appareil. Et ici, en fonction du système d'exploitation, différents blocs seront nécessaires. Par conséquent, pour déterminer le système d'exploitation, vous devez utiliser le bloc Platform Switch pour déterminer le système d'exploitation.
En fonction du résultat, le bloc correspondant IOS Device Info ou Android Device Info correspondant est utilisé. À partir de là, vous pouvez obtenir une variété d'informations sur le périphérique, mais dans notre exemple, il suffit de connaître le système d'exploitation Bundle ID.
Après avoir collecté toutes les données, vous pouvez former un Mobile Instance en indiquant à quel système d'exploitation il appartient et en le transmettant comme paramètre de sortie du processus métier.
Enregistrement d'informations sur l'appareil mobile de l'utilisateur
L'étape suivante consiste à créer un processus d'entreprise backend pour relier l'appareil généré à un utilisateur spécifique. Mobile Instance avec un utilisateur spécifique et l'enregistrement dans la base de données. Ce processus métier nécessite les éléments suivants :
- Trouver l'utilisateur actuel en utilisant le bloc Auth: Get current user bloc.
- Développez le contenu du modèle résultant Mobile Instance modèle résultant.
- Réassembler le modèle et y ajouter une connexion utilisateur à l'aide du bloc Make Mobile Instance à l'aide du bloc
- Utilisez le bloc DB: Create Mobile Instance et enregistrez les données dans la base de données.
Dans le POST /Mobile Instance/ endpoint, vous pouvez remplacer le processus métier standard par celui qui vient d'être créé.
La dernière étape de la préparation consiste à décider quand exactement il est utile d'écrire des informations sur le dispositif de l'utilisateur dans la base de données. La solution logique serait de le faire au moment de l'autorisation dans l'application. Pour ce faire, immédiatement après le bloc Set Auth Token deux nouveaux blocs avec des processus d'affaires précédemment créés doivent être ajoutés au processus d'autorisation de l'utilisateur dans l'application mobile. Le premier reçoit et génère les informations nécessaires, et le second crée une connexion avec l'utilisateur et écrit dans la base de données.
Envoi des notifications push
La partie préparatoire est terminée, et vous pouvez commencer à envoyer des notifications push. Pour ce faire, nous allons créer un processus métier backend. Imaginez que notre tâche sera d'envoyer une notification à tous les utilisateurs de notre application. Nous les enverrons uniquement aux appareils dotés du système d'exploitation Android et non pas à tous les appareils de l'utilisateur, mais seulement à celui qui a été utilisé en dernier.
Commençons par les paramètres d'entrée. Il est nécessaire de transférer le texte de la notification elle-même. Il se compose de trois parties : le corps du message (body), son titre (title) et le sous-titre (subtitle).
Ensuite, vous devez trouver tous les utilisateurs de l'application. Pour ce faire, utilisez le bloc Search User et définissez les paramètres nécessaires :
- _With = Mobile Instances (vous devez obtenir non seulement des informations sur l'utilisateur, mais aussi sur l'appareil mobile qui lui est associé).
- Limit = -1 (par défaut, la requête renvoie 25 enregistrements, "-1" est spécifié pour supprimer cette limite et obtenir tous les utilisateurs)
- _mobile_instances_os = Android (selon les conditions de la tâche, nous ne sommes intéressés que par Android devices)
Pour le tableau d'utilisateurs généré, vous devez exécuter un cycle d'opérations (For each loop bloc)
Pour chaque utilisateur du Expand User bloc, vous devez obtenir des informations sur les appareils mobiles (Mobile Instances). Nous avons besoin d'envoyer une notification à un seul appareil, donc nous définissons le paramètre index = 0 dans le bloc Array Element et vérifions également si le tableau contient au moins un élément (après tout, un utilisateur ne peut avoir qu'un seul appareil iOS ). Pour ce faire, nous vérifions la validité de l'élément, transmettons la valeur d'index valide au bloc If-Else et nous continuons la boucle seulement si la valeur est true.
Si tout est correct et que des informations sur le périphérique de l'utilisateur sont trouvées, il faut alors utiliser le bloc Expand Mobile Instance et transmettre les valeurs nécessaires au bloc Send Push (Android) au bloc.
Veuillez noter que lors du développement et du test d'une application dans l'environnement de travail de l'utilisateur. Developer Appvous devez définir le bloc Developer Mode = True.
Vous pouvez également utiliser l'option TTL (Time to live) Vous pouvez également utiliser l'option Elle définit le délai en secondes pour l'envoi de la notification. Si la notification ne peut pas être envoyée immédiatement, par exemple si l'utilisateur est temporairement hors de portée, des tentatives répétées d'envoi seront effectuées au bout du temps imparti.
À la fin du cycle et de l'envoi des notifications à tous les utilisateurs possibles, le travail du processus métier est également terminé.
Paramètres supplémentaires
Séparément, il convient de discuter des paramètres supplémentaires du bloc d'envoi :
- Push ID
- Push Class
- Data
Ils n'affectent pas le fait d'envoyer une notification ou son contenu mais peuvent être utilisés lors du traitement d'une notification du côté de l'utilisateur. L'application mobile dispose de déclencheurs spéciaux qui sont déclenchés lors de la réception ou du clic sur une notification push.
Les déclencheurs de notification push contiennent des données provenant des paramètres textuels supplémentaires ci-dessus. À titre d'exemple, nous pouvons donner le processus le plus simple qui, lorsque le déclencheur est cliqué, affiche une autre notification à l'écran avec les informations transmises dans le paramètre Data .
Un autre cas d'utilisation populaire des déclencheurs est la collecte d'informations sur la livraison des notifications. Par exemple, ils peuvent envoyer un message au serveur indiquant qu'une notification Push a bien été délivrée, mais aussi collecter des statistiques et compter le nombre de clics sur les notifications.
