Permission Handler

https://pub.dev/documentation/permission_handler/latest
Admin
Permission Handler is a Flutter plugin that provides a cross-platform API to request and check app...
Tokens:19,416
Snippets:279
Trust Score:9.9
Update:2 months ago
Show doc for...
Tokens:
Raw
### Permission.requestInstallPackages

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/requestInstallPackages-constant.html

A static constant representing the permission to request installing packages on Android.

```APIDOC
## Permission.requestInstallPackages

### Description
This constant is used to request the permission to install packages on Android devices (API 23+).

### Signature
`static const Permission requestInstallPackages = Permission._(24);`
```

--------------------------------

### Enable Specific Permission Macro

Source: https://pub.dev/documentation/permission_handler/latest/index.html

Example of enabling a specific permission by setting its macro value to 1.

```ruby
        ## dart: PermissionGroup.calendar
        'PERMISSION_EVENTS=1',
```

--------------------------------

### bool get isNotApplicable

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/ServiceStatusGetters/isNotApplicable.html

Checks if the current service status is not applicable for the platform.

```APIDOC
## bool get isNotApplicable

### Description
Returns true if the permission does not have an associated service on the current platform.

### Signature
`bool get isNotApplicable`

### Returns
- **bool** - True if the service status is not applicable, false otherwise.
```

--------------------------------

### bool get isDenied

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionStatusGetters/isDenied.html

Checks if the current permission status is denied.

```APIDOC
## bool get isDenied

### Description
Returns a boolean value indicating whether the user has denied access to the requested feature.

### Signature
`bool get isDenied`

### Returns
- **bool**: Returns `true` if the status is `PermissionStatus.denied`, otherwise `false`.
```

--------------------------------

### Future<bool> get isDenied

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/FuturePermissionStatusGetters/isDenied.html

Checks if the permission status is denied.

```APIDOC
## isDenied

### Description
A getter that returns a `Future<bool>`. It evaluates to `true` if the user has denied access to the requested feature, and `false` otherwise.

### Signature
`Future<bool> get isDenied`
```

--------------------------------

### bool get isEnabled

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/ServiceStatusGetters/isEnabled.html

Checks if the service status is enabled.

```APIDOC
## bool get isEnabled

### Description
Returns a boolean value indicating whether the service for the permission is currently enabled.

### Signature
`bool get isEnabled`

### Returns
- **bool** - Returns true if the service status is enabled, otherwise false.
```

--------------------------------

### Future<bool> get isLimited

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/FuturePermissionStatusGetters/isLimited.html

Checks if the permission status is limited. This property is only supported on iOS 14 and later.

```APIDOC
## Future<bool> get isLimited

### Description
Checks if the user has authorized this application for limited access. This is currently only relevant for the Photo Library picker and is supported only on iOS 14+.

### Signature
`Future<bool> get isLimited`

### Returns
- **Future<bool>** - A future that resolves to true if access is limited, otherwise false.
```

--------------------------------

### Future<PermissionStatus> get status

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionActions/status.html

Checks the current status of the given Permission.

```APIDOC
## Future<PermissionStatus> get status

### Description
Checks the current status of the given Permission.

### Notes
- **Permission.bluetooth (iOS 13.0 only)**: The method will always return PermissionStatus.denied. Use `Permission.bluetooth.request` to determine the actual permission state, noting that this may trigger a permission dialog if not previously requested.
```

--------------------------------

### bool get isGranted

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionStatusGetters/isGranted.html

Checks if the current permission status represents granted access.

```APIDOC
## bool get isGranted

### Description
Returns a boolean value indicating whether the user has granted access to the requested feature. This property evaluates to true if the current status is `PermissionStatus.granted`.

### Return Value
- **bool** - True if access is granted, false otherwise.
```

--------------------------------

### bool get isDisabled

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/ServiceStatusGetters/isDisabled.html

Checks if the current service status is equivalent to ServiceStatus.disabled.

```APIDOC
## bool get isDisabled

### Description
Returns a boolean value indicating whether the service for the permission is currently disabled.

### Signature
`bool get isDisabled`

### Returns
- **bool**: Returns `true` if the service status is `ServiceStatus.disabled`, otherwise `false`.
```

--------------------------------

### bool get isLimited

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionStatusGetters/isLimited.html

Checks if the current permission status is limited. This property returns true if the status is equal to PermissionStatus.limited.

```APIDOC
## bool get isLimited

### Description
Returns a boolean indicating if the user has authorized the application for limited access. This is currently only relevant for the Photo Library picker on iOS 14+.

### Signature
`bool get isLimited`

### Returns
- **bool**: True if the status is `PermissionStatus.limited`, otherwise false.
```

--------------------------------

### Future<bool> get isNotApplicable

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/FutureServiceStatusGetters/isNotApplicable.html

Returns a Future that resolves to a boolean indicating if the permission does not have an associated service on the current platform.

```APIDOC
## Future<bool> get isNotApplicable

### Description
Checks if the permission does not have an associated service on the current platform.

### Signature
`Future<bool> get isNotApplicable`

### Returns
- **Future<bool>** - A future that completes with true if the permission is not applicable on the current platform, otherwise false.
```

--------------------------------

### Future<bool> get isEnabled

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/FutureServiceStatusGetters/isEnabled.html

Checks if the service for the permission is enabled. Returns a Future that resolves to a boolean value.

```APIDOC
## Future<bool> get isEnabled

### Description
Checks if the service for the permission is enabled. This is an asynchronous operation that returns a boolean indicating the service status.

### Signature
`Future<bool> get isEnabled`

### Returns
- **Future<bool>** - A future that completes with true if the service is enabled, or false otherwise.
```

--------------------------------

### Future<bool> get isProvisional

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/FuturePermissionStatusGetters/isProvisional.html

Checks if the application has provisional authorization for notifications. This property is only supported on iOS 12 and later.

```APIDOC
## isProvisional

### Description
Returns a boolean indicating if the application is provisionally authorized to post non-interruptive user notifications. This property is specific to iOS (iOS 12+).

### Signature
`Future<bool> get isProvisional`

### Returns
- **Future<bool>** - A future that resolves to true if provisionally authorized, otherwise false.
```

