NAME

SDL_GetAndroidActivity - Retrieve the Java instance of the Android activity class.

SYNOPSIS

#include <SDL3/SDL_system.h>

void * SDL_GetAndroidActivity(void);

DESCRIPTION

The prototype of the function in SDL's code actually declares a void* return type, even if the implementation returns a jobject. The rationale being that the SDL headers can avoid including jni.h.

The jobject returned by the function is a local reference and must be released by the caller. See the PushLocalFrame() and PopLocalFrame() or DeleteLocalRef() functions of the Java native interface:

https://docs.oracle.com/javase/1.5.0/docs/guide/jni/spec/functions.html

RETURN VALUE

Returns the jobject representing the instance of the Activity class of the Android application, or NULL on failure; call SDL_GetError() for more information.

THREAD SAFETY

It is safe to call this function from any thread.

AVAILABILITY

This function is available since SDL 3.2.0.

SEE ALSO

SDL_GetAndroidJNIEnv(3)