Skip to content

Latest commit

 

History

History
102 lines (50 loc) · 3.33 KB

README.md

File metadata and controls

102 lines (50 loc) · 3.33 KB
Raw

Mobile Notifications Samples & Wrapper

This Unity project demonstrates how to use the Unity Mobile Notifications API in real-world use cases.

Overview: the Game Notifications Manager

The primary component of the wrapper is the Game Notifications Manager. It is the interface through which you can schedule cross-platform local notifications.

Usage

  1. Add the Game Notifications Manager to a Game Object (Note that the Manager's lifetime is currently limited to one scene. Up to you to add a DontDestroyOnLoad)
  2. Reference it from a game script that will send notifications.
  3. Initialize the Manager. Provide at least one channel if targeting Android. This should only be done once per application session.
var channel = new GameNotificationChannel(ChannelId, "Default Game Channel", "Generic notifications");
manager.Initialize(channel);
  1. Create a new notification:
var notification = manager.CreateNotification();

(Note that the wrapper might return a null object on some platforms. Check for null before continuing.)

  1. Fill in the important fields
notification.Title = title;
notification.Body = body;
notification.DeliveryTime = deliveryTime;
  1. Schedule the notification.
manager.ScheduleNotification(notification);

The Manager saves a small file to disk whenever backgrounding so that it can keep track of notifications that were published and scheduled in previous sessions.

Operation Modes

The manager features several operation modes that control its behaviour. The default operation mode has queueing, foreground clearing and automatic rescheduling all on.

  • No queueing

    The wrapper immediately schedules messages with the underlying operating system.

  • Queuing

    The wrapper only schedules messages with the OS when backgrounding. The system will also (optionally, but on by default) have the ability to calculate badge numbers automatically in this mode. If you don't provide any badge numbers manually with your notifications, the wrapper will set the badge numbers so that they increment based on the scheduled time of each notification.

  • Foreground clearing

    The wrapper will remove all scheduled messages when the app comes into the foreground.

  • Automatic rescheduling

    If this is set, after clearing all messages when foregrounding, the wrapper will go through all notifications marked this way, and put them back in the queue for delivery.

    To configure a notification for rescheduling:

var notificationToDisplay = manager.ScheduleNotification(notification);
notificationToDisplay.Reschedule = true;

Demo Notes

  • Operates using all operation modes on by default.
  • Features a very simple clicker game. It will schedule local notifications whenever a cookie or cupcake is completed.
  • The News Feed button will retrieve the latest item from the Unity news RSS and schedule it as a notification 5 minutes in the future (configurable in GameController)
  • More Options contains a 'play reminder' button which will schedule an absence notification message for a fixed time of day the following day. (6am by default, configurable in GameController)

Credits

This Sample was developed in conjunction with 24 Bit Games. www.24bit.games