--------------------------------

### bool get isPermanentlyDenied

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionStatusGetters/isPermanentlyDenied.html

Checks if the permission status is permanently denied. When true, the system will not show a permission dialog, and the user must manually change settings to grant access.

```APIDOC
## bool get isPermanentlyDenied

### Description
Returns a boolean indicating if the permission is permanently denied. On Android 11+, this reflects a second denial; on older Android versions, it reflects a 'never ask again' selection. On iOS, it indicates the user has denied access.

### Signature
`bool get isPermanentlyDenied`

### Returns
- **bool**: True if the permission is permanently denied, false otherwise.
```

--------------------------------

### Future<bool> get isPermanentlyDenied

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/FuturePermissionStatusGetters/isPermanentlyDenied.html

Checks if the permission is permanently denied. If true, the permission dialog will not be shown when requested. Users may still change this status via system settings.

```APIDOC
## Future<bool> get isPermanentlyDenied

### Description
Returns a boolean indicating if the permission is permanently denied. When permanently denied, the system will not show a permission dialog upon request.

### Platform Behavior
- **Android 11+ (API 30+):** Returns true if the user has denied the permission for a second time.
- **Android < 11 (API 30):** Returns true if the user denied access and selected 'never again show a request'.
- **iOS:** Returns true if the user has denied access to the requested feature.

### Usage
```dart
final status = await Permission.camera.status;
if (status.isPermanentlyDenied) {
  // The user has permanently denied the permission.
  // Direct the user to app settings.
}
```
```

--------------------------------

### Future<bool> openAppSettings()

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/openAppSettings.html

Opens the app settings page. Returns true if the app settings page could be opened, otherwise false.

```APIDOC
## openAppSettings()

### Description
Opens the application settings page for the current app. This is useful for guiding users to enable permissions that were previously denied.

### Signature
`Future<bool> openAppSettings()`

### Returns
- **bool** - Returns `true` if the app settings page was successfully opened, otherwise `false`.
```

--------------------------------

### openAppSettings()

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler

Opens the application settings page for the current app.

```APIDOC
## openAppSettings()

### Description
Opens the app settings page for the current application.

### Signature
`Future<bool> openAppSettings()`

### Returns
- **Future<bool>** - Returns true if the settings page was successfully opened, otherwise false.
```

--------------------------------

### Open app settings

Source: https://pub.dev/documentation/permission_handler/latest/index.html

Redirect the user to system settings when a permission has been permanently denied.

```dart
if (await Permission.speech.isPermanentlyDenied) {
  // The user opted to never again see the permission request dialog for this
  // app. The only way to change the permission's status now is to let the
  // user manually enables it in the system settings.
  openAppSettings();
}
```

--------------------------------

### Configure iOS Permissions in Podfile

Source: https://pub.dev/documentation/permission_handler/latest/index.html

Use these macros within the post_install block of your Podfile to enable or disable specific iOS permissions.

```ruby
post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)

    target.build_configurations.each do |config|
      # You can remove unused permissions here
      # for more information: https://github.com/Baseflow/flutter-permission-handler/blob/main/permission_handler_apple/ios/Classes/PermissionHandlerEnums.h
      # When you don't need a permission, just change its value to 0
      # e.g. 'PERMISSION_CAMERA=0' instead of 'PERMISSION_CAMERA=1'
      config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
        '$(inherited)',

        ## dart: PermissionGroup.calendar
        'PERMISSION_EVENTS=1',
        
        ## dart: PermissionGroup.calendarFullAccess
        'PERMISSION_EVENTS_FULL_ACCESS=1',

        ## dart: PermissionGroup.reminders
        'PERMISSION_REMINDERS=1',

        ## dart: PermissionGroup.contacts
        'PERMISSION_CONTACTS=1',

        ## dart: PermissionGroup.camera
        'PERMISSION_CAMERA=1',

        ## dart: PermissionGroup.microphone
        'PERMISSION_MICROPHONE=1',

        ## dart: PermissionGroup.speech
        'PERMISSION_SPEECH_RECOGNIZER=1',

        ## dart: PermissionGroup.photos
        'PERMISSION_PHOTOS=1',

        ## The 'PERMISSION_LOCATION' macro enables the `locationWhenInUse` and `locationAlways` permission. If
        ## the application only requires `locationWhenInUse`, only specify the `PERMISSION_LOCATION_WHENINUSE`
        ## macro.
        ##
        ## dart: [PermissionGroup.location, PermissionGroup.locationAlways, PermissionGroup.locationWhenInUse]
        'PERMISSION_LOCATION=1',
        'PERMISSION_LOCATION_WHENINUSE=0',

        ## dart: PermissionGroup.notification
        'PERMISSION_NOTIFICATIONS=1',

        ## dart: PermissionGroup.mediaLibrary
        'PERMISSION_MEDIA_LIBRARY=1',

        ## dart: PermissionGroup.sensors
        'PERMISSION_SENSORS=1',

        ## dart: PermissionGroup.bluetooth
        'PERMISSION_BLUETOOTH=1',

        ## dart: PermissionGroup.appTrackingTransparency
        'PERMISSION_APP_TRACKING_TRANSPARENCY=1',

        ## dart: PermissionGroup.criticalAlerts
        'PERMISSION_CRITICAL_ALERTS=1',

        ## dart: PermissionGroup.assistant
        'PERMISSION_ASSISTANT=1',
      ]

    end
  end
end
```

--------------------------------

### Implementation of openAppSettings

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/openAppSettings.html

The internal implementation of the openAppSettings function.

```dart
Future<bool> openAppSettings() => _handler.openAppSettings();
```

--------------------------------

### Configure AndroidX in gradle.properties

Source: https://pub.dev/documentation/permission_handler/latest/index.html

Required settings for Android projects to support AndroidX libraries.

```properties
android.useAndroidX=true
android.enableJetifier=true
```

--------------------------------

### Define requestInstallPackages constant

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/requestInstallPackages-constant.html

The constant is defined as a static Permission instance with an internal identifier of 24.

