Class

UNMutableNotificationContent

The editable content for a notification.

Declaration

@interface UNMutableNotificationContent : UNNotificationContent

Overview

Create a UNMutableNotificationContent object when you want to specify the payload for a local notification. Specifically, use this object to specify the title and message for an alert, the sound to play, or the value to assign to your app's badge. You might also provide details about how the system handles the notification. For example, you can specify a custom launch image and a thread identifier for visually grouping related notifications.

After creating your content object, assign it to a UNNotificationRequest object, add a trigger condition, and schedule your notification. The trigger condition defines when the notification is delivered to the user. Listing 1 shows the scheduling of a local notification that displays an alert and plays a sound after a delay of five seconds. The strings for the alert's title and body are stored in the app’s Localizable.strings file.

Listing 1

Creating the content for a local notification

// Configure the notification's payload.
UNMutableNotificationContent* content = [[UNMutableNotificationContent alloc] init];
content.title = [NSString localizedUserNotificationStringForKey:@"Hello!" arguments:nil];
content.body = [NSString localizedUserNotificationStringForKey:@"Hello_message_body"
            arguments:nil];
content.sound = [UNNotificationSound defaultSound];
 
// Deliver the notification in five seconds.
UNTimeIntervalNotificationTrigger* trigger = [UNTimeIntervalNotificationTrigger
            triggerWithTimeInterval:5 repeats:NO];
UNNotificationRequest* request = [UNNotificationRequest requestWithIdentifier:@"FiveSecond"
            content:content trigger:trigger];
 
// Schedule the notification.
UNUserNotificationCenter* center = [UNUserNotificationCenter currentNotificationCenter];
[center addNotificationRequest:request];

Localizing the Alert Strings

The strings you display in a notification alert should be localized for the current user. Although you can use the NSLocalizedString macros to load strings from your app’s resource files, a better option is to specify your string using the localizedUserNotificationStringForKey:arguments: method of NSString. The localizedUserNotificationStringForKey:arguments: method delays the loading of the localized string until the notification is delivered. Thus, if the user changes language settings before a notification is delivered, the alert text is updated to the user’s current language instead of the language that was set when the notification was scheduled.

Topics

Getting the Notification Data

title

The localized title, containing the reason for the alert.

subtitle

The localized subtitle, containing a secondary description of the reason for the alert.

body

The localized message to display in the notification alert.

badge

The number to apply to the app’s icon.

sound

The sound to play when the notification is delivered.

launchImageName

The name of the custom launch image to display when your app is launched in response to the notification.

userInfo

A dictionary of custom information associated with the notification.

attachments

An array of attachments to display in an alert-based notification.

Setting the Notification Summary

summaryArgument

The string the notification adds to the category’s summary format string.

summaryArgumentCount

The number of items the notification adds to the category’s summary format string.

Identifying the Content

categoryIdentifier

The identifier of the category object that represents the notification's type.

threadIdentifier

An identifier that you use to group related notifications together.

Relationships

See Also

Notification Content

UNNotificationContent

The uneditable content of a notification.

UNNotificationAttachment

A media file associated with a notification.

UNNotificationSound

The sound played when a notification is delivered.

UNNotificationSoundName

A string providing the name of a sound file.