Qué es Android Photo Picker y qué acceso concede
Android Photo Picker es una interfaz integrada que presenta la biblioteca multimedia para que una persona elija las fotos o los vídeos que quiere compartir con una aplicación. Android describe este mecanismo como una forma de conceder acceso a los archivos seleccionados en lugar de a toda la biblioteca. Puede servir, por ejemplo, para adjuntar una imagen a un mensaje o elegir un vídeo para una publicación.
La distinción clave es entre entregar elementos concretos y autorizar la lectura general de la biblioteca. El acceso concedido por el Photo Picker se refiere a los medios elegidos mediante el selector; no describe otros permisos que la aplicación pudiera tener por separado. Por eso, el flujo del selector no debe confundirse con una solicitud de acceso amplio al almacenamiento.
En los contratos de resultado de actividad documentados por Android, la aplicación recibe uno o varios URI asociados a los elementos elegidos. El acceso a esos archivos no debe tratarse como necesariamente permanente: Android indica que, de forma predeterminada, se mantiene hasta que se reinicia el dispositivo o la aplicación se detiene. Para una tarea prolongada, como subir un archivo en segundo plano, la aplicación puede conservar el acceso mediante takePersistableUriPermission(), cuando lo necesite.
Cómo se abre el selector desde una aplicación
Android documenta contratos de Jetpack Activity para iniciar el Photo Picker. PickVisualMedia permite elegir una foto o un vídeo; PickMultipleVisualMedia permite seleccionar varios. La recomendación de Android para simplificar esta integración es incluir la versión 1.7.0 o superior de la biblioteca androidx.activity; no implica que esa sea la única manera de usar el selector.
El flujo habitual con esos contratos es iniciar el selector, dejar que la persona elija contenido y procesar el resultado recibido. Si se cierra sin elegir un medio, los ejemplos de Android muestran que el resultado puede ser nulo en selección individual o una lista vacía en selección múltiple. La aplicación debería contemplar ambos casos y no asumir que siempre llegará un archivo.
Si el Photo Picker no está disponible en un dispositivo, la biblioteca invoca automáticamente la acción ACTION_OPEN_DOCUMENT como alternativa. Android indica que esta acción es compatible con dispositivos desde Android 4.4, nivel de API 19. La alternativa no garantiza una interfaz idéntica en todos los dispositivos: se trata de un flujo de selección de documentos distinto.
Photo Picker y Selected Photos Access: dos mecanismos distintos
Selected Photos Access es el modelo de acceso parcial de Android 14 para aplicaciones que solicitan permisos de lectura de fotos o vídeos. Permite que la persona autorice medios específicos en vez de todos los medios de un tipo. Según Android, este cambio se activa cuando la aplicación tiene como objetivo Android 14, nivel de API 34, o superior.
El Photo Picker es diferente: permite seleccionar contenido para compartir mediante su interfaz, sin que ese flujo requiera pedir permisos de almacenamiento. Android recomienda el selector como opción para aplicaciones que aún no lo usan y que necesitan seleccionar imágenes o vídeos. Por tanto, emplear el Photo Picker no significa que la aplicación esté implementando el modelo de permisos de una galería propia.
El permiso READ_MEDIA_VISUAL_USER_SELECTED es pertinente para aplicaciones que mantienen su propio selector de galería mediante permisos y necesitan gestionar el acceso parcial y la reselección. Android recomienda adaptar esa implementación cuando se requiere control sobre la galería. Si una aplicación mantiene un selector propio con permisos y no incorpora el nuevo permiso, el sistema puede ejecutarla en modo de compatibilidad; ese comportamiento corresponde a ese caso, no a cualquier aplicación que no use el Photo Picker.
Qué enfoque conviene según la función
La elección depende de la tarea. Para recibir una o varias imágenes o vídeos elegidos por la persona, el Photo Picker ofrece un flujo acotado. Una galería propia puede ser adecuada cuando la aplicación necesita controlar cómo presenta o consulta la biblioteca; a cambio, debe gestionar los permisos y reflejar los cambios en el acceso autorizado.
En los contratos de Jetpack Activity descritos por Android, el resultado incluye URI de los elementos seleccionados. En una galería propia con permisos, la aplicación puede consultar MediaStore dentro del alcance concedido. El acceso parcial no equivale al completo: la interfaz y los resultados deben corresponder a los permisos que la persona haya autorizado.
Comparación práctica
| Enfoque | Qué obtiene la aplicación | Qué debe gestionar |
|---|---|---|
| Photo Picker con contratos de Jetpack Activity | URI de los medios elegidos en ese flujo | Resultado vacío o nulo, procesamiento de los URI y duración del acceso |
| Galería propia con permisos | Consulta de medios dentro del alcance autorizado, que puede ser parcial o completo | Solicitud y comprobación de permisos, actualización de resultados y reselección |
La tabla resume la diferencia funcional, no todos los requisitos de implementación. Para decidir, conviene partir de lo que necesita la función: si basta con que el usuario entregue determinados archivos, el selector suele encajar; si hace falta una galería integrada en la aplicación, hay que diseñar también el manejo de permisos.
Contenido remoto y selección en el dispositivo
El Photo Picker puede permitir seleccionar fotos y vídeos almacenados de forma remota cuando hay proveedores de medios en la nube elegibles en el dispositivo. La disponibilidad depende del proveedor: Android no afirma que todos los servicios en la nube aparezcan en todos los selectores.
Android también indica que la herramienta se actualiza automáticamente y puede ofrecer funcionalidad ampliada sin cambios de código en la aplicación. Esto no asegura que cualquier proveedor o archivo remoto esté disponible en un dispositivo concreto. La persona puede abrir el selector y revisar qué contenido ofrece allí.
Qué conviene comprobar al compartir o desarrollar
Al elegir varios medios, la guía de ayuda de Android describe una vista previa de los elementos seleccionados y la posibilidad de quitar archivos antes de añadirlos. También advierte que el máximo seleccionable puede ser de hasta 100 fotos o vídeos, o menos según la configuración de la aplicación. La selección se puede revisar antes de completar el flujo descrito por esa guía.
Quien desarrolla una aplicación debería elegir entre selector y galería propia según la función, y manejar con cuidado los resultados del selector. Si una tarea en segundo plano necesita seguir accediendo a un URI, debe considerar la duración predeterminada del permiso y solicitar persistencia cuando corresponda. No conviene dar por hecho que el acceso a un elemento continuará indefinidamente.
Para una galería propia en Android 14, la aplicación debe comprobar el estado real de los permisos y permitir que la persona cambie los medios autorizados. Android advierte que el acceso parcial puede cambiar y recomienda actualizar los resultados cuando la aplicación vuelve a primer plano. La interfaz debe reflejar el acceso vigente, no una autorización supuesta o guardada de forma permanente.