```dart
static const requestInstallPackages = Permission._(24);
```

--------------------------------

### Permission.photos Implementation

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/photos-constant.html

The internal definition of the photos permission constant.

```dart
static const photos = Permission._(9);
```

--------------------------------

### Configure Notification Permissions via Environment Variables

Source: https://pub.dev/documentation/permission_handler/latest/index.html

Commands to opt out of notification permissions when building for iOS.

```bash
# When building from terminal (flutter run / flutter build)
export PERMISSION_NOTIFICATIONS=0

# When building from Xcode GUI (set once per Mac session, then restart Xcode)
launchctl setenv PERMISSION_NOTIFICATIONS 0
```

--------------------------------

### Future<bool> get isDisabled

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/FutureServiceStatusGetters/isDisabled.html

Checks if the service for the permission is disabled. Returns a Future that resolves to a boolean value.

```APIDOC
## isDisabled

### Description
Returns a boolean indicating if the service for the permission is disabled.

### Signature
`Future<bool> get isDisabled`

### Returns
- **Future<bool>** - A future that completes with true if the service is disabled, otherwise false.
```

--------------------------------

### request()

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionListActions.html

Requests the user for access to a list of permissions, if they haven't already been granted before.

```APIDOC
## request()

### Description
Requests the user for access to the list of permissions. If the permissions have not been granted previously, the system will prompt the user.

### Signature
`Future<Map<Permission, PermissionStatus>> request()`

### Returns
- **Future<Map<Permission, PermissionStatus>>**: A map containing each requested permission and its corresponding status after the request process.
```

--------------------------------

### Handle permission callbacks

Source: https://pub.dev/documentation/permission_handler/latest/index.html

Use a fluent API to define callbacks for various permission states before requesting access.

```dart
await Permission.camera
  .onDeniedCallback(() {
    // Your code
  })
  .onGrantedCallback(() {
    // Your code
  })
  .onPermanentlyDeniedCallback(() {
    // Your code
  })
  .onRestrictedCallback(() {
    // Your code
  })
  .onLimitedCallback(() {
    // Your code
  })
  .onProvisionalCallback(() {
    // Your code
  })
  .request();
```

--------------------------------

### Enable Critical Alerts via Environment Variables

Source: https://pub.dev/documentation/permission_handler/latest/index.html

Commands to explicitly enable critical alert permissions for iOS builds.

```bash
# When building from terminal
export PERMISSION_CRITICAL_ALERTS=1

# When building from Xcode GUI
launchctl setenv PERMISSION_CRITICAL_ALERTS 1
```

--------------------------------

### Implementation of isProvisional

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/FuturePermissionStatusGetters/isProvisional.html

The implementation of the isProvisional getter for FuturePermissionStatus.

```dart
Future<bool> get isProvisional async => (await this).isProvisional;
```

--------------------------------

### Permission.values

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/values-constant.html

Returns a list of all possible Permission values available in the system.

```APIDOC
## Permission.values

### Description
Returns a list of all possible `Permission` values supported by the library.

### Signature
`static const List<Permission> values`

### Returns
- **List<Permission>** - A list containing all defined permission constants.
```

--------------------------------

### bool get isRestricted

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionStatusGetters/isRestricted.html

Checks if the permission status is restricted, meaning the user cannot change the app's status due to OS-level restrictions.

```APIDOC
## bool get isRestricted

### Description
Returns true if the OS denied access to the requested feature and the user cannot change the app's status, typically due to active restrictions like parental controls. This property is only supported on iOS.

### Return Value
- **bool** - Returns true if the status is restricted, false otherwise.
```

--------------------------------

### Future<bool> get isRestricted

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/FuturePermissionStatusGetters/isRestricted.html

Checks if the OS has denied access to the requested feature due to active restrictions. This property is only supported on iOS.

```APIDOC
## Future<bool> get isRestricted

### Description
Checks if the OS has denied access to the requested feature. The user cannot change this app's status, possibly due to active restrictions such as parental controls being in place.

### Platform Support
- iOS (Only)

### Return Value
- **Future<bool>** - Returns true if access is restricted by the OS, otherwise false.
```

--------------------------------

### Permission Callback Methods

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission-class.html

Methods to register callbacks for specific permission states such as granted, denied, or restricted.

```APIDOC
## Permission Callback Methods

### Description
These methods allow you to attach callbacks to a Permission object to handle specific permission state changes.

### Methods
- **onGrantedCallback(FutureOr<void>? callback()?) -> Permission**
- **onDeniedCallback(FutureOr<void>? callback()?) -> Permission**
- **onLimitedCallback(FutureOr<void>? callback()?) -> Permission**
- **onPermanentlyDeniedCallback(FutureOr<void>? callback()?) -> Permission**
- **onProvisionalCallback(FutureOr<void>? callback()?) -> Permission**
- **onRestrictedCallback(FutureOr<void>? callback()?) -> Permission**
```

--------------------------------

### Permission Constants

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission-class.html

A list of available permission constants that can be used to check or request access to device features.

