StorageManager.GetAllocatableBytes(UUID) Método

Definição

Namespace:: Android.OS.Storage

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Retorne o número máximo de novos bytes que seu aplicativo pode alocar para si mesmo no volume de armazenamento especificado.

[Android.Runtime.Register("getAllocatableBytes", "(Ljava/util/UUID;)J", "GetGetAllocatableBytes_Ljava_util_UUID_Handler", ApiSince=26)]
public virtual long GetAllocatableBytes(Java.Util.UUID storageUuid);

[<Android.Runtime.Register("getAllocatableBytes", "(Ljava/util/UUID;)J", "GetGetAllocatableBytes_Ljava_util_UUID_Handler", ApiSince=26)>]
abstract member GetAllocatableBytes : Java.Util.UUID -> int64
override this.GetAllocatableBytes : Java.Util.UUID -> int64

Parâmetros

storageUuid: UUID

a UUID do volume de armazenamento em que você está considerando alocar espaço em disco, uma vez que o espaço alocável pode variar muito dependendo do dispositivo de armazenamento subjacente. A UUID para um caminho específico pode ser obtida usando #getUuidForPath(File).

Retornos

Int64

o número máximo de novos bytes que o aplicativo de chamada pode alocar usando #allocateBytes(UUID, long) ou #allocateBytes(FileDescriptor, long).

Atributos: RegisterAttribute

Comentários

Retorne o número máximo de novos bytes que seu aplicativo pode alocar para si mesmo no volume de armazenamento especificado. Esse valor normalmente é maior do que, já que File#getUsableSpace()o sistema pode estar disposto a excluir arquivos armazenados em cache para atender a uma solicitação de alocação. Em seguida, você pode alocar espaço para si mesmo usando #allocateBytes(UUID, long) ou #allocateBytes(FileDescriptor, long).

Esse método é melhor usado como uma verificação pré-voo, como decidir se há espaço suficiente para armazenar um álbum de música inteiro antes de alocar espaço para cada arquivo de áudio no álbum. As tentativas de alocar espaço em disco além do valor retornado falharão.

Se o valor retornado não for grande o suficiente para os dados que você gostaria de manter, você poderá iniciar #ACTION_MANAGE_STORAGE com as #EXTRA_UUID opções e #EXTRA_REQUESTED_BYTES as opções para ajudar a envolver o usuário na liberação de espaço em disco.

Se você estiver alocando progressivamente uma quantidade não associado de espaço de armazenamento (como ao gravar um vídeo), evite chamar esse método mais de uma vez a cada 30 segundos.

Observação: se o aplicativo usa o android:sharedUserId recurso de manifesto, o espaço alocável para todos os pacotes em sua UID compartilhada é acompanhado em conjunto como uma única unidade.

Java documentação para android.os.storage.StorageManager.getAllocatableBytes(java.util.UUID).

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.

Aplica-se a