Seletor de mídia para fotos e vídeos

A IMediaPicker interface tem os métodos a seguir que retornam um FileResult, que pode ser usado para obter o local do arquivo ou lê-lo.

• PickPhotoAsync
  Abre o navegador de mídia para selecionar uma foto.

• CapturePhotoAsync
  Abre a câmera para tirar uma foto.

• PickVideoAsync
  Abre o navegador de mídia para selecionar um vídeo.

• CaptureVideoAsync
  Abre a câmera para gravar um vídeo.

Cada método opcionalmente toma um parâmetro MediaPickerOptions que permite definir o Title em alguns sistemas operacionais, o qual é exibido para o usuário.

No .NET 10, o seletor de mídia adiciona suporte de várias seleções e novas opções de processamento. Use os seguintes métodos:

• PickPhotosAsync (retorna List<FileResult>)
  Abre o navegador de mídia para selecionar uma ou mais fotos.

• CapturePhotoAsync (retorna FileResult?)
  Abre a câmera para tirar uma foto.

• PickVideosAsync (retorna List<FileResult>)
  Abre o navegador de mídia para selecionar um ou mais vídeos.

• CaptureVideoAsync (retorna FileResult?)
  Abre a câmera para gravar um vídeo.

O MediaPickerOptions parâmetro expõe campos adicionais, como SelectionLimit, MaximumWidth, MaximumHeight, , CompressionQualitye RotateImagePreserveMetaData.

Escolher várias 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
}

Escolher vários 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
}

Salvar mídia capturada na galeria

A MediaPickerOptions.SaveToGallery propriedade controla se uma foto ou vídeo capturado também é salvo na galeria do dispositivo. O valor padrão é false, e a propriedade só se aplica a operações e operações CapturePhotoAsyncCaptureVideoAsync . Ela é ignorada por operações de seleção de mídia.

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

Há suporte para salvar mídia capturada na galeria no Android, iOS e Mac Catalyst. No iOS e no Mac Catalyst, a NSPhotoLibraryAddUsageDescription chave deve estar presente no Info.plist. Em versões do Android anteriores à API 29, a WRITE_EXTERNAL_STORAGE permissão é necessária. A propriedade é ignorada em Windows e Tizen.

Recuperar operações interrompidas do seletor de mídia no Android

No Android, o sistema pode destruir e recriar seu aplicativo enquanto a interface da câmera ou do seletor de fotos estiver em primeiro plano. Se a tarefa original do seletor de mídia não estiver mais disponível quando seu aplicativo for retomado, use as APIs de recuperação exclusivas do Android para recuperar os resultados já aceitos.

A recuperação está disponível para operações de seletor de mídia apoiadas pelo AndroidX: capturar foto, capturar vídeo, escolher uma foto, escolher fotos, escolher um vídeo e escolher vídeos. Cada RecoveredMediaPickerResult tem um Id, um Kind e uma coleção Files que contém objetos FileResult recuperados. O RecoveredMediaPickerResultKind valor identifica a operação como CapturePhoto, , CaptureVideo, PickPhoto, PickPhotos, PickVideoou PickVideos.

Como as APIs de recuperação são exclusivas do Android, coloque o código de recuperação em um arquivo específico para Android ou proteja-o com #if ANDROID no código compartilhado.

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

Use MediaPicker.GetRecoveredMediaPickerResultsAsync para consultar os resultados já recuperados e chame MediaPicker.ClearRecoveredMediaPickerResultAsync depois que seu aplicativo processar cada resultado. Se o fluxo de inicialização ou o fluxo de retomada precisar aguardar a conclusão da reconciliação de recuperação, chame MediaPicker.WaitForRecoveredMediaPickerResultsAsync com um CancellationToken. Se o aplicativo precisar abandonar uma operação pendente do seletor de mídia, chame MediaPicker.DiscardPendingMediaPickerOperationAsync.