---
name: "al_android_get_jni_env"
section: "3alleg5"
platform: "linux"
package: "allegro5-doc"
version: "2:5.2.10.1+dfsg-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/al_android_get_jni_env/3alleg5"
---

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

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.