docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Class NotificationCenter

    Send, receive and manage notifications. Must be initialized before use. See Initialize(NotificationCenterArgs).

    Inheritance
    object
    NotificationCenter
    Inherited Members
    object.ToString()
    object.Equals(object)
    object.Equals(object, object)
    object.ReferenceEquals(object, object)
    object.GetHashCode()
    object.GetType()
    object.MemberwiseClone()
    Namespace: Unity.Notifications
    Assembly: solution.dll
    Syntax
    public static class NotificationCenter

    Properties

    LastRespondedNotification

    Returns last notification tapped by user, or null.

    Declaration
    public static Notification? LastRespondedNotification { get; }
    Property Value
    Type Description
    Notification?

    Methods

    CancelAllDeliveredNotifications()

    Remove all already delivered notifications.

    Declaration
    public static void CancelAllDeliveredNotifications()

    CancelAllScheduledNotifications()

    Cancel all future notifications.

    Declaration
    public static void CancelAllScheduledNotifications()

    CancelDeliveredNotification(int)

    Cancel delivered notification. Removes notification from the tray.

    Declaration
    public static void CancelDeliveredNotification(int id)
    Parameters
    Type Name Description
    int id

    ID of the notification to cancel.

    CancelScheduledNotification(int)

    Cancel a scheduled notification.

    Declaration
    public static void CancelScheduledNotification(int id)
    Parameters
    Type Name Description
    int id

    ID of the notification to cancel.

    ClearBadge()

    Clear Application badge. iOS only. iOS applications can set numeric badge on app icon. Calling this method removes that badge. On Android badge is removed automatically when notifications are removed.

    Declaration
    public static void ClearBadge()

    Initialize(NotificationCenterArgs)

    Initializes notification center with given arguments. On Android it will also create notification channel if arguments are set accordingly.

    Declaration
    public static void Initialize(NotificationCenterArgs args)
    Parameters
    Type Name Description
    NotificationCenterArgs args

    Arguments for initialization.

    OpenNotificationSettings(NotificationSettingsSection)

    Opens settings for the application. If possible, will try to navigate as close to requested section as it can. On iOS and Android prior to 8.0 will open settings for the application. Since Android 8.0 will open notification settings for either application or the default channel.

    Declaration
    public static void OpenNotificationSettings(NotificationSettingsSection section = NotificationSettingsSection.Application)
    Parameters
    Type Name Description
    NotificationSettingsSection section

    The section to navigate to.

    RequestPermission()

    Request for users permission to post notifications. Requests users permission to send notifications. Unless already allowed or permanently denied, shows UI to the user. Users can revoke permission in Settings while app is not running.

    Declaration
    public static NotificationsPermissionRequest RequestPermission()
    Returns
    Type Description
    NotificationsPermissionRequest

    An object for tracking the request and obtaining results.

    Remarks

    Before Android 13 no permission is required.

    ScheduleNotification<T>(Notification, string, T)

    Schedule notification to be shown in the future. Allows to explicitly specify the category to send notification to. On Android it is notification channel. Channel or category has to be created manually using AndroidNotificationCenter and iOSNotificationCenter respectively.

    Declaration
    public static int ScheduleNotification<T>(Notification notification, string category, T schedule) where T : NotificationSchedule
    Parameters
    Type Name Description
    Notification notification

    Notification to send.

    string category

    Identifier for iOS category or Android channel.

    T schedule

    Schedule, specifying, when notification should be shown.

    Returns
    Type Description
    int

    Notification identifier.

    Type Parameters
    Name Description
    T

    Type of the schedule, usually deduced from actually passed one.

    ScheduleNotification<T>(Notification, T)

    Schedule notification to be shown in the future.

    Declaration
    public static int ScheduleNotification<T>(Notification notification, T schedule) where T : NotificationSchedule
    Parameters
    Type Name Description
    Notification notification

    Notification to send.

    T schedule

    Schedule, specifying, when notification should be shown.

    Returns
    Type Description
    int

    Notification identifier.

    Type Parameters
    Name Description
    T

    Type of the schedule, usually deduced from actually passed one.

    Events

    OnNotificationReceived

    An event that fires when notification is received. Application must be running for this event to work. On Android this even fires if application is in foreground or when it's brought back from background. On iOS this even only fires when notification is received while app is in foreground.

    Declaration
    public static event NotificationCenter.NotificationReceivedCallback OnNotificationReceived
    Event Type
    Type Description
    NotificationCenter.NotificationReceivedCallback
    Remarks

    This event is the same as AndroidNotificationCenter.OnNotificationReceived and iOSNotificationCenter.OnNotificationReceived.

    In This Article
    Back to top
    Copyright © 2024 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)