Storage

#include <obb.h>
#include <storage_manager.h>

Summary

Enumerations
`Anonymous Enum 111{ AOBB_STATE_MOUNTED = 1, AOBB_STATE_UNMOUNTED = 2, AOBB_STATE_ERROR_INTERNAL = 20, AOBB_STATE_ERROR_COULD_NOT_MOUNT = 21, AOBB_STATE_ERROR_COULD_NOT_UNMOUNT = 22, AOBB_STATE_ERROR_NOT_MOUNTED = 23, AOBB_STATE_ERROR_ALREADY_MOUNTED = 24, AOBB_STATE_ERROR_PERMISSION_DENIED = 25 }`	enum The different states of a OBB storage passed to AStorageManager_obbCallbackFunc().
`Anonymous Enum 61{ AOBBINFO_OVERLAY = 0x0001 }`	enum Flag for an obb file, returned by AObbInfo_getFlags().

Typedefs
`AObbInfo`	typedef `struct AObbInfo` AObbInfo is an opaque type representing information for obb storage.
`AStorageManager`	typedef `struct AStorageManager` AStorageManager manages application OBB storage, a pointer can be obtained with AStorageManager_new().
`AStorageManager_obbCallbackFunc)(const char filename, const int32_t state, void data)`	typedef `void(*` Callback function for asynchronous calls made on OBB files.

Functions
`AObbInfo_delete(AObbInfo *obbInfo)`	`void` Destroy the AObbInfo object.
`AObbInfo_getFlags(AObbInfo *obbInfo)`	`int32_t` Get the flags of an OBB file.
`AObbInfo_getPackageName(AObbInfo *obbInfo)`	`const char *` Get the package name for the OBB.
`AObbInfo_getVersion(AObbInfo *obbInfo)`	`int32_t` Get the version of an OBB file.
`AObbScanner_getObbInfo(const char *filename)`	`AObbInfo *` Scan an OBB and get information about it.
`AStorageManager_delete(AStorageManager *mgr)`	`void` Release AStorageManager instance.
`AStorageManager_getMountedObbPath(AStorageManager mgr, const char filename)`	`const char *` Get the mounted path for an OBB.
`AStorageManager_isObbMounted(AStorageManager mgr, const char filename)`	`int` Check whether an OBB is mounted.
`AStorageManager_mountObb(AStorageManager mgr, const char filename, const char key, AStorageManager_obbCallbackFunc cb, void data)`	`void` Attempts to mount an OBB file.
`AStorageManager_new()`	`AStorageManager *` Obtains a new instance of AStorageManager.
`AStorageManager_unmountObb(AStorageManager mgr, const char filename, const int force, AStorageManager_obbCallbackFunc cb, void *data)`	`void` Attempts to unmount an OBB file.

Enumerations

Anonymous Enum 111

 Anonymous Enum 111

The different states of a OBB storage passed to AStorageManager_obbCallbackFunc().

Properties
`AOBB_STATE_ERROR_ALREADY_MOUNTED`	The OBB has already been mounted. Can be returned as the status for callbacks made during asynchronous OBB actions.
`AOBB_STATE_ERROR_COULD_NOT_MOUNT`	The OBB could not be mounted by the system. Can be returned as the status for callbacks made during asynchronous OBB actions.
`AOBB_STATE_ERROR_COULD_NOT_UNMOUNT`	The OBB could not be unmounted. This most likely indicates that a file is in use on the OBB. Can be returned as the status for callbacks made during asynchronous OBB actions.
`AOBB_STATE_ERROR_INTERNAL`	There was an internal system error encountered while trying to mount the OBB. Can be returned as the status for callbacks made during asynchronous OBB actions.
`AOBB_STATE_ERROR_NOT_MOUNTED`	A call was made to unmount the OBB when it was not mounted. Can be returned as the status for callbacks made during asynchronous OBB actions.
`AOBB_STATE_ERROR_PERMISSION_DENIED`	The current application does not have permission to use this OBB. This could be because the OBB indicates it's owned by a different package. Can be returned as the status for callbacks made during asynchronous OBB actions.
`AOBB_STATE_MOUNTED`	The OBB container is now mounted and ready for use. Can be returned as the status for callbacks made during asynchronous OBB actions.
`AOBB_STATE_UNMOUNTED`	The OBB container is now unmounted and not usable. Can be returned as the status for callbacks made during asynchronous OBB actions.

Anonymous Enum 61

 Anonymous Enum 61

Flag for an obb file, returned by AObbInfo_getFlags().

Properties
`AOBBINFO_OVERLAY`	overlay

Typedefs

AObbInfo

struct AObbInfo AObbInfo

AObbInfo is an opaque type representing information for obb storage.

AStorageManager

struct AStorageManager AStorageManager

AStorageManager manages application OBB storage, a pointer can be obtained with AStorageManager_new().

AStorageManager_obbCallbackFunc

void(* AStorageManager_obbCallbackFunc)(const char *filename, const int32_t state, void *data)

Callback function for asynchronous calls made on OBB files.

"state" is one of the following constants:

Functions

AObbInfo_delete

void AObbInfo_delete(
  AObbInfo *obbInfo
)

Destroy the AObbInfo object.

You must call this when finished with the object.

AObbInfo_getFlags

int32_t AObbInfo_getFlags(
  AObbInfo *obbInfo
)

Get the flags of an OBB file.

AObbInfo_getPackageName

const char * AObbInfo_getPackageName(
  AObbInfo *obbInfo
)

Get the package name for the OBB.

AObbInfo_getVersion

int32_t AObbInfo_getVersion(
  AObbInfo *obbInfo
)

Get the version of an OBB file.

AObbScanner_getObbInfo

AObbInfo * AObbScanner_getObbInfo(
  const char *filename
)

Scan an OBB and get information about it.

AStorageManager_delete

void AStorageManager_delete(
  AStorageManager *mgr
)

Release AStorageManager instance.

AStorageManager_getMountedObbPath

const char * AStorageManager_getMountedObbPath(
  AStorageManager *mgr,
  const char *filename
)

Get the mounted path for an OBB.

AStorageManager_isObbMounted

int AStorageManager_isObbMounted(
  AStorageManager *mgr,
  const char *filename
)

Check whether an OBB is mounted.

AStorageManager_mountObb

void AStorageManager_mountObb(
  AStorageManager *mgr,
  const char *filename,
  const char *key,
  AStorageManager_obbCallbackFunc cb,
  void *data
)

Attempts to mount an OBB file.

This is an asynchronous operation.

Since API level 33, this function can only be used to mount unencrypted OBBs, i.e. the

key

parameter must be

null

or an empty string. Note that even before API level 33, mounting encrypted OBBs didn't work on many Android device implementations. Applications should not assume any particular behavior when

key

is nonempty.

AStorageManager_new

AStorageManager * AStorageManager_new()

Obtains a new instance of AStorageManager.

AStorageManager_unmountObb

void AStorageManager_unmountObb(
  AStorageManager *mgr,
  const char *filename,
  const int force,
  AStorageManager_obbCallbackFunc cb,
  void *data
)

Attempts to unmount an OBB file.

This is an asynchronous operation.