GrantGroupHandler

A specialized handler for managing multiple permissions as a single logical group.

Use this when a feature requires several unrelated permissions to be granted simultaneously (e.g., an Augmented Reality feature requiring Camera + Location).

Behavior

1. Initial Batch: Requests all denied permissions at once to minimize dialogs.

2. Sequential Cleanup: If some are denied, it iterates through them sequentially to show specific rationale or settings guidance for each.

3. Success: The onAllGranted callback is only executed when every permission in the group is either GrantStatus.GRANTED or GrantStatus.PARTIAL_GRANTED.

Usage Example

val arGrants = GrantGroupHandler(
    grantManager = grantManager,
    grants = listOf(AppGrant.CAMERA, AppGrant.LOCATION),
    scope = viewModelScope
)

arGrants.request(
    rationaleMessages = mapOf(
        AppGrant.CAMERA to "Camera is needed to render AR content",
        AppGrant.LOCATION to "Location is needed to anchor AR objects"
    )
) {
    // This block runs ONLY when BOTH permissions are granted
    launchArFeature()
}