mosaic-server/dev.catbit.mosaic.server.builder.event.builders.security/RequestPermission

RequestPermission

fun EventSchemaBuilderScope.RequestPermission(id: String = randomId(), trigger: EventTrigger, events: EventSchemaBuilderScope.() -> Unit = {}, permissions: List<RequestPermissionEventSchema.Permissions>)

Asks the platform for the runtime permissions, through the client's PermissionManager. Does not consume incomingData. Dispatches onPermissionsAcquired then onSuccess (both no data) when every requested permission was granted; onPermissionsDenied then onFailure (both no data) when the request was denied; onPermissionRationale (no data) when the platform asks for a rationale to be shown before requesting again — chain the explanation onto this trigger and request once more.

Parameters

Unique identifier of this event. Defaults to a random id.

trigger

Trigger that fires this event, built via EventTriggers.

events

Child events chained after this one, wired to its triggers (onPermissionsAcquired, onPermissionsDenied, onPermissionRationale, onSuccess, onFailure).

permissions

Runtime permissions requested, built with cameraPermission, galleryPermission, storagePermission, microphonePermission, locationPermission, notificationPermission or contactsPermission.