【Android FFMPEG 开发】C++ 回调 Java 方法 模板 ( JavaVM *vm | JNIEnv *env | jobject instance | 引用类型 | 模板代码示例 )

extern "C"
JNIEXPORT void JNICALL
Java_kim_hsl_ffmpeg_Player_native_1prepare(JNIEnv *env, jobject instance, jstring dataSource_){ ... }

//子线程 : 需要通过 JavaVM * 获取该子线程的 JNIEnv *
        JNIEnv *env_thread;
        //Java 虚拟机 调用附加线程的方法 , 可以获取当前线程的 JNIEnv* 指针
        vm->AttachCurrentThread(&env_thread, 0);

//JNI_OnLoad 中获取的 Java 虚拟机对象放在这里
JavaVM *javaVM;
int JNI_OnLoad(JavaVM *vm, void *r){
    javaVM = vm;
    return JNI_VERSION_1_6;
}

//主线程 : 可以直接使用 JNIEnv * 指针
        env->CallVoidMethod(instance, onErrorId, errorCode);

//子线程 : 需要通过 JavaVM * 获取该子线程的 JNIEnv *
        JNIEnv *env_thread;
        //Java 虚拟机 调用附加线程的方法 , 可以获取当前线程的 JNIEnv* 指针
        vm->AttachCurrentThread(&env_thread, 0);
        //调用 Java 方法
        env_thread->CallVoidMethod(instance, onErrorId, errorCode);
        //解除线程附加
        vm->DetachCurrentThread();

package kim.hsl.ffmpeg;
import android.util.Log;
/**
 * Java 层与 Native 层交互 接口
 */
public class Player implements SurfaceHolder.Callback {
    private static final String TAG = "Player";
    // 加载动态库
    static {
        System.loadLibrary("native-lib");
    }
    /**
     * C++ 层错误回调函数
     * @param errorCode
     */
    public void onError(int errorCode){
        Log.i(TAG, "出现错误 错误码 : " + errorCode);
    }
    /**
     * C++ 中 prepare 时回调该方法
     */
    public void onPrepare(){
        Log.i(TAG, "准备完毕 onPrepare");
    }
    native void native_prepare(String dataSource);
}

//
// Created by octop on 2020/3/2.
// 作用 : 在 C/C++ 层调用 Java 层函数的帮助类
//       反射 Java 类 , 并调用其方法
//
#ifndef INC_011_FFMPEG_JAVACALLHELPER_H
#define INC_011_FFMPEG_JAVACALLHELPER_H
#include <jni.h>
class JavaCallHelper {
public:
    //构造方法
    JavaCallHelper(JavaVM *vm, JNIEnv *env, jobject instance);
    //析构方法
    ~JavaCallHelper();
    //错误回调方法 , 通过该方法回调错误信息给 Java 层
    void onError(int thread, int errorCode);
    //准备回调方法
    void onPrepare(int thread);
private:
    /*
     * 跨线程相关 :
     *      JNIEnv * 是不能跨线程使用的
     *      如果在线程中反射调用 Java 方法
     *      必须重新获取对应线程的 JNIEnv *env
     */
    JavaVM *vm;
    JNIEnv *env;
    jobject instance;
    //onError 方法对应的 方法 ID
    jmethodID onErrorId;
    //onPrepare 方法对应的 方法 ID
    jmethodID onPrepareId;
};
#endif //INC_011_FFMPEG_JAVACALLHELPER_H

//
// Created by octop on 2020/3/2.
//
#include "JavaCallHelper.h"
JavaCallHelper::JavaCallHelper(JavaVM *vm, JNIEnv *env, jobject instance) {
    /*
     * 如果在子线程调用 Java 方方法
     *      需要借助 JavaVM * vm , 获取子线程的 JNIEnv *env 进行反射调用
     *
     * 如果在主线程调用 Java 方法
     *      可以直接调用主线程传入的 JNIEnv *env 进行反射调用
     *
     * 注意 : jobject 如果要跨方法 , 跨线程调用 , 需要创建全局引用 , 不要使用局部引用
     */
    this->vm = vm;
    this->env = env;
    this->instance = env->NewGlobalRef(instance);
    //初始化 onError 方法反射信息
    jclass clazz = env->GetObjectClass(instance);
    //Java 中对应的方法 public void onError(int errorCode)
    this->onErrorId = env->GetMethodID(clazz, "onError", "(I)V");
    //Java 中对应的 public void onPrepare()
    this->onPrepareId = env->GetMethodID(clazz, "onPrepare", "()V");
}
JavaCallHelper::~JavaCallHelper() {
    //释放全局引用
    env->DeleteGlobalRef(instance);
}
/**
 * 判断 thread 是否是主线程
 *      如果是主线程 :
 *      如果是子线程 :
 *
 *
 * @param thread
 * @param errorCode
 */
void JavaCallHelper::onError(int thread, int errorCode) {
    if(thread == 1){
        //主线程 : 可以直接使用 JNIEnv * 指针
        this->env->CallVoidMethod(instance, onErrorId, errorCode);
    }else{
        //子线程 : 需要通过 JavaVM * 获取该子线程的 JNIEnv *
        JNIEnv *env_thread;
        //Java 虚拟机 调用附加线程的方法 , 可以获取当前线程的 JNIEnv* 指针
        vm->AttachCurrentThread(&env_thread, 0);
        //调用 Java 方法
        env_thread->CallVoidMethod(instance, onErrorId, errorCode);
        //解除线程附加
        vm->DetachCurrentThread();
    }
}
void JavaCallHelper::onPrepare(int thread) {
    if(thread == 1){
        //主线程 : 可以直接使用 JNIEnv * 指针
        this->env->CallVoidMethod(instance, onPrepareId);
    }else{
        //子线程 : 需要通过 JavaVM * 获取该子线程的 JNIEnv *
        JNIEnv *env_thread;
        //Java 虚拟机 调用附加线程的方法 , 可以获取当前线程的 JNIEnv* 指针
        vm->AttachCurrentThread(&env_thread, 0);
        //调用 Java 方法
        env_thread->CallVoidMethod(instance, onPrepareId);
        //解除线程附加
        vm->DetachCurrentThread();
    }
}

#include <jni.h>
#include <string>
#include "FFMPEG.h"
//声明 FFMPEG 类
FFMPEG *ffmpeg = 0;
//JNI_OnLoad 中获取的 Java 虚拟机对象放在这里
JavaVM *javaVM;
int JNI_OnLoad(JavaVM *vm, void *r){
    javaVM = vm;
    return JNI_VERSION_1_6;
}
extern "C"
JNIEXPORT void JNICALL
Java_kim_hsl_ffmpeg_Player_native_1prepare(JNIEnv *env, jobject instance, jstring dataSource_) {
  //创建 Java 调用类
    JavaCallHelper * javaCallHelper = new JavaCallHelper(javaVM, env, instance);
  //调用 Java 层的 onPrepare 方法
  callHelper->onPrepare(2);
}