Compartir a través de


StorageVolume.CreateAccessIntent(String) Método

Definición

Crea una intención para conceder acceso a un directorio de almacenamiento estándar o a todo el volumen después de obtener la aprobación del usuario.

[Android.Runtime.Register("createAccessIntent", "(Ljava/lang/String;)Landroid/content/Intent;", "", ApiSince=24)]
public Android.Content.Intent? CreateAccessIntent(string? directoryName);
[<Android.Runtime.Register("createAccessIntent", "(Ljava/lang/String;)Landroid/content/Intent;", "", ApiSince=24)>]
member this.CreateAccessIntent : string -> Android.Content.Intent

Parámetros

directoryName
String

debe ser uno de Environment#DIRECTORY_MUSIC, Environment#DIRECTORY_PODCASTS, Environment#DIRECTORY_RINGTONES, Environment#DIRECTORY_ALARMS, Environment#DIRECTORY_NOTIFICATIONSEnvironment#DIRECTORY_MOVIESEnvironment#DIRECTORY_DOWNLOADSEnvironment#DIRECTORY_PICTURES, Environment#DIRECTORY_DCIM, o Environment#DIRECTORY_DOCUMENTS, o null para solicitar acceso a todo el volumen.

Devoluciones

intención de solicitar acceso o null si el directorio solicitado no es válido para ese volumen.

Atributos

Comentarios

Crea una intención para conceder acceso a un directorio de almacenamiento estándar o a todo el volumen después de obtener la aprobación del usuario.

Cuando se invoca, el sistema pedirá al usuario que conceda acceso al directorio solicitado (y sus descendientes). El resultado de la solicitud se devolverá a la actividad a través del onActivityResult método .

Para obtener acceso a los documentos descendientes (secundarios, nietos, etc.), use DocumentsContract#buildDocumentUriUsingTree(Uri, String)o DocumentsContract#buildChildDocumentsUriUsingTree(Uri, String) con el URI devuelto.

Si la aplicación solo necesita almacenar datos internos, considere la posibilidad de usar Context#getExternalFilesDirs(String) Context.getExternalFilesDirs, Context#getExternalCacheDirs()o Context#getExternalMediaDirs(), que no requieren permisos para leer o escribir.

El acceso a todo el volumen solo está disponible para volúmenes que no son principales (para el volumen principal, las aplicaciones pueden usar los android.Manifest.permission#READ_EXTERNAL_STORAGE permisos y android.Manifest.permission#WRITE_EXTERNAL_STORAGE ) y debe usarse con precaución, ya que es más probable que los usuarios denieguen el acceso cuando se le solicite acceso de volumen completo en lugar de directorios específicos.

Este miembro está en desuso. Los autores de llamadas deben migrar al uso Intent#ACTION_OPEN_DOCUMENT_TREE en su lugar. Iniciarlo Intent en dispositivos que se ejecutan android.os.Build.VERSION_CODES#Q o superior, finalizará inmediatamente con un código de resultado de android.app.Activity#RESULT_CANCELED.

Documentación de Java para android.os.storage.StorageVolume.createAccessIntent(java.lang.String).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.

Se aplica a