PushwooshLiveUpdates

Entry point for controlling Pushwoosh Live Updates that are already on screen.

A Live Update is an ongoing, progress-style notification (Android 16 / API 36+) that the SDK renders automatically from server-sent push messages. There is no API to start or update one from the app — the Pushwoosh backend is the source of truth and drives every start / update / end transition. This facade covers only the app-side operations the server cannot perform: dismissing a Live Update locally and querying which ones are on screen.

To customize how a Live Update looks, implement LiveUpdateProgressStyleProvider and register it via manifest meta-data — see that interface for details.

Availability: Live Updates require Android 16 (API 36) or newer. On older devices live-update pushes are suppressed (not shown at all) and every method here is a safe no-op (getActiveIds returns an empty list).

Example:


  // Dismiss a specific Live Update once the user cancels the order in-app,
  // without waiting for the server's terminal "end" push
  PushwooshLiveUpdates.endLiveUpdate("order_4521");

  // Or clear everything this app is currently showing, e.g. on logout
  PushwooshLiveUpdates.endAllLiveUpdates();

All methods are safe to call from any thread.

See also

Functions

Link copied to clipboard
Dismisses every Live Update this app is currently showing.
Link copied to clipboard
open fun endLiveUpdate(activityId: String)
Dismisses the Live Update with the given activityId.
Link copied to clipboard
open fun getActiveIds(): List<String>
Returns the ids of all Live Updates this app is currently showing.
Link copied to clipboard
open fun getActiveRenderer(): LiveUpdateNotificationRenderer
Returns the installed renderer, or null before initialization or below API 36.
Link copied to clipboard
open fun install(initial: LiveUpdateNotificationRenderer)
Installs the SDK-owned renderer.