Introduction to Notification Kit

With Notification Kit, you can publish local notifications from your application and push them to users on the client. Local notifications can be displayed by ringtones, vibrations, banners, lock screen, screen off, Always On Display (AOD), and notification panel based on the notification type and publishing scenario.

When to Use

When your application is running in the foreground, you can use the Notification Kit to publish notifications to users. When the application is switched to the background, you cannot publish local notifications. Instead, you need to access the Push Kit to publish offline notifications on the cloud.

You can use the local notification capability in multiple scenarios. For example, synchronize the upload and download progress of the user, send instant customer service payment notifications, and update the number of steps.

Capability Scope

The Notification Kit supports the following capabilities:

• Publishes notifications in the form of text, multi-line text, notification icons, and more.
• Carries or updates the application notification badge.
• Cancels one or all published notifications.
• Queries the list of published notifications.
• Queries the status of the notification function of an application.
• The capability of notifying users is disabled by default. You can open the authorization dialog box to request users to authorize the publishing of notifications.

Service Flow

The main service flow of using the Noification Kit is as follows:

1. Request notification authorization.

2. The application publishes a notification to the notification service.

3. The notification is displayed in the notification center.

Notification Style

NOTE

The display effect depends on the device capability and notification center UI style.

The Notification Kit supports the following notification styles.

Type	Notification Style	Description
Text		A maximum of three lines can be displayed in the notification text. If the content is too long, it is truncated by an ellipsis (...).
Multi-line text		A maximum of three lines of content can be displayed. Each line is truncated by an ellipsis (...) for long text.
Notification icon		Notification with image preview.
Notification badge		Displayed as a number in the upper right corner.
Progress bar		Progress notification.

Constraints

• There is a limit on the number of notifications per application in the system windows. The current limit is 24.
• The notification cannot exceed 200 KB (due to cross-process serialization).
• The total number of notifications published by all system applications cannot exceed 10 per second, and that of notifications updated cannot exceed 20 per second.

Relationship with Related Kits

• Notifications created by Notification Kit are displayed in the notification panel in real time. To publish scheduled notifications when your application is in the background or is not running, you can use BackGroundTask Kit. For example, you can use it to publish a flash sale reminder for your shopping application. Currently, the notification reminder feature is available for countdown, calendar, and alarm events.
• You can use Push Kit to push remote notifications to the local device.
• You can choose Ability Kit to set the behavior intent after a user opens a notification.