```APIDOC
## Permission Constants

### Description
The following constants represent specific permissions available for request. These are used to interact with the device's privacy and hardware settings.

### Available Permissions
- **accessMediaLocation**: Permission for accessing the device's media library.
- **accessNotificationPolicy**: Permission for accessing the device's notification policy.
- **activityRecognition**: Permission for accessing the activity recognition.
- **appTrackingTransparency**: Permission for accessing the device's tracking state (iOS only).
- **assistant**: Android: Nothing, iOS: SiriKit.
- **audio**: Permission for accessing the device's audio files from external storage.
- **backgroundRefresh**: Permission for reading the current background refresh status (iOS only).
- **bluetooth**: Permission for accessing the device's bluetooth adapter state.
- **bluetoothAdvertise**: Permission for advertising Bluetooth devices.
- **bluetoothConnect**: Permission for connecting to Bluetooth devices.
- **bluetoothScan**: Permission for scanning for Bluetooth devices.
- **calendar**: Permission for accessing the device's calendar.
- **calendarFullAccess**: Permission for reading from and writing to the device's calendar.
- **calendarWriteOnly**: Permission for writing to the device's calendar.
- **camera**: Permission for accessing the device's camera.
- **contacts**: Permission for accessing the device's contacts.
- **criticalAlerts**: Permission for sending critical alerts (iOS only).
- **ignoreBatteryOptimizations**: Permission for accessing ignore battery optimizations (Android only).
- **location**: Permission for accessing the device's location.
- **locationAlways**: Permission for accessing the device's location when the app is running in the background.
- **locationWhenInUse**: Permission for accessing the device's location when the app is running in the foreground.
- **manageExternalStorage**: Permission for accessing the device's external storage.
- **mediaLibrary**: Permission for accessing the device's media library (iOS 9.3+ only).
- **microphone**: Permission for accessing the device's microphone.
- **nearbyWifiDevices**: Permission for connecting to nearby devices via Wi-Fi.
- **notification**: Permission for pushing notifications.
- **phone**: Permission for accessing the device's phone state (Android only).
- **photos**: Permission for accessing the device's photos.
- **photosAddOnly**: Permission for adding photos to the device's photo library (iOS only).
- **reminders**: Permission for accessing the device's reminders (iOS only).
- **requestInstallPackages**: Permission for requesting installing packages.
- **scheduleExactAlarm**: Permission for scheduling exact alarms.
- **sensors**: Permission for accessing the device's sensors.
- **sensorsAlways**: Permission for accessing the device's sensors in background.
- **sms**: Permission for sending and reading SMS messages (Android only).
- **speech**: Permission for accessing speech recognition.
- **storage**: Permission for accessing external storage.
- **systemAlertWindow**: Permission for creating system alert window (Android only).
- **videos**: Permission for accessing the device's video files from external storage.
```

--------------------------------

### Permission.assistant

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/assistant-constant.html

Represents the assistant permission constant used for requesting access to assistant services.

```APIDOC
## Permission.assistant

### Description
A static constant representing the assistant permission. This permission is primarily used to manage access to assistant-related functionality.

### Platform Support
- **Android**: Not supported
- **iOS**: Supported (SiriKit)

### Implementation
```dart
static const assistant = Permission._(38);
```
```

--------------------------------

### shouldShowRequestRationale

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionActions/shouldShowRequestRationale.html

A getter that returns a Future<bool> indicating whether a rationale should be shown for the permission. On Android, it checks the platform's rationale requirement; on iOS, it always returns false.

```APIDOC
## Future<bool> get shouldShowRequestRationale

### Description
Checks if the application should show a rationale for requesting a specific permission. This is primarily used to provide context to the user before the system permission dialog appears.

### Platform Support
- **Android**: Returns true if the system suggests showing a rationale.
- **iOS**: Always returns false.
```

--------------------------------

### Permission Check Shortcuts

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission-class.html

Extension methods on the Permission class to quickly check specific permission states.

```APIDOC
## Permission Check Methods

### Methods
- **isDenied**: Returns `Future<bool>`. True if the user denied this permission.
- **isGranted**: Returns `Future<bool>`. True if the user granted this permission.
- **isLimited**: Returns `Future<bool>`. True if the user authorized limited access (iOS 14+ for photos, iOS 18+ for contacts).
- **isPermanentlyDenied**: Returns `Future<bool>`. True when permissions are denied permanently.
- **isProvisional**: Returns `Future<bool>`. True if the application is provisionally authorized for notifications (iOS only).
- **isRestricted**: Returns `Future<bool>`. True if the OS denied this permission due to restrictions like parental controls (iOS only).
```

--------------------------------

### Define Permission.storage constant

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/storage-constant.html

The internal definition of the storage permission constant.

```dart
static const storage = Permission._(15);
```

--------------------------------

### Permission Status and Actions

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission-class.html

Methods available on the Permission class to check the current status and request rationale for permissions.

```APIDOC
## Permission.status

### Description
Checks the current status of the given Permission.

### Returns
- **Future<PermissionStatus>** - The current status of the permission.

## Permission.shouldShowRequestRationale

### Description
Determines if the application should show a rationale for requesting the permission.

### Returns
- **Future<bool>** - True if a rationale should be shown, false otherwise.
```

--------------------------------

### Permission.camera constant definition

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/camera-constant.html

The static constant definition for the camera permission.

```dart
static const camera = Permission._(1);
```

--------------------------------

### Configure SiriKit Entitlements for iOS

Source: https://pub.dev/documentation/permission_handler/latest/index.html

Add the SiriKit entitlement to your Runner.entitlements file to prevent application termination when requesting assistant permissions.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>com.apple.developer.siri</key>
	<true/>
</dict>
</plist>
```

--------------------------------

### Define Permission.audio constant

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/audio-constant.html

This constant represents the permission for accessing audio files on Android 13+.

```dart
static const audio = Permission._(33);
```

--------------------------------

### PermissionWithService.private Constructor Implementation

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionWithService/PermissionWithService.private.html

This constructor is intended for testing purposes only and is marked with @visibleForTesting.

```dart
@visibleForTesting
const PermissionWithService.private(super.value) : super._();
```

--------------------------------

### Check request rationale

Source: https://pub.dev/documentation/permission_handler/latest/index.html

Determine if the OS requires showing a rationale for a permission request on Android.

```dart
bool isShown = await Permission.contacts.shouldShowRequestRationale;
```

--------------------------------

### Permission.systemAlertWindow

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/systemAlertWindow-constant.html

The systemAlertWindow constant is used to request the permission to display windows over other apps on Android.

```APIDOC
## Permission.systemAlertWindow

### Description
Permission for creating system alert windows on Android. This allows an application to display windows on top of all other applications.

### Usage
`Permission.systemAlertWindow`

### Platform
- Android
```

--------------------------------

### Future<PermissionStatus> request()

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionActions/request.html

Requests the user for access to the specific permission. If access has not been granted, it triggers the system dialog and returns the resulting PermissionStatus.

```APIDOC
## Method: request()

### Description
Requests the user for access to this Permission, if access hasn't already been granted before. Returns the new PermissionStatus.

### Signature
`Future<PermissionStatus> request()`

