Selezione multimediale per foto e video

L'interfaccia IMediaPicker include i metodi seguenti che restituiscono un FileResultoggetto , che può essere usato per ottenere il percorso del file o leggerlo.

• PickPhotoAsync
  Apre il browser multimediale per selezionare una foto.

• CapturePhotoAsync
  Apre la fotocamera per scattare una foto.

• PickVideoAsync
  Apre il browser multimediale per selezionare un video.

• CaptureVideoAsync
  Apre la fotocamera per scattare un video.

Ogni metodo accetta facoltativamente un parametro MediaPickerOptions che consente di impostare il Title per alcuni sistemi operativi, e che viene mostrato all'utente.

In .NET 10, il selettore multimediale aggiunge il supporto per la selezione multipla e nuove opzioni di elaborazione. Usare i metodi seguenti:

• PickPhotosAsync (restituisce List<FileResult>)
  Apre il browser multimediale per selezionare una o più foto.

• CapturePhotoAsync (restituisce FileResult?)
  Apre la fotocamera per scattare una foto.

• PickVideosAsync (restituisce List<FileResult>)
  Apre il browser multimediale per selezionare uno o più video.

• CaptureVideoAsync (restituisce FileResult?)
  Apre la fotocamera per scattare un video.

Il MediaPickerOptions parametro espone campi aggiuntivi, ad esempio, SelectionLimit, MaximumWidth, MaximumHeight, CompressionQuality, RotateImage e PreserveMetaData.

Selezionare più foto

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
}

Selezionare più video

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
}

Salvare i supporti acquisiti nella raccolta

La MediaPickerOptions.SaveToGallery proprietà controlla se anche una foto o un video acquisito viene salvato nella raccolta del dispositivo. Il valore predefinito è falsee la proprietà si applica solo alle CapturePhotoAsync operazioni e CaptureVideoAsync . Viene ignorato dalle operazioni di selezione multimediale.

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

Il salvataggio di supporti acquisiti nella raccolta è supportato in Android, iOS e Mac Catalyst. In iOS e Mac Catalyst, la NSPhotoLibraryAddUsageDescription chiave deve essere presente in Info.plist. Nelle versioni di Android precedenti all'API 29, l'autorizzazione WRITE_EXTERNAL_STORAGE è necessaria. La proprietà viene ignorata in Windows e Tizen.

Ripristinare le operazioni di selezione multimediale Android interrotte

In Android, il sistema può distruggere e ricreare l'app mentre l'interfaccia utente della fotocamera o della selezione foto si trova davanti. Se l'attività di selezione multimediale originale non è più disponibile quando l'app viene ripresa, usare le API di ripristino solo Android per recuperare i risultati accettati.

Il recupero è disponibile per le operazioni di selezione multimediale supportate da AndroidX: acquisizione di foto, acquisizione di video, selezione di una foto, selezione di foto, selezione di un video e selezione video. Ogni RecoveredMediaPickerResult ha un Id, un Kind e una raccolta Files contenente oggetti FileResult recuperati. Il RecoveredMediaPickerResultKind valore identifica l'operazione come CapturePhoto, CaptureVideoPickPhoto, PickPhotos, PickVideo, o PickVideos.

Poiché le API di ripristino sono solo Android, inserire il codice di ripristino in un file specifico di Android o sorvegliarlo con #if ANDROID nel codice condiviso.

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

Usare MediaPicker.GetRecoveredMediaPickerResultsAsync per eseguire query sui risultati già recuperati e chiamare MediaPicker.ClearRecoveredMediaPickerResultAsync dopo che l'app gestisce ogni risultato. Se il flusso di avvio o di ripresa deve attendere la riconciliazione del ripristino, chiamare MediaPicker.WaitForRecoveredMediaPickerResultsAsync con un CancellationToken. Se l'app deve abbandonare invece un'operazione di selezione multimediale in sospeso, chiamare MediaPicker.DiscardPendingMediaPickerOperationAsync.