---
name: "al_android_get_jni_env"
section: "3"
platform: "linux"
package: "allegro"
version: "5.2.11.3-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/al_android_get_jni_env"
---

# al\_android\_get\_jni\_env(3)

Allegro 5 API

## NAME

al\_android\_get\_jni\_env - Allegro 5 API

## SYNOPSIS

-

  ```
  #include <allegro5/allegro_android.h>
  JNIEnv *al_android_get_jni_env(void)
  ```

## DESCRIPTION

Returns the Android JNI environment used by Allegro to call into Java. As a convenience this function provides it to the user so there is no need to obtain it yourself.

For example if you have a Java method “void send(String message)” in your activity class, you could call it like this from C code:

-

  ```
  JNIEnv * env = al_android_get_jni_env();
  jclass class_id = (* env)->GetObjectClass(env, al_android_get_activity());
  jmethodID method_id = (* env)->GetMethodID(env, class_id, "send",
      "(Ljava/lang/String;)V");
  jstring jdata = (* env)->NewStringUTF(env, "Hello Java!");
  (* env)->CallVoidMethod(env, al_android_get_activity(), method_id, jdata);
  (* env)->DeleteLocalRef(env, jdata);
  ```

## SINCE

5\.2.2

*\[Unstable API\]:* This API is new and subject to refinement.