Language

StorageManager.GetAllocatableBytes(UUID) メソッド

定義

名前空間:
Android.OS.Storage
アセンブリ:
Mono.Android.dll

アプリが特定のストレージ ボリュームに自身に割り当てることができる新しいバイトの最大数を返します。

[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

パラメーター

storageUuid
UUID

割り当て可能な領域は基になるストレージ デバイスによって大きく異なる可能性があるため、ディスク領域の割り当てを検討しているストレージ ボリュームの UUID。 特定のパスの UUID は、 #getUuidForPath(File)を使用して取得できます。

返品

Int64

呼び出し元アプリが #allocateBytes(UUID, long) または #allocateBytes(FileDescriptor, long)を使用して割り当てることができる新しいバイトの最大数。

属性
RegisterAttribute

注釈

アプリが特定のストレージ ボリュームに自身に割り当てることができる新しいバイトの最大数を返します。 通常、この値は File#getUsableSpace()よりも大きくなります。システムは、割り当て要求を満たすためにキャッシュされたファイルを削除する可能性があるためです。 その後、 #allocateBytes(UUID, long) または #allocateBytes(FileDescriptor, long)を使用して、自分用の領域を割り当てることができます。

この方法は、アルバム内の各オーディオ ファイルにスペースを割り当てる前に、音楽アルバム全体を格納するのに十分なスペースがあるかどうかを判断するなど、フライト前のチェックとして最適です。 戻り値を超えてディスク領域を割り当てようとすると失敗します。

返された値が保持するデータに十分な大きさでない場合は、#EXTRA_UUIDオプションと#EXTRA_REQUESTED_BYTESオプションを使用して#ACTION_MANAGE_STORAGEを起動して、ユーザーがディスク領域を解放するのに役立ちます。

無制限のストレージ領域 (ビデオの録画時など) を段階的に割り当てる場合は、このメソッドを 30 秒ごとに複数回呼び出さないようにする必要があります。

注: アプリで android:sharedUserId マニフェスト機能を使用している場合、共有 UID 内のすべてのパッケージに割り当て可能な領域は、1 つのユニットとしてまとめて追跡されます。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象