### Returns
- **PermissionStatus** - The updated status of the permission after the request process.
```

--------------------------------

### Permission status implementation

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionActions/status.html

The internal implementation of the status getter using the permission handler.

```dart
Future<PermissionStatus> get status => _handler.checkPermissionStatus(this);
```

--------------------------------

### String toString()

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/toString.html

Returns a string representation of the Permission object, formatted as 'Permission.name'.

```APIDOC
## String toString()

### Description
Returns a string representation of this object. This method is typically used for debugging or logging to provide useful information about the Permission instance.

### Signature
`String toString()`

### Returns
- **String** - A string representation of the object in the format 'Permission.{name}'.
```

--------------------------------

### request()

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission-class.html

Requests access for the specific permission.

```APIDOC
## request()

### Description
Requests the user for access to this Permission, if access hasn't already been granted before.

### Returns
- **Future<PermissionStatus>** - A future that resolves to the status of the permission after the request.
```

--------------------------------

### Permission.videos

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/videos-constant.html

A constant representing the permission required to access video files on Android devices.

```APIDOC
## Permission.videos

### Description
Permission constant for accessing the device's video files from external storage. This is specifically applicable for Android 13+ (API 33+).

### Definition
`static const videos = Permission._(32);`
```

--------------------------------

### Request permissions

Source: https://pub.dev/documentation/permission_handler/latest/index.html

Request single or multiple permissions and handle the resulting status.

```dart
if (await Permission.contacts.request().isGranted) {
  // Either the permission was already granted before or the user just granted it.
}

// You can request multiple permissions at once.
Map<Permission, PermissionStatus> statuses = await [
  Permission.location,
  Permission.storage,
].request();
print(statuses[Permission.location]);
```

--------------------------------

### Implementation of toString for Permission

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/toString.html

Returns a string representation of the Permission object using its internal name mapping.

```dart
@override
String toString() => 'Permission.${_names[value]}';
```

--------------------------------

### Microphone Permission Constant Implementation

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/microphone-constant.html

Defines the microphone permission constant within the Permission class.

```dart
static const microphone = Permission._(7);
```

--------------------------------

### Permission.audio

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/audio-constant.html

The Permission.audio constant represents the permission required to access audio files on Android 13+ devices.

```APIDOC
## Permission.audio

### Description
Represents the permission for accessing the device's audio files from external storage. This is specifically applicable for Android 13+ (API 33+).

### Definition
`static const audio = Permission._(33);`
```

--------------------------------

### Define systemAlertWindow constant

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/systemAlertWindow-constant.html

This constant represents the permission required for creating system alert windows on Android.

```dart
static const systemAlertWindow = Permission._(23);
```

--------------------------------

### Define accessMediaLocation constant

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/accessMediaLocation-constant.html

Internal definition of the accessMediaLocation permission constant.

```dart
static const accessMediaLocation = Permission._(18);
```

--------------------------------

### Permission.videos Constant Definition

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/videos-constant.html

The static constant definition for accessing video files on Android 13+.

```dart
static const videos = Permission._(32);
```

--------------------------------

### Access all Permission values

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/values-constant.html

Retrieves a list containing every defined Permission constant.

```dart
static const List<Permission> values = <Permission>[
  // ignore: deprecated_member_use_from_same_package
  calendar,
  camera,
  contacts,
  location,
  locationAlways,
  locationWhenInUse,
  mediaLibrary,
  microphone,
  phone,
  photos,
  photosAddOnly,
  reminders,
  sensors,
  sms,
  speech,
  storage,
  ignoreBatteryOptimizations,
  notification,
  accessMediaLocation,
  activityRecognition,
  unknown,
  bluetooth,
  manageExternalStorage,
  systemAlertWindow,
  requestInstallPackages,
  appTrackingTransparency,
  criticalAlerts,
  accessNotificationPolicy,
  bluetoothScan,
  bluetoothAdvertise,
  bluetoothConnect,
  nearbyWifiDevices,
  videos,
  audio,
  scheduleExactAlarm,
  sensorsAlways,
  calendarWriteOnly,
  calendarFullAccess,
  assistant,
  backgroundRefresh,
];
```

--------------------------------

### Permission.sensors

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/sensors-constant.html

A static constant representing the permission required to access device sensors.

```APIDOC
## Permission.sensors

### Description
Permission constant used to request access to the device's sensors. On Android, this maps to Body Sensors, and on iOS, it maps to CoreMotion.

### Signature
`static const Permission sensors = Permission._(12);`
```

--------------------------------

### PermissionActions Methods

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionActions.html

Methods to request permissions and register callbacks for specific permission outcomes.

```APIDOC
## Methods

### request()
- **Returns**: Future<PermissionStatus>
- **Description**: Requests user access for the permission if it has not been granted previously.

### Callback Registration Methods
- **onDeniedCallback(FutureOr<void>? callback()?)**: Sets a callback for when permission is denied.
- **onGrantedCallback(FutureOr<void>? callback()?)**: Sets a callback for when permission is granted.
- **onLimitedCallback(FutureOr<void>? callback()?)**: Sets a callback for when permission is limited.
- **onPermanentlyDeniedCallback(FutureOr<void>? callback()?)**: Sets a callback for when permission is permanently denied.
- **onProvisionalCallback(FutureOr<void>? callback()?)**: Sets a callback for when permission is provisional.
- **onRestrictedCallback(FutureOr<void>? callback()?)**: Sets a callback for when permission is restricted.
```

--------------------------------

### Define Permission.speech constant

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/speech-constant.html

The internal definition of the speech permission constant.

```dart
static const speech = Permission._(14);
```

--------------------------------

### onProvisionalCallback(FutureOr<void>? Function()? callback)

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionActions/onProvisionalCallback.html

Sets a callback function to be executed when a permission is in a provisional state. This method returns the current Permission instance to allow for method chaining.

```APIDOC
## onProvisionalCallback

### Description
Sets a callback for when a permission is provisional. This method is part of the Permission configuration flow.

### Signature
`Permission onProvisionalCallback(FutureOr<void>? Function()? callback)`

### Parameters
- **callback** (FutureOr<void>? Function()?) - Optional - A function to be invoked when the permission status is provisional.

