askPermission property

bool askPermission
getter/setter pair

Should the OS permissions declared on the sections of the consentDocument be requested while going through them?

When true, tapping "NEXT" on a section which has RPConsentSection.permissions triggers the native permission dialog for each of them before moving on, so the participant is asked in context. The outcome of every request is collected in an RPPermissionResult which is added to the task result under this step's identifier. A denied permission is recorded but never blocks the participant.

false by default, in which case no permission is ever requested and no RPPermissionResult is produced.

Note that the host app is responsible for declaring the permissions it asks for in Info.plist (iOS) and AndroidManifest.xml (Android), and that RPPermissionType.health additionally needs a RPPermissions.healthHandler.

Implementation

bool askPermission;