ContextWrapper.GetExternalMediaDirs Método

[Android.Runtime.Register("getExternalMediaDirs", "()[Ljava/io/File;", "GetGetExternalMediaDirsHandler")]
[System.Obsolete("deprecated")]
public override Java.IO.File[]? GetExternalMediaDirs();

[<Android.Runtime.Register("getExternalMediaDirs", "()[Ljava/io/File;", "GetGetExternalMediaDirsHandler")>]
[<System.Obsolete("deprecated")>]
override this.GetExternalMediaDirs : unit -> Java.IO.File[]

Retornos

Esse método é preterido. Esses diretórios ainda existem e são verificados, mas os desenvolvedores são incentivados a migrar para inserir conteúdo diretamente em uma coleção MediaStore, pois qualquer aplicativo pode contribuir com novas mídias para a MediaStore sem permissões necessárias, começando em Build.VERSION_CODES. Q . Retorna caminhos absolutos para diretórios específicos do aplicativo em todos os dispositivos de armazenamento compartilhados/externos em que o aplicativo pode colocar arquivos de mídia. Esses arquivos são verificados e disponibilizados para outros aplicativos por meio do MediaStore. Isso é como getExternalFilesDirs(String) em que esses arquivos serão excluídos quando o aplicativo for desinstalado, no entanto, há algumas diferenças importantes: o armazenamento compartilhado pode nem sempre estar disponível, já que a mídia removível pode ser ejetada pelo usuário. O estado da mídia pode ser verificado usando Environment.getExternalStorageState(File) . Não há nenhuma segurança imposta com esses arquivos. Por exemplo, qualquer aplicativo que contém Manifest.permission.WRITE_EXTERNAL_STORAGE pode gravar nesses arquivos. Os dispositivos de armazenamento compartilhado retornados aqui são considerados uma parte estável do dispositivo, incluindo slots de mídia física sob uma cobertura protetora. Os caminhos retornados não incluem dispositivos transitórios, como unidades flash USB conectadas a dispositivos portáteis. Um aplicativo pode armazenar dados em qualquer um ou em todos os dispositivos retornados. Por exemplo, um aplicativo pode optar por armazenar arquivos grandes no dispositivo com o espaço mais disponível, conforme medido por StatFs. Nenhuma permissão adicional é necessária para que o aplicativo de chamada leia ou escreva arquivos no caminho retornado. O acesso de gravação fora desses caminhos em dispositivos de armazenamento externos secundários não está disponível. Os caminhos retornados poderão ser alterados ao longo do tempo se diferentes mídias de armazenamento compartilhadas forem inseridas, portanto, somente os caminhos relativos devem ser persistidos. Retorna Arquivo[] os caminhos absolutos para diretórios específicos do aplicativo. Alguns caminhos individuais poderão ser nulos se esse armazenamento compartilhado não estiver disponível no momento.

Atributos

RegisterAttribute ObsoleteAttribute

Comentários

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Java documentação para android.content.ContextWrapper.getExternalMediaDirs().