Medienauswahlwerkzeug für Fotos und Videos

Die IMediaPicker Schnittstelle verfügt über die folgenden Methoden, die einen FileResultzurückgeben, der verwendet werden kann, um den Speicherort der Datei abzurufen oder zu lesen.

• PickPhotoAsync
  Öffnet den Medienbrowser, um ein Foto auszuwählen.

• CapturePhotoAsync
  Öffnet die Kamera, um ein Foto aufzunehmen.

• PickVideoAsync
  Öffnet den Medienbrowser, um ein Video auszuwählen.

• CaptureVideoAsync
  Öffnet die Kamera, um ein Video aufzunehmen.

Jede Methode verwendet optional einen MediaPickerOptions Parameter, der die Title Festlegung auf einigen Betriebssystemen ermöglicht, die dem Benutzer angezeigt wird.

In .NET 10 werden der Medienauswahlfunktion die Unterstützung für Mehrfachauswahl sowie neue Verarbeitungsoptionen hinzugefügt. Verwenden Sie die folgenden Methoden:

• PickPhotosAsync (gibt List<FileResult>zurück)
  Öffnet den Medienbrowser, um ein oder mehrere Fotos auszuwählen.

• CapturePhotoAsync (gibt FileResult?zurück)
  Öffnet die Kamera, um ein Foto aufzunehmen.

• PickVideosAsync (gibt List<FileResult>zurück)
  Öffnet den Medienbrowser, um ein oder mehrere Videos auszuwählen.

• CaptureVideoAsync (gibt FileResult?zurück)
  Öffnet die Kamera, um ein Video aufzunehmen.

Der MediaPickerOptions-Parameter macht zusätzliche Felder verfügbar, wie SelectionLimit, MaximumWidth, MaximumHeight, CompressionQuality, RotateImage und PreserveMetaData.

Auswählen mehrerer 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
}

Auswählen mehrerer Videos

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
}

Gespeicherte Medien im Katalog

Die MediaPickerOptions.SaveToGallery Eigenschaft steuert, ob ein aufgenommenes Foto oder Video auch im Katalog des Geräts gespeichert wird. Der Standardwert ist false, und die Eigenschaft gilt nur für CapturePhotoAsync und CaptureVideoAsync Vorgänge. Sie wird von Medienauswahlvorgängen ignoriert.

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

Das Speichern aufgenommener Medien im Katalog wird unter Android, iOS und Mac Catalyst unterstützt. Unter iOS und Mac Catalyst muss der NSPhotoLibraryAddUsageDescription Schlüssel in Info.plist vorhanden sein. In Android-Versionen vor API 29 ist die WRITE_EXTERNAL_STORAGE Berechtigung erforderlich. Die Eigenschaft wird für Windows und Tizen ignoriert.

Wiederherstellen unterbrochener Android-Medienauswahlvorgänge

Unter Android kann das System Ihre App zerstören und neu erstellen, während sich die Kamera- oder Fotoauswahl-UI im Vordergrund befindet. Wenn die ursprüngliche Medienauswahlaufgabe nicht mehr vorhanden ist, wenn Ihre App wieder aktiv wird, verwenden Sie die nur unter Android verfügbaren Wiederherstellungs-APIs, um bereits bestätigte Ergebnisse abzurufen.

Die Wiederherstellung ist für AndroidX-unterstützte Medienauswahlvorgänge verfügbar: Aufnehmen von Fotos, Aufnehmen von Videos, Auswählen eines Fotos, Auswählen von Fotos, Auswählen eines Videos und Auswählen von Videos. Jeder RecoveredMediaPickerResult verfügt über eine Id, eine Kindund eine Files Auflistung, die wiederhergestellte FileResult Objekte enthält. Der RecoveredMediaPickerResultKind Wert identifiziert den Vorgang als CapturePhoto, , CaptureVideo, PickPhoto, PickPhotos, oder PickVideoPickVideos.

Da die Wiederherstellungs-APIs nur für Android verfügbar sind, platzieren Sie den Wiederherstellungscode in einer Android-spezifischen Datei oder schützen Sie ihn im gemeinsam genutzten Code mit #if ANDROID.

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

Verwenden Sie MediaPicker.GetRecoveredMediaPickerResultsAsync, um bereits wiederhergestellte Ergebnisse abzufragen, und rufen Sie MediaPicker.ClearRecoveredMediaPickerResultAsync auf, nachdem Ihre App jedes Ergebnis verarbeitet hat. Wenn Ihr Start- oder Wiederaufnahmeablauf auf den Wiederherstellungsabgleich warten muss, rufen Sie MediaPicker.WaitForRecoveredMediaPickerResultsAsync mit einer CancellationToken auf. Wenn die App stattdessen einen ausstehenden Medienauswahlvorgang abbrechen soll, rufen Sie auf MediaPicker.DiscardPendingMediaPickerOperationAsync.