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 application is running in the foreground, you can use the Notification Kit to publish notifications to users. 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 or progress bar. - 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 Notification 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.

Common notification styles in the Notification Kit are as follows. |Type|Notification Style|Description| |—-|——–|——-| |Text | |A maximum of three lines can be displayed in the notification text. Excess content is truncated by an ellipsis (…).| |Multi-line text | |A maximum of three lines of content can be displayed. Excess content of each line is truncated by an ellipsis (…).| |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 publication and update frequencies for notifications must meet the following requirements. Otherwise, the publication or update fails and the corresponding error code is returned.
  • The total number of notifications published by an application cannot exceed 10 per second, and that of notifications updated cannot exceed 20 per second.
  • The total number of notifications published by all third-party applications cannot exceed 15 per second, and that of notifications updated cannot exceed 30 per second.
  • The total number of notifications published by all system applications cannot exceed 15 per second, and that of notifications updated cannot exceed 30 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 choose Ability Kit to set the behavior intent after a user opens a notification.

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Notification Kit (User Notification Service)

harmony 鸿蒙Publishing a Live View Notification (for System Applications Only)

harmony 鸿蒙Managing the Notification Badge

harmony 鸿蒙Canceling a Notification

harmony 鸿蒙Clearing Repeated Notifications Across Devices

harmony 鸿蒙Cross-Device Notification Management (for System Applications Only)

harmony 鸿蒙Cross-Device Notification Overview

harmony 鸿蒙Requesting Notification Authorization

harmony 鸿蒙Enabling Quick Reply for Cross-device Notifications

harmony 鸿蒙Managing Notification Slots