android_app

#include <android_native_app_glue.h>

This is the interface for the standard glue code of a threaded application.

Summary

In this model, the application's code is running in its own thread separate from the main thread of the process. It is not required that this thread be associated with the Java VM, although it will need to be in order to make JNI calls any Java objects.

Public attributes
`activity`	`GameActivity *` The GameActivity object instance that this app is running in.
`activityState`	`int` Current state of the app's activity.
`config`	`AConfiguration *` The current configuration the app is running in.
`contentRect`	`ARect` Current content rectangle of the window; this is the area where the window's content should be placed to be seen by the user.
`destroyRequested`	`int` This is non-zero when the application's GameActivity is being destroyed and waiting for the app thread to complete.
`keyDownEvents[NATIVE_APP_GLUE_MAX_NUM_KEY_EVENTS]`	`GameActivityKeyEvent` Pointer to a read-only array of pointers GameActivityKeyEvent.
`keyDownEventsCount`	`uint64_t` The number of valid "Key Down" events in `keyDownEvents`.
`keyUpEvents[NATIVE_APP_GLUE_MAX_NUM_KEY_EVENTS]`	`GameActivityKeyEvent` Pointer to a read-only array of pointers to GameActivityKeyEvent.
`keyUpEventsCount`	`uint64_t` The number of valid "Key Up" events in `keyUpEvents`.
`looper`	`ALooper *` The ALooper associated with the app's thread.
`motionEvents[NATIVE_APP_GLUE_MAX_NUM_MOTION_EVENTS]`	`GameActivityMotionEvent` Pointer to a read-only array of pointers to GameActivityMotionEvent.
`motionEventsCount`	`uint64_t` The number of valid motion events in `motionEvents`.
`onAppCmd)(struct android_app *app, int32_t cmd)`	`void(` A required callback for processing main app commands (`APP_CMD_`).
`savedState`	`void *` The last activity saved state, as provided at creation time.
`savedStateSize`	`size_t` The size of the activity saved state.
`textInputState`	`int` 0 if no text input event is outstanding, 1 if it is.
`userData`	`void *` An optional pointer to application-defined state.
`window`	`ANativeWindow *` When non-NULL, this is the window surface that the app can draw in.

Public attributes

activity

GameActivity * android_app::activity

The GameActivity object instance that this app is running in.

activityState

int android_app::activityState

Current state of the app's activity.

May be either APP_CMD_START, APP_CMD_RESUME, APP_CMD_PAUSE, or APP_CMD_STOP.

config

AConfiguration * android_app::config

The current configuration the app is running in.

contentRect

ARect android_app::contentRect

Current content rectangle of the window; this is the area where the window's content should be placed to be seen by the user.

destroyRequested

int android_app::destroyRequested

This is non-zero when the application's GameActivity is being destroyed and waiting for the app thread to complete.

keyDownEvents

GameActivityKeyEvent android_app::keyDownEvents[NATIVE_APP_GLUE_MAX_NUM_KEY_EVENTS]

Pointer to a read-only array of pointers GameActivityKeyEvent.

Only the first keyDownEventsCount events are valid.

keyDownEventsCount

uint64_t android_app::keyDownEventsCount

The number of valid "Key Down" events in keyDownEvents.

keyUpEvents

GameActivityKeyEvent android_app::keyUpEvents[NATIVE_APP_GLUE_MAX_NUM_KEY_EVENTS]

Pointer to a read-only array of pointers to GameActivityKeyEvent.

Only the first keyUpEventsCount events are valid.

keyUpEventsCount

uint64_t android_app::keyUpEventsCount

The number of valid "Key Up" events in keyUpEvents.

looper

ALooper * android_app::looper

The ALooper associated with the app's thread.

motionEvents

GameActivityMotionEvent android_app::motionEvents[NATIVE_APP_GLUE_MAX_NUM_MOTION_EVENTS]

Pointer to a read-only array of pointers to GameActivityMotionEvent.

Only the first motionEventsCount events are valid.

motionEventsCount

uint64_t android_app::motionEventsCount

The number of valid motion events in motionEvents.

onAppCmd

void(* android_app::onAppCmd)(struct android_app *app, int32_t cmd)

A required callback for processing main app commands (APP_CMD_*).

This is called each frame if there are app commands that need processing.

savedState

void * android_app::savedState

The last activity saved state, as provided at creation time.

It is NULL if there was no state. You can use this as you need; the memory will remain around until you call android_app_exec_cmd() for APP_CMD_RESUME, at which point it will be freed and savedState set to NULL. These variables should only be changed when processing a APP_CMD_SAVE_STATE, at which point they will be initialized to NULL and you can malloc your state and place the information here. In that case the memory will be freed for you later.

savedStateSize

size_t android_app::savedStateSize

The size of the activity saved state.

It is 0 if savedState is NULL.

textInputState

int android_app::textInputState

0 if no text input event is outstanding, 1 if it is.

Use GameActivity_getTextInputState to get information about the text entered by the user.

userData

void * android_app::userData

An optional pointer to application-defined state.

window

ANativeWindow * android_app::window

When non-NULL, this is the window surface that the app can draw in.