Whether the manager automatically refreshes its permission cache
on a periodic timer (every periodicRefreshMinutes) in addition
to refreshing on app resume. Defaults to true.
How long (in seconds) a cached permission status is considered
fresh before checkPermissionsStatus re-queries the platform.
Defaults to 3 seconds. Set this to tune the tradeoff between
platform-channel call volume and status staleness for your app
— e.g. a lower value if your UI needs to reflect Settings
changes almost immediately, or a higher value if you're
checking many permissions frequently and want to reduce
platform-channel traffic.
The single, correct, race-free way to open Settings and wait for
the user to actually return. Subscribes to onAppResumedbefore
launching Settings — not after — so even an unrealistically fast
resume cannot be missed. Every settings-redirect path in this
package uses this method; nothing calls openAppSettings()
followed by a separate wait anymore.
Register a custom explanation UI for a whole group, replacing
the built-in dialog for every permission requested as part of
that group. Pass null to remove a previously-registered
callback and fall back to the default.
Register a custom explanation UI for a single permission,
replacing the built-in dialog. Pass null to remove a
previously-registered callback and fall back to the default.
Whether the OS recommends showing a rationale before re-requesting
this permission — i.e. the user denied it once (but not permanently)
and a plain re-request without explanation is likely to be denied
again. Android-only: permission_handler always returns false on
iOS, since iOS has no equivalent signal.
