ActivityResultContracts.PickMultipleVisualMedia

public class ActivityResultContracts.PickMultipleVisualMedia extends ActivityResultContract

An ActivityResultContract to use the Photo Picker to select multiple images, videos, or other types of visual media.

This contract always prefers the system framework provided Photo Picker available via MediaStore.ACTION_PICK_IMAGES when it is available, but will also provide a fallback on devices that it is not available to provide a consistent API surface across all Android API 19 or higher devices.

The priority order for handling the Photo Picker is:

1. The system framework provided MediaStore.ACTION_PICK_IMAGES.

• An OEM can provide a system app that implements PickVisualMedia.ACTION_SYSTEM_FALLBACK_PICK_IMAGES to provide a consistent Photo Picker to older devices. These system apps may handle the PickVisualMedia.EXTRA_SYSTEM_FALLBACK_PICK_IMAGES_MAX extra to respect the maxItems passed to this contract.

• Intent.ACTION_OPEN_DOCUMENT is used as a final fallback on all Android API 19 or higher devices. This Intent does not allow limiting the max items the user selects.

The constructor accepts one parameter maxItems to limit the number of selectable items when using the photo picker to return. When launching the activity, the minimum of maxItems and input PickVisualMediaRequest.maxItems is set as the limit.

The input is a PickVisualMediaRequest.

The output is a list Uri of the selected media. It can be empty if the user hasn't selected any items. Keep in mind that Uri returned by the photo picker aren't writable.

This can be extended to override createIntent if you wish to pass additional extras to the Intent created by super.createIntent().

Summary

public PickMultipleVisualMedia(int maxItems)

@CallSuper
public @NonNull Intent createIntent(
    @NonNull Context context,
    @NonNull PickVisualMediaRequest input
)

public final ActivityResultContract.SynchronousResult<@NonNull List<@NonNull Uri>> getSynchronousResult(
    @NonNull Context context,
    @NonNull PickVisualMediaRequest input
)

public final @NonNull List<@NonNull Uri> parseResult(int resultCode, Intent intent)