### Returns
- **Permission** - Returns the current instance to support method chaining.
```

--------------------------------

### Implementation of isProvisional

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionStatusGetters/isProvisional.html

Checks if the current permission status is equal to PermissionStatus.provisional.

```dart
bool get isProvisional => this == PermissionStatus.provisional;
```

--------------------------------

### Define Bluetooth Permission Constant

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/bluetooth-constant.html

The internal definition of the bluetooth permission constant.

```dart
static const bluetooth = PermissionWithService._(21);
```

--------------------------------

### Permission.ignoreBatteryOptimizations

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/ignoreBatteryOptimizations-constant.html

A constant representing the permission to ignore battery optimizations on Android. This is part of the Permission class.

```APIDOC
## Permission.ignoreBatteryOptimizations

### Description
Represents the permission for accessing ignore battery optimizations. This constant is specific to the Android platform.

### Signature
`static const Permission ignoreBatteryOptimizations = Permission._(16);`
```

--------------------------------

### Permission value property implementation

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/value.html

The integer representation of the Permission.

```dart
final int value;
```

--------------------------------

### Permission.byValue(int value)

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/Permission.byValue.html

Creates a Permission instance using the supplied integer value.

```APIDOC
## Permission.byValue(int value)

### Description
Creates a Permission instance using the supplied integer value. This factory constructor retrieves the corresponding permission from the internal values list.

### Parameters
- **value** (int) - Required - The integer value representing the specific permission.
```

--------------------------------

### Define assistant permission constant

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/assistant-constant.html

Defines the assistant permission constant with an internal identifier.

```dart
static const assistant = Permission._(38);
```

--------------------------------

### Permission.nearbyWifiDevices

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/nearbyWifiDevices-constant.html

A constant representing the permission required to connect to nearby Wi-Fi devices. This is applicable for Android 13+ (API 33+).

```APIDOC
## Permission.nearbyWifiDevices

### Description
Permission constant used to request access for connecting to nearby devices via Wi-Fi. This permission is required for Android 13 (API level 33) and higher.

### Signature
`static const Permission nearbyWifiDevices = Permission._(31);`
```

--------------------------------

### Check permission denial status

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionCheckShortcuts/isDenied.html

Use this property to verify if a permission status is currently denied.

```dart
Future<bool> get isDenied => status.isDenied;
```

--------------------------------

### Implementation of shouldShowRequestRationale

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionActions/shouldShowRequestRationale.html

The property checks the platform and delegates to the handler if on Android, returning false otherwise.

```dart
Future<bool> get shouldShowRequestRationale async {
  if (defaultTargetPlatform != TargetPlatform.android) {
    return false;
  }

  return _handler.shouldShowRequestPermissionRationale(this);
}
```

--------------------------------

### Define bluetoothAdvertise constant

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/bluetoothAdvertise-constant.html

The constant definition for the bluetoothAdvertise permission.

```dart
static const bluetoothAdvertise = Permission._(29);
```

--------------------------------

### PermissionListActions.request implementation

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionListActions/request.html

The internal implementation of the request method which delegates to the handler.

```dart
Future<Map<Permission, PermissionStatus>> request() =>
    _handler.requestPermissions(this);
```

--------------------------------

### Permission.scheduleExactAlarm

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/scheduleExactAlarm-constant.html

A constant representing the permission for scheduling exact alarms on Android devices running API level 31 or higher.

```APIDOC
## Permission.scheduleExactAlarm

### Description
This constant is used to request or check the permission required to schedule exact alarms on Android 12 (API 31) and above.

### Signature
`static const Permission scheduleExactAlarm = Permission._(34);`

### Platform Support
- Android 12+ (API 31+)
```

--------------------------------

### Set compileSdkVersion in build.gradle

Source: https://pub.dev/documentation/permission_handler/latest/index.html

Ensure the compileSdkVersion is set to 35 in the app-level build.gradle file.

```gradle
android {
  compileSdkVersion 35
  ...
}
```

--------------------------------

### Permission request implementation

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionActions/request.html

This method handles the permission request flow and triggers corresponding callbacks based on the resulting status.

```dart
Future<PermissionStatus> request() async {
  final permissionStatus =
      (await [this].request())[this] ?? PermissionStatus.denied;

  if (permissionStatus.isDenied) {
    _onDenied?.call();
  } else if (permissionStatus.isGranted) {
    _onGranted?.call();
  } else if (permissionStatus.isPermanentlyDenied) {
    _onPermanentlyDenied?.call();
  } else if (permissionStatus.isRestricted) {
    _onRestricted?.call();
  } else if (permissionStatus.isLimited) {
    _onLimited?.call();
  } else if (permissionStatus.isProvisional) {
    _onProvisional?.call();
  }

  return permissionStatus;
}
```

--------------------------------

### Define location permission constant

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/location-constant.html

The static constant used to represent the location permission service.

```dart
static const location = PermissionWithService._(3);
```

--------------------------------

### Define calendarFullAccess constant

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/calendarFullAccess-constant.html

The static constant definition for the calendarFullAccess permission.

```dart
static const calendarFullAccess = Permission._(37);
```

--------------------------------

### Implementation of onProvisionalCallback

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionActions/onProvisionalCallback.html

Sets the internal _onProvisional callback and returns the current Permission instance for chaining.

```dart
Permission onProvisionalCallback(FutureOr<void>? Function()? callback) {
  _onProvisional = callback;
  return this;
}
```

--------------------------------

### Permission.calendarFullAccess

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/calendarFullAccess-constant.html

A constant representing the permission to access the device's calendar for both reading and writing operations.

```APIDOC
## Permission.calendarFullAccess

### Description
Permission constant used to request access for reading from and writing to the device's calendar.

### Signature
`static const Permission calendarFullAccess = Permission._(37);`
```

--------------------------------

### Permission.camera

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/camera-constant.html

The camera constant is used to request or check the status of the device's camera permission.

```APIDOC
## Permission.camera

### Description
Permission for accessing the device's camera. On Android, this maps to the camera hardware, while on iOS, it covers access to the camera and photos (Camera Roll).

