Live View Kit enables apps to display the real-time status of orders or services on key device screens, and manages the lifecycle and UI effects of the displayed information.
Use Cases
Live view is a notification format designed to help users focus on ongoing tasks, enabling quick viewing and immediate handling of these tasks. A live view lasts for a specific period of time and features high timeliness and dynamic updates.
Live view messages can be displayed in the form of capsule or widget on the lock screen, notification panel, and status bar.
| Notification Panel | Status Bar | Lock Screen |
|---|---|---|
 |  |  |
[h2]Specific Period
An event or service needs to last for a period of time with a definite start time and end time, rather than a one-off reminder or message.
For example, ride-hailing and food delivery last for a certain period from the start to the end, so they are suitable scenarios for live view messages. On the contrary, notifications about weather and the to-do list are one-off and are not considered live view messages.
[h2]Timeliness
The live view content is a notification for an ongoing event or service. The information is valuable to users in a specific period.
For example, ride-hailing and food delivery are ongoing activities. When a user purchases an air ticket for a flight that departs in two days, no notification is sent at the time of purchase. Instead, a live view message will be sent to the user a certain period (determined based on the actual business requirements) before departure. System status notifications such as permission requests and feature standby states are not live view messages.
[h2]Updates
Live view content needs to be dynamically updated to present users with the latest status.
Highlights
Compatibility with all phones and tablets running HarmonyOS 5 or later
Completely decoupled from device hardware, Live View Kit is compatible with all phones and tablets running HarmonyOS 5 or later.
Multiple touchpoints
Once you've integrated Live View Kit into your app, live view messages can be displayed through multiple touchpoints such as the lock screen, notification panel, and status bar.
Uninterrupted operations
Users can view a live view capsule on supported display areas or tap the live view capsule to view the detailed event progress.
After tapping the live view capsule, users can be taken to the landing page to quickly view the detailed information in the app.
Timely service progress updates
Users can follow the latest service progress through multiple touchpoints in a timely manner. This helps businesses achieve faster and more efficient service fulfillment.
Applicable Scope and Scenarios
- Live View Kit gives priority to apps that meet the requirements for applicable scope and scenario eligibility.
- Live View Kit is compatible with HarmonyOS 5 or later.
- Live View Kit is currently supported only on phones and tablets.
- Currently, Live View Kit is available only in the Chinese mainland.
[h2]Scenario Eligibility Criteria
- The activity must be highly relevant to users and requires frequent checking or quick actions.
- The activity must have a start time and an end time, and lasts for no more than 8 hours.
- Users have a clear expectation for receiving live view messages of the activity. Generally, the live view messages are triggered by user operations.
- The live view messages must be valuable to users, and must not be used for marketing or advertising purposes.
[h2]Applicable Scenarios
| Scenario | Event Value | Description | Scenario Scope |
|---|---|---|---|
| Ride-hailing | TAXI | After a user books a ride through a ride-hailing app, the live view displays information such as the driver's estimated arrival time, as well as the remaining distance and time during the trip. | Applicable to: Applicable to scenarios such as online ride-hailing, taxi-hailing, carpooling, and hitchhiking. |
| Instant delivery | DELIVERY | Couriers deliver meals and products to users at the specified location, generally within a short period of time. | Applicable to: Applicable to scenarios such as take-out, fresh food delivery, and intra-city delivery. Not applicable to: Express logistics and transportation progress. |
| Flight | FLIGHT | After a user follows a flight, the live view displays key updates of the flight, such as boarding, departure, delay, cancellation, and arrival. | Applicable to: Applicable to scenarios where the user travels through a flight or follows the progress of a flight. Not applicable to: Flight simulation, flight status simulation, and so on. |
| High-speed train/Regular train | TRAIN | When a user travels by high-speed train or regular train, the live view displays information such as the boarding gate, seat number, train number, and train running status to the user. | Applicable to: Applicable to scenarios where the user travels by high-speed train or regular train. |
| Queuing | QUEUE | A user receives services in sequence through a queuing and number-calling system. | Applicable to: Applicable to scenarios where queuing and number calling are required, such as service halls, hospitals, banks, and restaurants. Not applicable to: Queuing without progress display, online customer service queuing, file download queuing, and so on. |
| Meal pickup | PICK_UP | After placing an order, a user picks up the meal or product themselves. | Applicable to: Applicable to the onsite meal pickup scenario, including reminders on the queuing information, meal preparation progress, and meal pickup. Not applicable to: Meal pickup simulation, meal pickup without progress updates, and so on |
| Live scores | SCORE | The live view displays score updates for the competing teams or players. | Applicable to: Applicable to scenarios with live score updates, such as gaming events and sporting events. Not applicable to: Streamer PK scores, chess games, and so on. |
| Shared rental | RENT | When a user uses the temporary rental service, the live view displays the rental information such as the real-time rental duration and fee to the user. | Applicable to: Applicable to scenarios such as bicycle sharing, mobile power pack sharing, temporary parking in parking lots, and electric vehicle fast charging. Not applicable to: Slow EV charging, home smart appliance statuses, shared Wi-Fi, and so on. |
| Timing | TIMER | This scenario involves a short-duration count-up timer or a countdown before a task begins. | Applicable to: Applicable to scenarios like focused work sessions, Pomodoro timers, and ticket purchase countdowns. These scenarios are only applicable to tool apps. For timer-type scenarios, the corresponding live view can only be created and updated on the device side. Not applicable to: Meal pickup timers, course reminders, to-do items, meeting schedule reminders, recording, translation timers, AI conversation duration, pending payment reminders, and so on. |
| Subscription timing | SUBSCRIBE_TIMER | ● After a user manually subscribes to a concert ticket sale or train ticket waitlist reminder, the live view shows a countdown before the sale begins. ● A user must manually subscribe to global official events before the broadcast; only then may the app display the event's live view. The event subscription switch of any app must not be enabled by default, auto-subscribed, or shown in batch pop-ups. | Applicable to: Applicable to user-initiated subscriptions for concert ticket sales, train ticket waitlist reminders, and global official event broadcast notifications. Concert ticket sales must be publicly available through official channels, and train ticket waitlist entries must be valid orders from official platforms. Global official events must be top-tier international events (such as those held every four years) with legitimate domestic broadcast rights and broad national relevance. Events without broadcast rights are not eligible for live activity broadcast subscription reminders. Not applicable to: Single-item, single-session countdown-to-sale reminder services manually subscribed to by users, including livestream subscriptions (such as e-commerce livestreams, product selling livestreams, entertainment shows, and personal media), regular-season and regional sports games, niche regional events or leagues, as well as e-commerce flash sale subscriptions, coupons, red-packet offers, and event check-ins. |
| Workout | WORKOUT | The live view displays information such as the workout duration and progress to users in real time. | Applicable to: Applicable to outdoor or indoor workouts, such as running and cycling. |
| Navigation | NAVIGATION | The live view displays the next route change when a user is utilizing the navigation service. | Applicable to: Applicable to walking, cycling, and vehicle navigation. Not applicable to: Virtual navigation, game navigation, and so on. |
| Clock-in/out | CHECK_IN | The live view reminds users to clock in or out at the designated time. | Applicable to: Applicable to work clock-in and clock-out scenarios. Not applicable to: Scenic spot recommendations/check-ins, course check-ins, check-in challenges, livestream check-ins, remote work check-ins, and so on. |
| Express delivery | EXPRESS | The live view reminds users to pick up pending packages. | Applicable to: Applicable to package pickup. Not applicable to: Express delivery information pushes not integrated with the location-based live view reminder function. |
| Progress indicator | PROGRESS | The live view displays the task progress in scenarios such as file upload/download and audio/video resource import/export. | Applicable to: Applicable to scenarios such as user-initiated file upload/download and resource import/export. Not applicable to: Automatic file upload/download and resource import/export in the background. |
| Financial trading | TRADE | When a user's securities trade enters the core Bid-5 to Ask-5 trading range, the live view displays real-time market changes, such as price movements, order placements, and executions. | Applicable to: Applicable to scenarios such as stock and fund trading, used to provide trade progress notifications. |
[h2]General Restrictions
The push of live view messages is subject to permission control. When integrating Live View Kit into your app, you need to enable Push Kit and enable Live View Kit.
A local live view can be created only when the corresponding app is running. After the creation, the live view can be updated either locally or through Push Kit.
The lifecycle of a live view cannot exceed 8 hours. After 8 hours, the system considers that the live view has terminated.
To ensure the timeliness of the live view content, you need to update the live view promptly. The system automatically adjusts the live view display in the following scenarios:
- If a live view hasn't been updated for over 2 hours, its capsule display will no longer appear in the status bar or on the lock screen, but it will remain visible in the notification panel.
- If a live view hasn't been updated for over 4 hours, the system will deem it terminated and remove it from all display entries.
Users can delete a live view message at any time when it is displayed. After the deletion, the message updates will no longer be displayed.
Rate limiting applies to live view creation and updates as follows:
- System-level rate limiting (for all apps): Up to 15 live view creation requests per second and 30 live view update requests per second are allowed. Any excess requests are discarded.
- App-level rate limiting (for a single app): Up to 10 live view creation requests per second and 20 live view update requests per second are allowed. Any excess requests are discarded.
For creation or update of a local live view, API version 26.0.0 and later versions support a PixelMap image up to 192 KB, while earlier versions support an image up to 30 KB.
- To ensure that PixelMap images can be displayed properly on system versions earlier than HarmonyOS 7.0.0, you must provide PixelMap images of different sizes for new and old system versions. For details, please refer to How do I ensure API compatibility on devices with different system versions?.
[h2]Restrictions on Creating and Updating Live Views Through Push Kit
- Currently, live view creation through Push Kit only supports the following scenarios: FLIGHT, TAXI, TRAIN, DELIVERY, QUEUE, RENT, EXPRESS, CHECK_IN, TRADE, and SUBSCRIBE_TIMER.
- A live view can be updated through Push Kit, regardless of whether the corresponding app is running or not. With Push Kit, live views can be properly updated and terminated within their lifecycle.
- For live view updates through Push Kit, a single live view can be updated for up to 30 times every 5 minutes and 180 times every hour per device in the ride-hailing and live score scenarios. In other scenarios, a single live view can be updated for up to 10 times every 5 minutes and 60 times every hour per device. The excess messages will be discarded.
[h2]Restrictions on the Location-based Live View Reminder Function
- Since version 6.1.0(23), the location-based live view alert function is supported. The restrictions are as follows:
- Limit on the number of location-based live view alerts: A maximum of five alerts can be registered for a single app on a single device per day.
- After a location-based live view alert is registered, it is valid for 48 hours. If the alert is not triggered within this period, the system will automatically delete the expired alert.
- When the geographical location condition is met and the creation or termination of a live view is triggered, the system will automatically delete the location-based trigger. As a result, the live view will not be created or terminated again.
- Location-based live view alerts cannot be registered in the WORKOUT and NAVIGATION scenarios.
- Location-based live view alerts depend on the geofencing function of the GNSS chip. Events of entering or leaving the geofence can be accurately identified only in open outdoor areas to trigger the creation or termination of live views.
- After the app-level live view switch is turned off under Settings > Notifications & status bar > Live view or Settings > Apps & services, the system will automatically delete the location-based live view alerts that have been registered but not triggered for the app.
- After a user goes to Settings > Notifications & status bar > Live view, taps the four-dot icon in the upper right corner, taps Personalized alerts, and disables Show location-based alerts, the system will automatically delete all location-based live view alerts that have been registered but not triggered.
Emulator Support
This kit supports the Emulator, but there are some differences in feature support between real devices and the Emulator:
- General differences: For details, please refer to Differences Between the Emulator and the Real Device.
- The Emulator does not support location-based live view alerts, rain- or snow-themed dynamic weather backgrounds for live views, and associated service buttons in live views.
Development Process
Follow the steps below to integrate Live View Kit.
| Step | Description |
|---|---|
| Follow Live View Design Specifications to design the live view message style. | Design your live view message style based on the available style templates. |
| Make preparations. | Enable Live View Kit in AppGallery Connect. |
| Create a local live view. | Develop a local live view based on Live View Design Specifications. |
| Create a live view through Push Kit. | Use Push Kit to create a live view. |
| Update a live view through Push Kit. | Use Push Kit to update a live view. |
Penalties for Violations
Live view messages sent by your app must comply with both Live View Design Specifications and Push Kit's Notification Content Management Rules. Any action that violates the specifications and rules will be regarded as a violation.
For details about the violations and penalties, please refer to Violation Types, Violation Actions, and Penalty Criteria.