RageClickOptions

public struct RageClickOptions

Configuration options for rage click detection.

Rage clicks are detected when a user taps rapidly multiple times in the same area, indicating frustration with an unresponsive element.

Warning

Experimental (beta). Autocapture may contain issues, and its API and the properties it captures may change in a future release before general availability. Pin your SDK version if you build reports on autocaptured events.

  • Whether rage click detection is enabled. Defaults to true.

    Declaration

    Swift

    public let enabled: Bool

  • Number of clicks required to trigger a rage click event. Defaults to 4 (triggers on the 4th click within the time window).

    Clamped to a minimum of 2: a threshold below that would mark every single tap as a rage click.

    Declaration

    Swift

    public let clickThreshold: Int

  • Time window in milliseconds for rage click detection. Clicks must occur within this window to count as a rage click sequence. Defaults to 1000 (1 second).

    Clamped to a minimum of 1.

    Declaration

    Swift

    public let timeWindowMs: Int64

  • Spatial threshold for rage click detection in points (pt). Clicks must be within this radius of each other to count as part of the same sequence. Defaults to 44 (matching iOS minimum tap target size).

    Clamped to a minimum of 0.

    Declaration

    Swift

    public let radius: CGFloat

  • Out-of-range values are clamped rather than rejected, matching the Android SDK. Passing an invalid value must never crash the host app or turn every tap into a rage click, so the bounds are enforced here at the only entry point.

    Declaration

    Swift

    public init(
    enabled: Bool = true,
    clickThreshold: Int = 4,
    timeWindowMs: Int64 = 1000,
    radius: CGFloat = 44
)