# RequestPermission

## Description

Only for Android, all other platforms will do nothing. Generates a system dialog asking the user for the specified device permission, used by certain Android commands. The permissions are as follows
"WriteExternal" - used by the SaveSharedVariable commands and any "raw:" paths that access the sdcard.
"Location" - used by the GPS commands
"Camera" - used by the SetDeviceCameraToImage command and for the AR camera feed "RecordAudio" - used by the StartScreenRecording command You can check the result of the request by calling CheckPermission. After the first request Android will give the user the option to stop displaying the request dialog. In this case this command will no longer generate a request dialog and instead do nothing. The user will have to go into the device app settings to reverse this decision.
Any permission not listed here does not require you to prompt the user for permission, it will be auto granted on install if your app requires it. All permissions that your app uses, even those that require prompting, must be specified in the APK export dialog by ticking the appropriate check boxes.

## Definition

RequestPermission( szPermission )

void agk::RequestPermission( const char* szPermission )

## Parameters

- szPermission - The permission to request