Selector de archivos multimedia para fotos y vídeos

La IMediaPicker interfaz tiene los métodos siguientes que devuelven un FileResult, que se puede usar para obtener la ubicación del archivo o leerlo.

• PickPhotoAsync
  abre el explorador de elementos multimedia para seleccionar una foto.

• CapturePhotoAsync
  abre la cámara para tomar una foto.

• PickVideoAsync
  abre el explorador de elementos multimedia para seleccionar un vídeo.

• CaptureVideoAsync
  abre la cámara para grabar un vídeo.

Cada método puede opcionalmente aceptar un parámetro MediaPickerOptions que permite establecer Title en algunos sistemas operativos y se muestra al usuario.

En .NET 10, el selector de medios agrega compatibilidad con selección múltiple y nuevas opciones de procesamiento. Use los métodos siguientes:

• PickPhotosAsync (devuelve List<FileResult>)
  Abre el explorador multimedia para seleccionar una o varias fotos.

• CapturePhotoAsync (devuelve FileResult?)
  abre la cámara para tomar una foto.

• PickVideosAsync (devuelve List<FileResult>)
  Abre el explorador multimedia para seleccionar uno o varios vídeos.

• CaptureVideoAsync (devuelve FileResult?)
  abre la cámara para grabar un vídeo.

El MediaPickerOptions parámetro expone campos adicionales, como SelectionLimit, , MaximumWidthMaximumHeight, CompressionQuality, RotateImagey PreserveMetaData.

Elegir varias fotos

var results = await MediaPicker.PickPhotosAsync(new MediaPickerOptions
{
  // Default is 1; set to 0 for no limit
  SelectionLimit = 10,
  // Optional processing for images
  MaximumWidth = 1024,
  MaximumHeight = 768,
  CompressionQuality = 85,
  RotateImage = true,
  PreserveMetaData = true,
});

foreach (var file in results)
{
  using var stream = await file.OpenReadAsync();
  // Process the stream
}

Selección de varios vídeos

var results = await MediaPicker.PickVideosAsync(new MediaPickerOptions
{
  SelectionLimit = 3,
  Title = "Select up to 3 videos",
});

foreach (var file in results)
{
  using var stream = await file.OpenReadAsync();
  // Process the stream
}

Guardar medios capturados en la galería

La MediaPickerOptions.SaveToGallery propiedad controla si también se guarda una foto o un vídeo capturados en la galería del dispositivo. El valor predeterminado es falsey la propiedad solo se aplica a CapturePhotoAsync las operaciones y CaptureVideoAsync . Las operaciones de selección de medios omiten.

FileResult? photo = await MediaPicker.Default.CapturePhotoAsync(
    new MediaPickerOptions
    {
        SaveToGallery = true
    });

El almacenamiento de medios capturados en la galería es compatible con Android, iOS y Mac Catalyst. En iOS y Mac Catalyst, la NSPhotoLibraryAddUsageDescription clave debe estar presente en Info.plist. En versiones de Android anteriores a la API 29, se requiere el WRITE_EXTERNAL_STORAGE permiso. La propiedad se omite en Windows y Tizen.

Recuperar operaciones interrumpidas del selector multimedia de Android

En Android, el sistema puede destruir y volver a crear tu aplicación mientras la interfaz de usuario de la cámara o del selector de fotos está en primer plano. Si la tarea original del selector de medios ha desaparecido cuando se reanuda la aplicación, use las API de recuperación solo para Android para recuperar los resultados aceptados.

La recuperación está disponible para las operaciones del selector de medios basadas en AndroidX: capturar foto, capturar vídeo, seleccionar una foto, seleccionar fotos, seleccionar un vídeo y seleccionar vídeos. Cada RecoveredMediaPickerResult tiene un Id, un Kind y una colección Files que contiene objetos FileResult recuperados. El RecoveredMediaPickerResultKind valor identifica la operación como CapturePhoto, , CaptureVideoPickPhoto, PickPhotos, o PickVideoPickVideos.

Dado que las API de recuperación son de solo Android, coloque el código de recuperación en un archivo específico de Android o guardándolo con #if ANDROID en código compartido.

using System.IO;
using Microsoft.Maui.Media;
using Microsoft.Maui.Storage;

#if ANDROID
async Task RecoverMediaPickerResultsAsync()
{
    var results = await MediaPicker.GetRecoveredMediaPickerResultsAsync();

    foreach (var result in results)
    {
        foreach (var file in result.Files)
        {
            var destination = Path.Combine(FileSystem.CacheDirectory, file.FileName);

            using var source = await file.OpenReadAsync();
            using var target = File.Create(destination);
            await source.CopyToAsync(target);
        }

        await MediaPicker.ClearRecoveredMediaPickerResultAsync(result.Id);
    }
}
#endif

Utilice MediaPicker.GetRecoveredMediaPickerResultsAsync para consultar los resultados ya recuperados y llame a MediaPicker.ClearRecoveredMediaPickerResultAsync después de que su aplicación procese cada resultado. Si su flujo de inicio o reanudación necesita esperar a que se complete la reconciliación de recuperación, llame a MediaPicker.WaitForRecoveredMediaPickerResultsAsync con un CancellationToken. Si, por el contrario, la aplicación debe abandonar una operación pendiente del selector de medios, llame a MediaPicker.DiscardPendingMediaPickerOperationAsync.