Procédure WLangage appelée

• <Identifiant> : Buffer "token" correspondant à l'identifiant d'enregistrement retourné par le service de notification. Ce buffer doit ensuite être transmis au serveur d'application afin qu'il puisse envoyer des notifications push à l'application.
  Attention : Ce buffer doit être transmis au serveur d'application :
  • lorsque sa valeur a changé par rapport à la précédente exécution de l'application. Il faut pour cela mémoriser sa valeur dans un fichier de données de l'application ou dans un buffer sur disque créé avec les fonctions fSauveBuffer ou SauveParamètre.
  • si l'application est lancée par l'utilisateur (et non par l'arrivée d'une notification push). La fonction ExeInfo permet de savoir si l'application est lancée par l'arrivée d'une notification.
  Ce buffer peut être vide si une erreur d'enregistrement s'est produite lors de la demande d'enregistrement. Dans ce cas, le paramètre <Erreur> sera renseigné avec le message d'erreur.
  
  Le buffer qui correspond à l'identifiant peut contenir des caractères non imprimables (comme des zéros binaires). Pour transmettre ce buffer à une application tierce, par exemple à l'application qui fera l'envoi des notifications, il peut être nécessaire de convertir ce buffer en hexadécimal (fonction BufferVersHexa) ou en Base 64 (fonction Encode) selon le format attendu par l'application tierce. Si l'application tierce (qui récupère les données) est une application WINDEV/WEBDEV/WINDEV Mobile, la conversion inverse devra être effectuée (fonctions HexaVersBuffer ou Décode) pour pouvoir envoyer les notifications.
• <Erreur> : Chaîne de caractères décrivant une erreur d'enregistrement. Ce paramètre est renseigné uniquement si une erreur est survenue durant la demande d'enregistrement.

Cas particuliers

• Cette fonction peut être appelée uniquement si l'application dispose d'un certificat pour les notifications push.
• Si la fonction est appelée plusieurs fois lors de la même exécution de l'application, seul le premier appel est pris en compte.
• L'appareil communique avec le service de notification Google Cloud Messaging (GCM) en utilisant les ports suivants 5228, 5229 et 5230. Veillez à configurer si nécessaire votre firewall en conséquence.
• Si le service de notification Google Cloud Messaging n'a pas pu être contacté au moment de l'appel de la fonction NotifPushActive (problème de connectivité réseau par exemple), la demande d'enregistrement sera automatiquement réitérée avec un intervalle de temps de plus en plus important (1 heure maximum) jusqu'à ce que la demande aboutisse ou qu'une erreur soit levée. Il peut donc se passer un délai relativement long entre l'appel de la fonction NotifPushActive et l'appel de la procédure passée en paramètre.
• La fonction NotifPushActive est asynchrone car elle exécute une requête :
  • sur le serveur de Apple pour iOS.
  • sur le serveur de Google dans le cas d'Android.
    A partir de Android 12, le délai nécessaire pour obtenir le token lors de la première installation ou lors de la réinstallation d'une application est supérieur à celui des anciennes versions. La procédure WLangage appelée par la fonction NotifPushActive peut donc être exécutée après la fin de l'initialisation du projet, ou après l'ouverture de la première fenêtre.