IdleDetector

Returns true when the runtime exposes IdleDetector. During prerender/SSR the check returns false rather than throwing, so defer it to OnAfterRenderAsync.

@inject Bit.Butil.IdleDetector idleDetector

var supported = await idleDetector.IsSupported();

Asks the browser for the idle-detection permission and returns the resulting PermissionState (Granted, Denied, Prompt or Unknown). Starting a detector without a granted permission fails.

var state = await idleDetector.RequestPermission();

if (state is PermissionState.Granted)
{
    // safe to call Start
}

Starts watching for idle changes with the given threshold in seconds (the spec minimum is 60 - smaller values are clamped). The handler receives an IdleState with UserState (active/idle) and ScreenState (locked/unlocked) on every change. Dispose the returned ButilSubscription to stop.

private ButilSubscription? _sub;

_sub = await idleDetector.Start(60, state =>
{
    // state.UserState:   "active" | "idle"
    // state.ScreenState: "unlocked" | "locked"
});

// stop watching:
await _sub.DisposeAsync();