DropReason enum

Why a presentation ended without ever displaying.

The value strings are a cross-stack contract: they reach the Digia analytics backend from three runtimes (Dart, Kotlin, Swift) and must match character for character. cep_interface_enum_values_test.dart pins them.

Inheritance

Object
Enum
DropReason

Implemented types

DiagnosticReason

Available extensions

EnumName

Values

notInitialized → const DropReason: Digia.initialize() has not been called.

const DropReason('not_initialized')
notReady → const DropReason: Digia.initialize() was called but the campaign fetch is still running. Core never holds a trigger that arrives before the SDK is ready.

const DropReason('not_ready')
initializationFailed → const DropReason: The campaign fetch failed; the SDK stays unusable until the host calls Digia.initialize() again.

const DropReason('initialization_failed')
unknownCampaignKey → const DropReason: The key is not in the campaign store.

const DropReason('unknown_campaign_key')
invalidConfig → const DropReason: Template unparseable, no steps, or an illegal combination of options.

const DropReason('invalid_config')
anchorNotRegistered → const DropReason: A guide's first anchor is absent from this screen.

const DropReason('anchor_not_registered')
frequencyCapped → const DropReason: The frequency gate said no.

const DropReason('frequency_capped')
screenNotTargeted → const DropReason: The campaign is scoped to screens the host is not currently on. Nothing is wrong with it — the user is somewhere else.

const DropReason('screen_not_targeted')
surfaceBusy → const DropReason: Another experience already occupies the surface this one needs. The incumbent wins; this trigger is the one turned away. (Contrast superseded, where a newer trigger displaces this one.)

const DropReason('surface_busy')
superseded → const DropReason: Displaced by a newer trigger before it displayed.

const DropReason('superseded')
hostNotMounted → const DropReason: No host was mounted when the render was due.

const DropReason('host_not_mounted')
timeout → const DropReason: Watchdog: no verdict, or no layout, in time.

const DropReason('timeout')
cancelled → const DropReason: The owner called cancel() before it displayed.

const DropReason('cancelled')
pluginDetached → const DropReason: The owning plugin was unregistered.

const DropReason('plugin_detached')
pendingExpired → const DropReason: The plugin held the trigger while core was not ready, for more than 5 minutes.

const DropReason('pending_expired')
error → const DropReason: An unexpected exception — specifics in PresentationDropped.detail.

const DropReason('error')

Properties

hashCode → int: The hash code for this object.
no setterinherited
index → int: A numeric identifier for the enumerated value.
no setterinherited
name → String: Available on Enum, provided by the EnumName extension
The name of the enum value.
no setter
runtimeType → Type: A representation of the runtime type of the object.
no setterinherited
value → String: The pinned string form. Never derive this from name; the two differ.
final
wire → String: DiagnosticReason.wire is this same pinned string.
no setteroverride

Methods

noSuchMethod(Invocation invocation) → dynamic: Invoked when a nonexistent method or property is accessed.
inherited
toString() → String: A string representation of this object.
inherited

Operators

operator ==(Object other) → bool: The equality operator.
inherited

Constants

values → const List<DropReason>: A constant List of the values in this enum, in order of their declaration.