Seletor de mídia para fotos e vídeos

A IMediaPicker interface tem os seguintes métodos que retornam um FileResult, que pode ser usado para obter a localização 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âmara para gravar um vídeo.

Cada método pode opcionalmente usar um MediaPickerOptions parâmetro que permite definir o Title em alguns sistemas operacionais, que é exibido ao utilizador.

No .NET 10, o seletor de mídia adiciona suporte a seleção múltipla 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âmara para gravar um vídeo.

O MediaPickerOptions parâmetro expõe campos adicionais, como SelectionLimit, MaximumWidth, MaximumHeight, CompressionQuality, RotateImagee PreserveMetaData.

Escolha 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
}

Escolha 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
}

Guardar os conteúdos capturados na galeria

A MediaPickerOptions.SaveToGallery propriedade controla se uma fotografia ou vídeo capturado também é guardado na galeria do dispositivo. O valor padrão é false, e a propriedade aplica-se apenas às CapturePhotoAsync operações e CaptureVideoAsync . É ignorado pelas operações de seleção dos media.

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

A gravação de conteúdos capturados na galeria é suportada em Android, iOS e Mac Catalyst. No Catalyst para iOS e Mac, a NSPhotoLibraryAddUsageDescription chave deve estar presente no Info.plist. Nas versões Android anteriores à API 29, a WRITE_EXTERNAL_STORAGE permissão é necessária. A propriedade é ignorada no Windows e no Tizen.

Recuperar operações interruptas do seletor de media Android

No Android, o sistema pode destruir e recriar a sua aplicação enquanto a câmara ou a interface do seletor de fotos estão à frente. Se a tarefa original do seletor de media desaparecer quando a sua aplicação recomeçou, use as APIs de recuperação exclusivas do Android para recuperar quaisquer resultados aceites.

A recuperação está disponível para operações de seleção de media apoiadas pelo AndroidX: capturar fotografia, capturar vídeo, escolher uma foto, escolher fotos, escolher um vídeo e selecionar 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, PickVideo, ou PickVideos.

Como as APIs de recuperação são apenas para Android, coloque o código de recuperação num ficheiro específico para Android ou guarde-o em #if ANDROID código partilhado.

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

Utilize MediaPicker.GetRecoveredMediaPickerResultsAsync para consultar os resultados já recuperados e chame MediaPicker.ClearRecoveredMediaPickerResultAsync depois de a sua aplicação tratar cada resultado. Se o seu fluxo de inicialização ou retoma precisar de esperar pela reconciliação de recuperação, chame MediaPicker.WaitForRecoveredMediaPickerResultsAsync com um CancellationToken. Se, em vez disso, a aplicação tiver de abandonar uma operação pendente do seletor de multimédia, chame MediaPicker.DiscardPendingMediaPickerOperationAsync.