目次 - API(機能別) - 環境固有の機能 - SDL_AndroidGetActivity

SDL_AndroidGetActivity

AndroidアプリケーションでアクティビティクラスのJavaインスタンスを得る

構文

void* SDL_AndroidGetActivity()

戻り値

jobject型のAndroidアプリケーションのアクティビティクラスのインスタンスを戻す. 失敗のときNULLを戻す.

サンプルコード

#include "SDL.h"
#include <jni.h>

// このサンプルはC++と "void showHome()" という名前のJavaカスタムメソッドが必要である

// Javaのアクティビティのインスタンスの void MyActivity.showHome() メソッドを呼ぶ
void showHome(void)
{
    // JNI環境を得る
    JNIEnv* env = (JNIEnv*)SDL_AndroidGetJNIEnv();

    // SDLActivityのJavaインスタンスを得る
    jobject activity = (jobject)SDL_AndroidGetActivity();

    // アクティビティのJavaクラスを検索する. SDLActivityかそのサブクラスである必要がある
    jclass clazz(env->GetObjectClass(activity));

    // メソッドのIDを得る
    jmethodID method_id = env->GetMethodID(clazz, "showHome", "()V");

    // Javaメソッドを実際に呼ぶ
    env->CallVoidMethod(activity, method_id);

    // ローカル参照を解放する
    env->DeleteLocalRef(activity);
    env->DeleteLocalRef(clazz);

    // 注意(とAndroid用SDLの実装の詳細に関する記述):
    // もしJava側が呼んだネイティブ関数から戻ると, ローカル参照は自動的に削除
    // される. SDLではmain()それ自身がネイティブ関数である. したがって, 参照
    // は手動で削除しなければならない. そうしないとmain()から戻って(アプリケー
    // ションが終了して)始めて参照が削除されるからである.
}

詳細

この関数はjobject型を戻すが, 戻り値の関数プロトタイプはvoid*で定義されている. SDLのヘッダにはjni.hがインクルードされていないためである.

この関数が戻したjobjectはローカルリファレンスで, 呼び出し側が解放する必要がある. JavaネイティブインターフェースのPushLocalFrame(), PopLocalFrame(), DeleteLocalRef()関数を参照すること.

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

バージョン

SDL 2.0.0以降

関連項目(関数)

SDL_AndroidGetJNIEnv

SDL Wikiへのリンク

SDL_AndroidGetActivity - SDL Wiki