al_android_get_jni_env(3)

🌸 NAME 🌸

al_android_get_jni_env — Allegro 5 API, bestie 💖

(Also hi, this is al_android_get_jni_env(3) from the Library Functions Manual — folding that header tea right here so you have the full vibe check. 🫶)

---

✨ SYNOPSIS ✨

#include <allegro5/allegro_android.h>

JNIEnv *al_android_get_jni_env(void)

---

🦋 DESCRIPTION 🦋

Okay so this one is literally giving “let me hand you the keys.” It returns the Android JNI environment that Allegro uses to call into Java. As a convenience, this function provides it to you, the user, so there is no need to obtain it yourself. Slay. 💅

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);

That’s the whole example, no cap. ✨

---

🎀 SINCE 🎀

5.2.2, bestie — that’s when this icon showed up. 🦋

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

---

— xoxo, your Allegro reference manual girl 💅 · source/version: Allegro reference manual · page: <code>al_android_get_jni_env(3)</code> · date: not printed on this page, bestie 🫶