Skip to content

Latest commit

 

History

History
135 lines (99 loc) · 4.48 KB

ReceivingNotifications.md

File metadata and controls

135 lines (99 loc) · 4.48 KB
Raw

Android Firebase Push Notifications

Data messages - Handled by the client app. These messages trigger the onMessageReceived() callback even if your app is in foreground/background/killed. When using this type of message you are the one providing the UI and handling when push notification is received on an Android device.

{
    "data": {
        "message" : "my_custom_value",
        "other_key" : true,
        "body":"test"
     }
}

iOS APS Push Notifications

https://developer.apple.com/library/content/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/CreatingtheNotificationPayload.html#//apple_ref/doc/uid/TP40008194-CH10-SW1

Configuring a Silent Notification

On iOS to get a silent notification you should send "content-available" : 1 inside the "aps" payload key.

iOS Silent Payload Sample:

{
    "aps" : {
        "content-available" : 1
    },
    "acme1" : "bar",
    "acme2" : 42
}

On Android to get a silent notification you should send "silent" : true inside the "data" payload key.

Android Silent Payload Sample:

{
    "data": {
        "message" : "my_custom_value",
        "other_key" : true,
        "body":"test",
	    "silent" : true
     }
}

Notification Events

OnNotificationReceived

  CrossAzurePushNotification.Current.OnNotificationReceived += (s,p) =>
  {
 
        System.Diagnostics.Debug.WriteLine("Received");
    
  };

OnNotificationOpened

  
  CrossAzurePushNotification.Current.OnNotificationOpened += (s,p) =>
  {
                System.Diagnostics.Debug.WriteLine("Opened");
                foreach(var data in p.Data)
                {
                    System.Diagnostics.Debug.WriteLine($"{data.Key} : {data.Value}");
                }

                if(!string.IsNullOrEmpty(p.Identifier))
                {
                    System.Diagnostics.Debug.WriteLine($"ActionId: {p.Identifier}");
                }
             
 };

Note: This is the event were you will navigate to an specific page/activity/viewcontroller, if needed

OnNotificationDeleted (Android Only)

  CrossAzurePushNotification.Current.OnNotificationDeleted += (s,p) =>
  {
 
        System.Diagnostics.Debug.WriteLine("Deleted");
    
  };

Push Notification Handler

A push notification handler is the way to provide ui push notification customization(on Android) and events feedback on native platforms by using IPushNotificationHandler interface. The plugin has a default push notification handler implementation and it's the one used by default.

On most common use cases the default implementation might be enough so a custom implementation might not be needed at all.

public interface IPushNotificationHandler
{
        //Method triggered when an error occurs
        void OnError(string error);
        //Method triggered when a notification is opened
        void OnOpened(NotificationResponse response);
        //Method triggered when a notification is received
        void OnReceived(IDictionary<string, string> parameters);
}

An example of a custom handler use is the DefaultPushNotificationHandler which is the plugin default implementation to render the push notification ui when sending data messages and supporting notification actions on Android.

Initialize using a PushHandler on Application class on Android and AppDelegate on iOS:

Application class OnCreate on Android:

    #if DEBUG
      AzurePushNotificationManager.Initialize(this,new CustomPushHandler(),true);
    #else
      AzurePushNotificationManager.Initialize(this,new CustomPushHandler(),false);
    #endif

To keep the default push notification handler functionality but make small adjustments or customizations to the notification. You can inherit from DefaultPushNotificationHandler and implement OnBuildNotification method which can be used to e.g. load an image from the web and set it as the 'LargeIcon' of a notification (notificationBuilder.SetLargeIcon) or other modifications to the resulting notification.

Note: If you use a custom push notification handler on Android, you will have full control on the notification arrival, so will be in charge of creating the notification ui for data messages when needed.

AppDelegate FinishLaunching on iOS:

      AzurePushNotificationManager.Initialize(options,new CustomPushHandler());

<= Back to Table of Contents