Partager via


Context.GetObbDirs Method

Definition

Returns absolute paths to application-specific directories on all shared/external storage devices where the application's OBB files (if there are any) can be found.

[Android.Runtime.Register("getObbDirs", "()[Ljava/io/File;", "GetGetObbDirsHandler")]
public abstract Java.IO.File[]? GetObbDirs ();
[<Android.Runtime.Register("getObbDirs", "()[Ljava/io/File;", "GetGetObbDirsHandler")>]
abstract member GetObbDirs : unit -> Java.IO.File[]

Returns

File[]

the absolute paths to application-specific directories. Some individual paths may be null if that shared storage is not currently available. The first path returned is the same as #getObbDir()

Attributes

Remarks

Returns absolute paths to application-specific directories on all shared/external storage devices where the application's OBB files (if there are any) can be found. Note if the application does not have any OBB files, these directories may not exist.

This is like #getFilesDir() in that these files will be deleted when the application is uninstalled, however there are some important differences: <ul> <li>Shared storage may not always be available, since removable media can be ejected by the user. Media state can be checked using Environment#getExternalStorageState(File). <li>There is no security enforced with these files. For example, any application holding android.Manifest.permission#WRITE_EXTERNAL_STORAGE can write to these files. </ul>

Shared storage devices returned here are considered a stable part of the device, including physical media slots under a protective cover. The returned paths do not include transient devices, such as USB flash drives connected to handheld devices.

An application may store data on any or all of the returned devices. For example, an app may choose to store large files on the device with the most available space, as measured by StatFs.

No additional permissions are required for the calling app to read or write files under the returned path. Write access outside of these paths on secondary external storage devices is not available.

Java documentation for android.content.Context.getObbDirs().

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to

See also