StorageManager.GetAllocatableBytes(UUID) Methode

Definition

Namespace:: Android.OS.Storage

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt die maximale Anzahl neuer Bytes zurück, die Ihre App für sich selbst auf dem angegebenen Speichervolume zuordnen kann.

[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

Parameter

storageUuid: UUID

die UUID des Speichervolumes, auf dem Sie speicherplatzverwenden, da der gesamte zwischenspeicherbare Speicherplatz je nach zugrunde liegendem Speichergerät stark variieren kann. Die UUID für einen bestimmten Pfad kann mithilfe von #getUuidForPath(File).

Gibt zurück

Int64

die maximale Anzahl neuer Byte, die die aufrufende App verwenden #allocateBytes(UUID, long) oder #allocateBytes(FileDescriptor, long)zuordnen kann.

Attribute: RegisterAttribute

Hinweise

Gibt die maximale Anzahl neuer Bytes zurück, die Ihre App für sich selbst auf dem angegebenen Speichervolume zuordnen kann. Dieser Wert ist in der Regel größer als File#getUsableSpace(), da das System möglicherweise bereit ist, zwischengespeicherte Dateien zu löschen, um eine Zuordnungsanforderung zu erfüllen. Anschließend können Sie platz für sich selbst #allocateBytes(UUID, long) zuordnen oder #allocateBytes(FileDescriptor, long).

Diese Methode wird am besten als Vorab-Flight-Überprüfung verwendet, z. B. die Entscheidung, ob genügend Platz zum Speichern eines gesamten Musikalbums vorhanden ist, bevor Sie Speicherplatz für jede Audiodatei im Album zuweisen. Versuche, Speicherplatz außerhalb des zurückgegebenen Werts zuzuweisen, schlagen fehl.

Wenn der zurückgegebene Wert für die Daten, die Sie beibehalten möchten, nicht groß genug ist, können Sie mit den #EXTRA_UUID Optionen starten #EXTRA_REQUESTED_BYTES#ACTION_MANAGE_STORAGE, um den Benutzer beim Freigeben von Speicherplatz zu unterstützen.

Wenn Sie nach und nach einen ungebundenen Speicherplatz (z. B. beim Aufzeichnen eines Videos) zuweisen, sollten Sie diese Methode nicht mehr als einmal alle 30 Sekunden aufrufen.

Hinweis: Wenn Ihre App das android:sharedUserId Manifestfeature verwendet, wird der gesamte Platz für alle Pakete in Ihrer freigegebenen UID als einzelne Einheit nachverfolgt.

Java Dokumentation für android.os.storage.StorageManager.getAllocatableBytes(java.util.UUID).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: