presentLimited static method

Future<void> presentLimited({ RequestType type = RequestType.all, })

Prompts the limited assets selection modal on iOS, or the system photo picker on Android 14+ (API 34+).

On Android 14+, type filters which media kinds the picker shows — e.g. pass RequestType.image to only let the user pick images. On iOS the system picker cannot be filtered by media type and type is ignored.

Use this to give the user a chance to reselect when an earlier PermissionState.limited grant does not contain the media kind your app actually needs: neither iOS nor Android exposes which types are in the current selection, so an image-only query against a videos-only limited grant will legitimately return zero results — re-prompting here is the recommended recovery path.

This method only supports from iOS 14.0, and will behave differently on iOS 14 and 15:

• iOS 14: Immediately complete the future call since there is no complete handler with the API on iOS 14.
• iOS 15: The Future will be completed after the modal was dismissed.

See the documents from Apple:

• iOS 14: https://developer.apple.com/documentation/photokit/phphotolibrary/3616113-presentlimitedlibrarypickerfromv/
• iOS 15: https://developer.apple.com/documentation/photokit/phphotolibrary/3752108-presentlimitedlibrarypickerfromv/

Implementation

static Future<void> presentLimited({
  RequestType type = RequestType.all,
}) =>
    plugin.presentLimited(type);