Push-technologie is een van de snelste manieren om meldingen aan gebruikers van uw applicatie te leveren. Om ze te ontvangen hoeft de gebruiker geen handelingen te verrichten, en ze worden geïnitieerd aan de serverzijde en verschijnen direct in de notificatiebalk op het scherm van het mobiele apparaat. In deze les zullen we begrijpen hoe we push-meldingen kunnen implementeren in toepassingen die gebouwd zijn op het AppMaster platform.
Send Push blok
Om push meldingen te versturen, Send Push worden blokken gebruikt die overeenkomen met het besturingssysteem van het doelapparaat (iOS of Android).
Push Token en Bundle ID
Om een verzending uit te voeren, moet u ten minste twee parameters opgeven: Push Token en IOS (Android) Bundle ID. Daarom is het de moeite waard te beginnen met het voorbereidende deel en uit te zoeken hoe je deze parameters krijgt.
Standaard bevat de database van elk project een Mobile Instance model dat gekoppeld is aan het User model en bevat de vereiste velden: push_token en bundle_id.
Laten we een apart bedrijfsproces maken voor de mobiele applicatie, dat het voltooide Mobile Instance model zal vormen. Om een push token te krijgen, gebruiken we het Get Push Token blok.
De volgende stap is het verkrijgen van informatie over het apparaat. En hier zullen, afhankelijk van het besturingssysteem, verschillende blokken nodig zijn. Daarom moet u, om het besturingssysteem te bepalen, het Platform Switch blok.
Afhankelijk van het resultaat, de bijbehorende IOS Device Info of Android Device Info blok gebruikt worden. Van daaruit kunt u allerlei informatie over het apparaat krijgen, maar in ons voorbeeld is het voldoende om alleen de Bundle ID.
Als alle gegevens verzameld zijn, kunt u een Mobile Instance model vormen, aangeven tot welk besturingssysteem het behoort en het doorgeven als uitvoerparameter van het bedrijfsproces.
Informatie vastleggen over het mobiele apparaat van de gebruiker
De volgende stap is het creëren van een backend bedrijfsproces voor het koppelen van de gegenereerde Mobile Instance met een specifieke gebruiker en opname in de database. Dit bedrijfsproces vereist het volgende:
- Achterhaal de huidige gebruiker met behulp van het Auth: Get current user blok.
- Breid de inhoud van het resulterende Mobile Instance model.
- Stel het model opnieuw samen en voeg er een gebruikersverbinding aan toe met behulp van het Make Mobile Instance blok.
- Gebruik de DB: Create Mobile Instance blok en sla de gegevens op in de database.
In het POST /Mobile Instance/ eindpunt kunt u het standaard bedrijfsproces vervangen door het proces dat zojuist is gemaakt.
De laatste fase van de voorbereiding is om te beslissen wanneer het precies de moeite waard is om informatie over het apparaat van de gebruiker in de database te schrijven. De logische oplossing zou zijn om dit te doen bij het uitvoeren van autorisatie in de applicatie. Om dit te doen, worden onmiddellijk na het Set Auth Token blok, twee nieuwe blokken met eerder aangemaakte bedrijfsprocessen worden toegevoegd aan het gebruikersautorisatieproces in de mobiele applicatie. De eerste ontvangt en genereert de benodigde informatie, en de tweede maakt een verbinding met de gebruiker en schrijft naar de database.
Pushberichten versturen
Het voorbereidende deel is voltooid, en u kunt beginnen met het verzenden van push-notificaties. Hiervoor zullen we een backend bedrijfsproces aanmaken. Stel je voor dat onze taak zal zijn om een notificatie te sturen naar alle gebruikers van onze applicatie. We sturen ze alleen naar apparaten met het besturingssysteem Android en niet naar alle apparaten van de gebruiker, maar alleen naar het apparaat dat het laatst is gebruikt.
Laten we beginnen met de invoerparameters. Het is noodzakelijk om de tekst van de melding zelf over te brengen. Deze bestaat uit drie delen: de body van de melding (body), de titel (title), en de ondertitel (subtitle).
Vervolgens moet u alle gebruikers van de toepassing vinden. Hiervoor gebruik je het Search User blok en stel je de nodige parameters in:
- _With = Mobile Instances (je moet niet alleen informatie krijgen over de gebruiker, maar ook over het mobiele apparaat dat ermee verbonden is)
- Limit = -1 (standaard retourneert de query 25 records, "-1" wordt opgegeven om deze limiet te verwijderen en alle gebruikers te krijgen)
- _mobile_instances_os = Android (volgens de voorwaarden van de opdracht zijn we alleen geïnteresseerd in Android apparaten)
Voor de gegenereerde array van gebruikers, moet je een cyclus van operaties uitvoeren (For each loop blok)
Voor elke gebruiker uit het Expand User blok, moet je informatie krijgen over mobiele apparaten (Mobile Instances). We moeten een melding sturen naar slechts één apparaat, dus we zetten index = 0 in het Array Element blok in en controleren ook of de array minstens één element bevat (een gebruiker kan immers maar één iOS apparaat hebben). Daartoe controleren we het element op geldigheid, geven de geldige indexwaarde door aan het If-Else blok, en gaan alleen verder met de lus als de waarde true.
Als alles correct is en er informatie over het apparaat van de gebruiker is gevonden, dan moet het Expand Mobile Instance blok en de nodige waarden doorgeven aan het Send Push (Android) blok.
Merk op dat bij het ontwikkelen en testen van een toepassing in de Developer App, u de Developer Mode = True.
U kunt ook de TTL (Time to live) optie. Deze bepaalt de tijd in seconden voor het versturen van de notificatie. Als de melding niet onmiddellijk kan worden afgeleverd, bijvoorbeeld als de gebruiker tijdelijk buiten bereik is, dan worden herhaalde afleverpogingen gedaan op de toegewezen tijd.
Aan het einde van de cyclus en het verzenden van meldingen aan alle mogelijke gebruikers is ook het werk van het bedrijfsproces voltooid.
Aanvullende parameters
Apart is het de moeite waard om aanvullende parameters van het zendblok te bespreken:
- Push ID
- Push Class
- Data
Ze hebben geen invloed op het feit van het verzenden van een melding of de inhoud ervan, maar kunnen worden gebruikt bij het verwerken van een melding aan de kant van de gebruiker. De mobiele toepassing heeft speciale triggers die worden afgevuurd wanneer een ontvangen push-notificatie wordt ontvangen of aangeklikt.
Push notification triggers bevatten gegevens van de bovengenoemde extra tekstparameters. Als voorbeeld kunnen we het eenvoudigste proces geven, dat, wanneer op de trigger wordt geklikt, een verdere melding op het scherm weergeeft met de informatie die is doorgegeven in de Data parameter.
Een ander populair gebruik voor triggers is het verzamelen van informatie over de levering van meldingen. Ze kunnen bijvoorbeeld een bericht naar de server sturen waarin staat dat een Push-melding inderdaad is afgeleverd, maar ook statistieken verzamelen en het aantal klikken op meldingen tellen.