### Implementation
`static const camera = Permission._(1);`
```

--------------------------------

### onLimitedCallback(FutureOr<void>? Function()? callback)

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionActions/onLimitedCallback.html

Sets a callback function to be executed when a permission is in a limited state. This method returns the current instance to allow for method chaining.

```APIDOC
## onLimitedCallback

### Description
Sets a callback function that is invoked when a permission status is limited. This method is part of the permission configuration flow.

### Signature
`Permission onLimitedCallback(FutureOr<void>? Function()? callback)`

### Parameters
- **callback** (FutureOr<void>? Function()?) - Required - The function to execute when the permission is limited.

### Returns
- **Permission** - Returns the current instance for method chaining.
```

--------------------------------

### Permission.microphone

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/microphone-constant.html

The microphone constant represents the permission required to access the device's microphone hardware.

```APIDOC
## Permission.microphone

### Description
A static constant representing the permission for accessing the device's microphone. This is used within the permission_handler library to manage microphone access requests.

### Signature
`static const Permission microphone = Permission._(7);`
```

--------------------------------

### isNotApplicable

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/FutureServiceStatusGetters.html

Checks if the permission does not have an associated service on the current platform.

```APIDOC
## isNotApplicable

### Description
Returns a Future<bool> indicating if the permission does not have an associated service on the current platform.

### Signature
Future<bool> get isNotApplicable
```

--------------------------------

### Check Permission Status on Android

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/photos-constant.html

Logic to determine whether to check storage or photos permission based on the Android SDK version.

```dart
if (Platform.isAndroid) { final androidInfo = await DeviceInfoPlugin().androidInfo; if (androidInfo.version.sdkInt <= 32) { use `Permission.storage.status` } else { use `Permission.photos.status` } }
```

--------------------------------

### Permission.bluetooth

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/bluetooth-constant.html

Represents the permission for accessing the device's bluetooth adapter state. This constant is used to check or request bluetooth-related permissions.

```APIDOC
## Permission.bluetooth

### Description
Permission for accessing the device's bluetooth adapter state. Usage varies by platform and OS version.

### Platform Notes
- **Android**: Always allowed.
- **iOS 13+**: Represents the authorization state of the Core Bluetooth manager.
- **iOS < 13**: Always allowed.

### Limitations
- **iOS 13.0**: `bluetooth.status` always returns `PermissionStatus.denied`. Use `bluetooth.request` to check status, noting that this may trigger a permission dialog.
- **All iOS**: `bluetooth.serviceStatus` returns `ServiceStatus.disabled` if the permission is denied. Obtaining the actual service status requires the permission to be granted.
```

--------------------------------

### Define manageExternalStorage constant

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/manageExternalStorage-constant.html

The internal definition of the manageExternalStorage permission constant.

```dart
static const manageExternalStorage = Permission._(22);
```

--------------------------------

### isDenied

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionCheckShortcuts/isDenied.html

A getter that returns a Future<bool> indicating whether the permission status is denied.

```APIDOC
## isDenied

### Description
Returns a boolean value indicating if the permission has been denied by the user.

### Signature
`Future<bool> get isDenied`

### Returns
- **bool** - True if the permission is denied, false otherwise.
```

--------------------------------

### Permission.mediaLibrary

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/mediaLibrary-constant.html

The mediaLibrary constant is used to request or check permissions for accessing the device's media library on iOS.

```APIDOC
## Permission.mediaLibrary

### Description
Permission constant used to access the device's media library. This is applicable for iOS 9.3 and later.

### Signature
`static const Permission mediaLibrary = Permission._(6);`
```

--------------------------------

### Implementation of onLimitedCallback

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionActions/onLimitedCallback.html

Sets the callback function for limited permission status and returns the current instance.

```dart
Permission onLimitedCallback(FutureOr<void>? Function()? callback) {
  _onLimited = callback;
  return this;
}
```

--------------------------------

### Implementation of serviceStatus

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/ServicePermissionActions/serviceStatus.html

The internal implementation of the serviceStatus getter using the handler's checkServiceStatus method.

```dart
Future<ServiceStatus> get serviceStatus => _handler.checkServiceStatus(this);
```

--------------------------------

### ServiceStatus Getters

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/ServiceStatus.html

Extension methods available on ServiceStatus to check the current state.

```APIDOC
## ServiceStatus Getters

- **isDisabled** (bool): Returns true if the service is disabled.
- **isEnabled** (bool): Returns true if the service is enabled.
- **isNotApplicable** (bool): Returns true if the service is not applicable on the current platform.
```

--------------------------------

### Permission.photosAddOnly

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/photosAddOnly-constant.html

A constant representing the permission to add photos to the device library. This is specific to iOS 14 and later versions. If read access is required, the standard 'photos' permission should be used instead.

```APIDOC
## Permission.photosAddOnly

### Description
Permission for adding photos to the device's photo library. This constant is applicable only to iOS 14+ devices for write-only access.

### Usage
Use this constant when your application needs to save photos to the user's library but does not require permission to read existing photos.

### Platform Support
- **iOS**: Supported (iOS 14+ read & write access level)
```

--------------------------------

### Check service status

Source: https://pub.dev/documentation/permission_handler/latest/index.html

Verify if the service associated with a permission, such as location, is enabled.

```dart
if (await Permission.locationWhenInUse.serviceStatus.isEnabled) {
  // Use location.
}
```

--------------------------------

### Define Permission.sms constant

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/sms-constant.html

The constant definition for the SMS permission within the Permission class.

```dart
static const sms = Permission._(13);
```

--------------------------------

### Define notification permission constant

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/notification-constant.html

Represents the permission required for pushing notifications.

```dart
static const notification = Permission._(17);
```

--------------------------------

### Permission.activityRecognition

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/activityRecognition-constant.html

Represents the permission for accessing activity recognition data. This is a static constant used within the Permission class.

```APIDOC
## Permission.activityRecognition

### Description
Accesses the activity recognition permission. This is required for apps that need to detect user activity on Android 10 (API level 29) and above.

