Was ist Android Photo Picker und welchen Zugriff gewährt es?
Android Photo Picker ist eine integrierte Oberfläche, die eine Medienbibliothek anzeigt, damit eine Person die Fotos oder Videos auswählen kann, die sie mit einer App teilen möchte. Android beschreibt diesen Mechanismus als Möglichkeit, Zugriff auf ausgewählte Dateien statt auf die gesamte Bibliothek zu gewähren. So lässt sich beispielsweise ein Bild an eine Nachricht anhängen oder ein Video für einen Beitrag auswählen.
Entscheidend ist der Unterschied zwischen der Freigabe bestimmter Elemente und einer allgemeinen Leseberechtigung für die Bibliothek. Der über Photo Picker gewährte Zugriff bezieht sich auf die im Auswahlfenster ausgewählten Medien; andere Berechtigungen, über die die App möglicherweise separat verfügt, sind davon nicht erfasst. Der Auswahlvorgang ist daher nicht mit einer Anfrage nach umfassendem Speicherzugriff gleichzusetzen.
Bei den von Android dokumentierten Activity-Result-Verträgen erhält die App eine oder mehrere URIs, die den ausgewählten Elementen zugeordnet sind. Der Zugriff auf diese Dateien ist nicht zwangsläufig dauerhaft: Android zufolge besteht er standardmäßig bis zum Neustart des Geräts oder bis die App beendet wird. Für eine länger dauernde Aufgabe, etwa das Hochladen einer Datei im Hintergrund, kann die App den Zugriff bei Bedarf mit takePersistableUriPermission() dauerhaft sichern.
So öffnet eine App den Picker
Android dokumentiert Jetpack-Activity-Verträge zum Starten von Photo Picker. Mit PickVisualMedia lässt sich ein Foto oder Video auswählen; PickMultipleVisualMedia ermöglicht die Auswahl mehrerer Elemente. Android empfiehlt zur einfacheren Integration, Version 1.7.0 oder höher der Bibliothek androidx.activity einzubinden; das bedeutet nicht, dass dies die einzige Möglichkeit zur Nutzung des Pickers ist.
Der übliche Ablauf mit diesen Verträgen besteht darin, den Picker zu starten, die Person Inhalte auswählen zu lassen und anschließend das Ergebnis zu verarbeiten. Wird der Picker ohne Auswahl geschlossen, kann das Ergebnis laut den Android-Beispielen bei einer einzelnen Auswahl null oder bei mehreren Auswahlmöglichkeiten eine leere Liste sein. Die App sollte beide Fälle behandeln und nicht davon ausgehen, dass immer eine Datei zurückgegeben wird.
Ist Photo Picker auf einem Gerät nicht verfügbar, ruft die Bibliothek automatisch die Aktion ACTION_OPEN_DOCUMENT als Alternative auf. Android gibt an, dass diese Aktion mit Geräten ab Android 4.4, API-Level 19, kompatibel ist. Die Alternative garantiert nicht auf jedem Gerät dieselbe Oberfläche: Es handelt sich um einen anderen Ablauf zur Dokumentauswahl.
Photo Picker und Selected Photos Access: zwei verschiedene Mechanismen
Selected Photos Access ist das Modell für eingeschränkten Zugriff in Android 14 für Apps, die Leseberechtigungen für Fotos oder Videos anfordern. Damit kann eine Person bestimmte Medien statt aller Medien eines Typs freigeben. Laut Android greift diese Änderung, wenn eine App Android 14, API-Level 34, oder höher als Zielversion festlegt.
Photo Picker funktioniert anders: Über seine Oberfläche lassen sich Inhalte zum Teilen auswählen, ohne dass dieser Ablauf Speicherberechtigungen erfordert. Android empfiehlt den Picker für Apps, die ihn noch nicht einsetzen und Bilder oder Videos auswählen müssen. Die Nutzung von Photo Picker bedeutet daher nicht, dass eine App das Berechtigungsmodell einer eigenen Galerie implementiert.
Die Berechtigung READ_MEDIA_VISUAL_USER_SELECTED ist für Apps relevant, die eine eigene, berechtigungsbasierte Galerieauswahl bereitstellen und eingeschränkten Zugriff sowie eine erneute Auswahl verwalten müssen. Android empfiehlt, diese Implementierung anzupassen, wenn eine eigene Kontrolle über die Galerie erforderlich ist. Behält eine App ihre eigene Auswahl mit Berechtigungen bei, ohne die neue Berechtigung aufzunehmen, kann das System sie im Kompatibilitätsmodus ausführen. Dieses Verhalten betrifft diesen konkreten Fall, nicht jede App, die Photo Picker nicht verwendet.
Welcher Ansatz zur jeweiligen Funktion passt
Die passende Wahl hängt von der Aufgabe ab. Sollen eine oder mehrere von einer Person ausgewählte Bild- oder Videodateien entgegengenommen werden, bietet Photo Picker einen begrenzten Ablauf. Eine integrierte Galerie kann sinnvoll sein, wenn die App die Darstellung oder Abfrage der Bibliothek steuern muss; dafür muss sie Berechtigungen verwalten und Änderungen am gewährten Zugriff berücksichtigen.
Bei den von Android beschriebenen Jetpack-Activity-Verträgen umfasst das Ergebnis URIs der ausgewählten Elemente. In einer eigenen Galerie mit Berechtigungen kann die App MediaStore innerhalb des gewährten Umfangs abfragen. Eingeschränkter Zugriff ist kein Vollzugriff: Oberfläche und Ergebnisse müssen den Berechtigungen entsprechen, die die Person erteilt hat.
Praktischer Vergleich
| Ansatz | Was die App erhält | Was sie verwalten muss |
|---|---|---|
| Photo Picker mit Jetpack-Activity-Verträgen | URIs der in diesem Ablauf ausgewählten Medien | Leere oder null Ergebnisse, Verarbeitung der URIs und Zugriffsdauer |
| Eigene Galerie mit Berechtigungen | Abfrage von Medien innerhalb des gewährten Umfangs, der teilweise oder vollständig sein kann | Anfordern und Prüfen von Berechtigungen, Aktualisieren der Ergebnisse und erneute Auswahl |
Die Tabelle fasst den funktionalen Unterschied zusammen, nicht sämtliche Anforderungen an die Implementierung. Für die Entscheidung sollte der Bedarf der Funktion ausschlaggebend sein: Reicht es aus, dass Nutzer bestimmte Dateien bereitstellen, ist der Picker meist passend. Wird eine integrierte Galerie benötigt, muss auch der Umgang mit Berechtigungen geplant werden.
Remote-Inhalte und Auswahl auf dem Gerät
Photo Picker kann die Auswahl von Fotos und Videos ermöglichen, die remote gespeichert sind, sofern auf dem Gerät geeignete Cloud-Medienanbieter verfügbar sind. Die Verfügbarkeit hängt vom Anbieter ab: Android behauptet nicht, dass jeder Cloud-Dienst in jedem Picker angezeigt wird.
Android weist außerdem darauf hin, dass das Tool automatisch aktualisiert wird und zusätzliche Funktionen ohne Änderungen am App-Code bereitstellen kann. Das garantiert nicht, dass ein bestimmter Anbieter oder eine remote gespeicherte Datei auf einem konkreten Gerät verfügbar ist. Die Person kann den Picker öffnen und die dort angebotenen Inhalte prüfen.
Was beim Teilen oder Entwickeln zu beachten ist
Werden mehrere Medien ausgewählt, beschreibt der Android-Hilfetext eine Vorschau der ausgewählten Elemente und die Möglichkeit, Dateien vor dem Hinzufügen zu entfernen. Außerdem kann die Höchstzahl der auswählbaren Elemente bis zu 100 Fotos oder Videos betragen oder je nach Konfiguration der App darunter liegen. Die Auswahl lässt sich überprüfen, bevor der in der Anleitung beschriebene Ablauf abgeschlossen wird.
App-Entwickler sollten abhängig von der Funktion zwischen Picker und eigener Galerie wählen und die Ergebnisse des Pickers sorgfältig verarbeiten. Muss eine Hintergrundaufgabe weiterhin auf eine URI zugreifen, sind die standardmäßige Berechtigungsdauer und eine gegebenenfalls erforderliche dauerhafte Sicherung zu berücksichtigen. Es sollte nicht davon ausgegangen werden, dass der Zugriff auf ein Element unbegrenzt bestehen bleibt.
Bei einer eigenen Galerie unter Android 14 sollte die App den tatsächlichen Berechtigungsstatus prüfen und der Person ermöglichen, die freigegebenen Medien zu ändern. Android weist darauf hin, dass sich der eingeschränkte Zugriff ändern kann, und empfiehlt, die Ergebnisse zu aktualisieren, wenn die App wieder in den Vordergrund gelangt. Die Oberfläche muss den aktuellen Zugriff abbilden, nicht eine angenommene oder dauerhaft gespeicherte Berechtigung.