Context.GetExternalMediaDirs Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve rutas de acceso absolutas a directorios específicos de la aplicación en todos los dispositivos de almacenamiento compartidos o externos donde la aplicación puede colocar archivos multimedia.
[Android.Runtime.Register("getExternalMediaDirs", "()[Ljava/io/File;", "GetGetExternalMediaDirsHandler")]
public abstract Java.IO.File[]? GetExternalMediaDirs ();
[<Android.Runtime.Register("getExternalMediaDirs", "()[Ljava/io/File;", "GetGetExternalMediaDirsHandler")>]
abstract member GetExternalMediaDirs : unit -> Java.IO.File[]
Devoluciones
las rutas de acceso absolutas a directorios específicos de la aplicación. Algunas rutas de acceso individuales pueden ser null
si ese almacenamiento compartido no está disponible actualmente.
- Atributos
Comentarios
Devuelve rutas de acceso absolutas a directorios específicos de la aplicación en todos los dispositivos de almacenamiento compartidos o externos donde la aplicación puede colocar archivos multimedia. Estos archivos se examinan y se pone a disposición de otras aplicaciones a través de MediaStore
.
Esto es como #getExternalFilesDirs
en que estos archivos se eliminarán cuando se desinstale la aplicación, pero hay algunas diferencias importantes: <ul><li>Shared Storage puede no estar siempre disponible, ya que el usuario puede expulsar los medios extraíbles. El estado multimedia se puede comprobar mediante Environment#getExternalStorageState(File)
. <li>No hay ninguna seguridad aplicada con estos archivos. Por ejemplo, cualquier aplicación que contenga android.Manifest.permission#WRITE_EXTERNAL_STORAGE
puede escribir en estos archivos. </ul>
Los dispositivos de almacenamiento compartido que se devuelven aquí se consideran una parte estable del dispositivo, incluidas las ranuras de medios físicos bajo una cubierta protectora. Las rutas de acceso devueltas no incluyen dispositivos transitorios, como unidades flash USB conectadas a dispositivos portátiles.
Una aplicación puede almacenar datos en cualquiera o todos los dispositivos devueltos. Por ejemplo, una aplicación puede optar por almacenar archivos grandes en el dispositivo con el espacio más disponible, medido por StatFs
.
No se requieren permisos adicionales para que la aplicación que realiza la llamada lea o escriba archivos en la ruta de acceso devuelta. El acceso de escritura fuera de estas rutas de acceso en dispositivos de almacenamiento externos secundarios no está disponible.
Las rutas de acceso devueltas pueden cambiar con el tiempo si se insertan diferentes medios de almacenamiento compartido, por lo que solo se deben conservar las rutas de acceso relativas.
Este miembro está en desuso. Estos directorios siguen existiendo y se examinan, pero se recomienda a los desarrolladores migrar para insertar contenido en una MediaStore
colección directamente, ya que cualquier aplicación puede contribuir a nuevos medios sin MediaStore
necesidad de permisos, a partir android.os.Build.VERSION_CODES#Q
de .
Documentación de Java para android.content.Context.getExternalMediaDirs()
.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código y se usan según los términos descritos en la creative Commons 2.5.