### Signature
`static const Permission activityRecognition = Permission._(19);`
```

--------------------------------

### Define scheduleExactAlarm constant

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/scheduleExactAlarm-constant.html

The constant definition for the scheduleExactAlarm permission.

```dart
static const scheduleExactAlarm = Permission._(34);
```

--------------------------------

### Android Manifest Permissions

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/photos-constant.html

Required manifest entries for Android to handle different API levels for photo access.

```xml
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32"/> <uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>
```

--------------------------------

### Permission.bluetoothAdvertise

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/bluetoothAdvertise-constant.html

Represents the permission required to advertise Bluetooth devices. This is specifically applicable for Android 12 (API level 31) and higher.

```APIDOC
## Permission.bluetoothAdvertise

### Description
Allows the application to make the device discoverable to other Bluetooth devices. This permission is required for Android 12+ (API 31+).

### Signature
`static const Permission bluetoothAdvertise = Permission._(29);`
```

--------------------------------

### Permission.phone

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/phone-constant.html

A constant representing the permission required to access the device's phone state on Android.

```APIDOC
## Permission.phone

### Description
This constant represents the permission for accessing the device's phone state. It is applicable only on the Android platform.

### Type
PermissionWithService

### Usage
Use this constant when requesting phone state permissions via the permission_handler library.
```

--------------------------------

### Permission.manageExternalStorage

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/manageExternalStorage-constant.html

A constant representing the permission for accessing the device's external storage on Android 11 and higher.

```APIDOC
## Permission.manageExternalStorage

### Description
This constant provides access to the 'Manage External Storage' permission on Android 11+ (API 30+). It allows an application broad access to external storage in scoped storage environments.

### Usage Note
- Use this permission only when privacy-friendly APIs (Storage Access Framework or MediaStore) are insufficient.
- Apps using this permission must complete the Permission Declaration Form when submitting to the Google Play Store.
```

--------------------------------

### serviceStatus

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionWithService-class.html

Checks the current status of the service associated with the given Permission.

```APIDOC
## Future<ServiceStatus> serviceStatus

### Description
Checks the current status of the service associated with the given Permission. This is provided by the ServicePermissionActions extension.

### Returns
- **Future<ServiceStatus>** - A future that resolves to the current status of the associated service.
```

--------------------------------

### Define sensors permission constant

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/sensors-constant.html

The static constant used to represent the sensors permission.

```dart
static const sensors = Permission._(12);
```

--------------------------------

### onDeniedCallback(FutureOr<void>? Function()? callback)

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionActions/onDeniedCallback.html

Sets a callback function to be executed when a permission is denied. Returns the current Permission instance for chaining.

```APIDOC
## onDeniedCallback

### Description
Sets a callback function that will be invoked when a permission request is denied. This method returns the current instance to allow for method chaining.

### Signature
`Permission onDeniedCallback(FutureOr<void>? Function()? callback)`

### Parameters
- **callback** (FutureOr<void>? Function()?) - Optional - The function to execute when the permission is denied.

### Returns
- **Permission** - The current Permission instance.
```

--------------------------------

### Permission.byValue Implementation

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/Permission.byValue.html

The factory constructor maps an integer value to the corresponding Permission enum value.

```dart
factory Permission.byValue(int value) => values[value];
```

--------------------------------

### Permission.sensorsAlways

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/sensorsAlways-constant.html

A constant representing the permission for accessing device sensors in the background.

```APIDOC
## Permission.sensorsAlways

### Description
Permission for accessing the device's sensors in the background. This is applicable for Android 13+ (API 33+).

### Signature
`static const Permission sensorsAlways = Permission._(35);`
```

--------------------------------

### Permission.calendarWriteOnly

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/calendarWriteOnly-constant.html

A constant representing the permission to write to the device's calendar.

```APIDOC
## Permission.calendarWriteOnly

### Description
Permission for writing to the device's calendar. On iOS 16 and lower, this permission is identical to Permission.calendarFullAccess.

### Signature
`static const Permission calendarWriteOnly = Permission._(36);`
```

--------------------------------

### Define nearbyWifiDevices constant

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/nearbyWifiDevices-constant.html

The constant is defined as a static Permission instance with an internal identifier of 31.

```dart
static const nearbyWifiDevices = Permission._(31);
```

--------------------------------

### Permission Status Properties

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/PermissionCheckShortcuts.html

A collection of properties available on the Permission class to check the current authorization status.

```APIDOC
## Permission Status Properties

### Description
These properties allow for checking the status of a permission directly on a `Permission` object.

### Properties
- **isDenied** (Future<bool>) - Returns true if the user denied this permission.
- **isGranted** (Future<bool>) - Returns true if the user granted this permission.
- **isLimited** (Future<bool>) - Returns true if the user authorized limited access (iOS 14+ for photos, iOS 18+ for contacts).
- **isPermanentlyDenied** (Future<bool>) - Returns true when permissions are denied permanently.
- **isProvisional** (Future<bool>) - Returns true if the application is provisionally authorized for notifications (iOS only).
- **isRestricted** (Future<bool>) - Returns true if the OS denied the permission due to active restrictions like parental controls (iOS only).
```

--------------------------------

### Define mediaLibrary constant

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/mediaLibrary-constant.html

The static constant definition for the mediaLibrary permission.

```dart
static const mediaLibrary = Permission._(6);
```

--------------------------------

### Define reminders permission constant

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/reminders-constant.html

This constant represents the permission for accessing device reminders on iOS.

```dart
static const reminders = Permission._(11);
```

--------------------------------

### Implementation of isNotApplicable

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/ServiceStatusGetters/isNotApplicable.html

Returns true if the current ServiceStatus is notApplicable.

```dart
bool get isNotApplicable => this == ServiceStatus.notApplicable;
```

--------------------------------

### Permission.contacts constant definition

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/contacts-constant.html

The static constant definition for the contacts permission.

```dart
static const contacts = Permission._(2);
```

--------------------------------

### Define sensorsAlways constant

Source: https://pub.dev/documentation/permission_handler/latest/permission_handler/Permission/sensorsAlways-constant.html

The constant definition for background sensor access permission.

```dart
static const sensorsAlways = Permission._(35);
```
Tokens:
Raw