Difference between revisions of "Native Push (Client)"
(Created page with "{{UnderConstructionStart}} Just like the {{UBIK}} push service, {{UBIK}} native push also aims to ensure that the server side can actively deliver...") |
|||
(3 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
− | |||
− | |||
Just like the [[Push_Service_(Client)|{{UBIK}} push service]], {{UBIK}} native push also aims to ensure that the server side can actively deliver messages to the clients. However, it has a few major differences by comparison. | Just like the [[Push_Service_(Client)|{{UBIK}} push service]], {{UBIK}} native push also aims to ensure that the server side can actively deliver messages to the clients. However, it has a few major differences by comparison. | ||
* The native push uses the existing 3rd party solutions/infrastructure and is, therefore, dependent on the availability of those. | * The native push uses the existing 3rd party solutions/infrastructure and is, therefore, dependent on the availability of those. | ||
Line 9: | Line 7: | ||
{{Attention|Native push is only supported on the two mobile clients: Xamarin Android and Xamarin iOS.}} | {{Attention|Native push is only supported on the two mobile clients: Xamarin Android and Xamarin iOS.}} | ||
− | == | + | {{Attention|You can terminate the app (swipe it away in the task list) or even restart the device, and the native pushes will still arrive. But on some Android devices, you will no longer receive pushes if you "Force stop" it in the app settings.}} |
+ | |||
+ | == Native push types == | ||
Currently, the only supported push type is text messages. Upon clicked, they simply launch the {{UBIK}} client or bring it to the foreground if that's not the state of it yet. | Currently, the only supported push type is text messages. Upon clicked, they simply launch the {{UBIK}} client or bring it to the foreground if that's not the state of it yet. | ||
− | == | + | == Native push settings == |
− | You can turn native push on/off in the app's General settings section. | + | You can turn native push on/off in the app's General settings section via the [[Settings#Push|"Activate native push" setting]]. |
+ | |||
+ | {{Hint|If you use multiple profiles on the same device, it's possible that you continue receiving native pushes even after turning it off. Because the device might still be configured to receives them for the other profiles.}} | ||
=== Technical background === | === Technical background === | ||
− | In order to properly determine which pushes to receive, the client requires access to | + | In order to properly determine which pushes to receive or not, the client requires access to [[SYSCLS_PUSH_TOPIC|push topics]] from the server side. |
+ | When you login (online or offline), the client checks all available push topics and maintains the topic subscriptions accordingly. This also happens when you change the "Activate native push" setting to turn it on. | ||
+ | * When you turn it off, the client unsubscribes from all topics available to the current user session. | ||
− | {{ | + | {{Hint|The "Activate native push" setting is only enabled during a user session because it's only possible to maintain topic subscriptions with push topic objects.}} |
+ | |||
+ | {{Attention|If you clear the app data or reinstall the app, all existing push topic subscriptions will be reset and you won't receive any pushes until you login with native push enabled again.}} | ||
[[Category:Client|Native Push (Client)]] | [[Category:Client|Native Push (Client)]] | ||
− | |||
[[Category:Version 4.8|Native Push (Client)]] | [[Category:Version 4.8|Native Push (Client)]] | ||
+ | [[Category:Xamarin|Native Push (Client)]] |
Latest revision as of 13:40, 11 October 2024
Just like the UBIK® push service, UBIK® native push also aims to ensure that the server side can actively deliver messages to the clients. However, it has a few major differences by comparison.
- The native push uses the existing 3rd party solutions/infrastructure and is, therefore, dependent on the availability of those.
- Android: Firebase Cloud Messaging.
- iOS: Apple Push Notification service.
- The native push is better supported by and integrated into the mobile platforms. So the delivery of the pushes is better guaranteed just like with other apps (e.g. email or online messaging apps).
Native push types
Currently, the only supported push type is text messages. Upon clicked, they simply launch the UBIK® client or bring it to the foreground if that's not the state of it yet.
Native push settings
You can turn native push on/off in the app's General settings section via the "Activate native push" setting.
Technical background
In order to properly determine which pushes to receive or not, the client requires access to push topics from the server side.
When you login (online or offline), the client checks all available push topics and maintains the topic subscriptions accordingly. This also happens when you change the "Activate native push" setting to turn it on.
- When you turn it off, the client unsubscribes from all topics available to the current user session.