SDL_GetAndroidActivity - Man Page

Retrieve the Java instance of the Android activity class.

Header File

Defined in SDL3/SDL_system.h

Synopsis

#include "SDL3/SDL.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

·(3), SDL_GetAndroidJNIEnv(3)

Referenced By

SDL_GetAndroidJNIEnv(3).

SDL 3.2.2 Simple Directmedia Layer SDL3 FUNCTIONS