Android jni包裹文件（jni wrapper）

参考资料：

1 http://code.google.com/p/android-recorder/downloads/list  这个是一个android recorder ，使用speex编码，代码很干净，推荐一读
2 http://andrewbrobinson.com/2011/11/28/a-jni-wrapper-for-speex-on-android/  这个是国外大牛不爽另外一位大牛没开放jni wrapper，所以自己写了一个POST（参照我的NDK 编译SPEEX一文）

3 http://blog.csdn.net/chenfeng0104/article/details/7088138 这个是一篇CSDN上的文章，也是介绍了JNI包裹文件，不过有一点错误，我已在文中评论。

感谢以上朋友的分享！

可能有很多朋友还不知道 jni wrapper 是用来干什么的，如果有玩过windows 驱动的朋友应该很容易理解，其实就是一个驱动文件，用于作为 Java 与 .so 库之间的接口 (.so 就是我们将C/C++文件编译出来的库) ， 那么驱动文件的话其实就是需要你把要用的函数用特定格式写出来，而对于用户呢，不需要知道驱动文件函数的格式怎么写，只需要知道怎么使用这个类，有什么成员函数就够了，所以简单的来说，就是完成这个工作。

所以，我们应该有大至的了解了，需要做两件事，一，写一个驱动，二，写一个类

准备工作： 新建一个android 应用工程，下载最新的speex源代码，解压后取出libspeex与include放入$project/jni/

因为类比较简单，大家看起来也很亲切，所以我们先介绍类： 先在你的$project/src/$package/ 新建一个类，如下图，我建了Speex.java

这个类很简单吧，首先，我们要调用库，库的名字叫“speex”，eclips 会自动去掉libspeex.so的前缀，所以不要写成"libspeex".(注：org.slf4j是一个log的库，有兴趣的可以下下来，没有的话可以注释掉) ，这个类里面有几个函数，如public native int open(int compression)，注意，要加上native来表示这是调用native编译出来的库。

[cpp]  view plain copy print ?

1. <span style="background-color: rgb(255, 255, 255);">package com.ultraman;  
2.   
3. import org.slf4j.Logger;  
4. import org.slf4j.LoggerFactory;  
5.   
6. class Speex  {  
7.   
8.     /* quality 
9.      * 1 : 4kbps (very noticeable artifacts, usually intelligible) 
10.      * 2 : 6kbps (very noticeable artifacts, good intelligibility) 
11.      * 4 : 8kbps (noticeable artifacts sometimes) 
12.      * 6 : 11kpbs (artifacts usually only noticeable with headphones) 
13.      * 8 : 15kbps (artifacts not usually noticeable) 
14.      */  
15.     private static final int DEFAULT_COMPRESSION = 8;  
16.     private Logger log = LoggerFactory.getLogger(Speex.class);  
17.       
18.     Speex() {  
19.     }  
20.   
21.     public void init() {  
22.         load();   
23.         open(DEFAULT_COMPRESSION);  
24.         log.error("speex opened");  
25.     }  
26.       
27.     private void load() {  
28.         try {  
29.             System.loadLibrary("speex");  
30.         } catch (Throwable e) {  
31.             e.printStackTrace();  
32.         }  
33.   
34.     }  
35.   
36.     public native int open(int compression);  
37.     public native int getFrameSize();  
38.     public native int decode(byte encoded[], short lin[], int size);  
39.     public native int encode(short lin[], int offset, byte encoded[], int size);  
40.     public native void close();  
41.       
42. }</span>  

类写完了，那么接下来怎么去写驱动呢，用一些小工具来帮我们把格式先写好吧,javah ,只要安装过JDK的就有了

进入$project/，

>javah -classpath bin/classes -jni  com.ultraman.Speex

classpath 是你存放类的目录，-jni 生成的头文件放到jni文件夹里。  类的名称（package_name + class_name）

打开头文件，那么就可以看到帮我们写好的那个类中函数对应驱动函数的名字，如：

encode()---->JNIEXPORT jbyteArray JNICALL Java_com_speex_ultraman_speex_encode  (JNIEnv *, jobject, jshortArray);

然后创建jni wrapper文件，在$project/jni/下新建speex_jni.cpp，然后为在类中的成员函数签名写出实现。如下：

[html]  view plain copy print ?

1. #include <jni.h>  
2.   
3. #include <string.h>  
4. #include <unistd.h>  
5.   
6. #include <speex/speex.h>  
7.   
8. static int codec_open = 0;  
9.   
10. static int dec_frame_size;  
11. static int enc_frame_size;  
12.   
13. static SpeexBits ebits, dbits;  
14. void *enc_state;  
15. void *dec_state;  
16.   
17. static JavaVM *gJavaVM;  
18.   
19. extern "C"  
20. JNIEXPORT jint JNICALL Java_com_ultraman_Speex_open  
21.   (JNIEnv *env, jobject obj, jint compression) {  
22.     int tmp;  
23.   
24.     if (codec_open++ != 0)  
25.         return (jint)0;  
26.   
27.     speex_bits_init(&ebits);  
28.     speex_bits_init(&dbits);  
29.   
30.     enc_state = speex_encoder_init(&speex_nb_mode);  
31.     dec_state = speex_decoder_init(&speex_nb_mode);  
32.     tmp = compression;  
33.     speex_encoder_ctl(enc_state, SPEEX_SET_QUALITY, &tmp);  
34.     speex_encoder_ctl(enc_state, SPEEX_GET_FRAME_SIZE, &enc_frame_size);  
35.     speex_decoder_ctl(dec_state, SPEEX_GET_FRAME_SIZE, &dec_frame_size);  
36.   
37.     return (jint)0;  
38. }  
39.   
40. extern "C"  
41. JNIEXPORT jint Java_com_ultraman_Speex_encode  
42.     (JNIEnv *env, jobject obj, jshortArray lin, jint offset, jbyteArray encoded, jint size) {  
43.   
44.         jshort buffer[enc_frame_size];  
45.         jbyte output_buffer[enc_frame_size];  
46.     int nsamples = (size-1)/enc_frame_size + 1;  
47.     int i, tot_bytes = 0;  
48.   
49.     if (!codec_open)  
50.         return 0;  
51.   
52.     speex_bits_reset(&ebits);  
53.   
54.     for (i = 0; i < nsamples; i++) {  
55.         env->GetShortArrayRegion(lin, offset + i*enc_frame_size, enc_frame_size, buffer);  
56.         speex_encode_int(enc_state, buffer, &ebits);  
57.     }  
58.     //env->GetShortArrayRegion(lin, offset, enc_frame_size, buffer);  
59.     //speex_encode_int(enc_state, buffer, &ebits);  
60.   
61.     tot_bytes = speex_bits_write(&ebits, (char *)output_buffer,  
62.                      enc_frame_size);  
63.     env->SetByteArrayRegion(encoded, 0, tot_bytes,  
64.                 output_buffer);  
65.   
66.         return (jint)tot_bytes;  
67. }  
68.   
69. extern "C"  
70. JNIEXPORT jint JNICALL Java_com_ultraman_Speex_decode  
71.     (JNIEnv *env, jobject obj, jbyteArray encoded, jshortArray lin, jint size) {  
72.   
73.         jbyte buffer[dec_frame_size];  
74.         jshort output_buffer[dec_frame_size];  
75.         jsize encoded_length = size;  
76.   
77.     if (!codec_open)  
78.         return 0;  
79.   
80.     env->GetByteArrayRegion(encoded, 0, encoded_length, buffer);  
81.     speex_bits_read_from(&dbits, (char *)buffer, encoded_length);  
82.     speex_decode_int(dec_state, &dbits, output_buffer);  
83.     env->SetShortArrayRegion(lin, 0, dec_frame_size,  
84.                  output_buffer);  
85.   
86.     return (jint)dec_frame_size;  
87. }  
88.   
89. extern "C"  
90. JNIEXPORT jint JNICALL Java_com_ultraman_Speex_getFrameSize  
91.     (JNIEnv *env, jobject obj) {  
92.   
93.     if (!codec_open)  
94.         return 0;  
95.     return (jint)enc_frame_size;  
96.   
97. }  
98.   
99. extern "C"  
100. JNIEXPORT void JNICALL Java_com_ultraman_Speex_close  
101.     (JNIEnv *env, jobject obj) {  
102.   
103.     if (--codec_open != 0)  
104.         return;  
105.   
106.     speex_bits_destroy(&ebits);  
107.     speex_bits_destroy(&dbits);  
108.     speex_decoder_destroy(dec_state);  
109.     speex_encoder_destroy(enc_state);  
110. }  

然后，在jni目录下新建一个Android.mk，用于NDK编译speex库文件以及我们的驱动文件：

[cpp]  view plain copy print ?

1. LOCAL_PATH := $(call my-dir)  
2.    
3. include $(CLEAR_VARS)  
4.    
5. LOCAL_MODULE    := libspeex  
6. LOCAL_CFLAGS = -DFIXED_POINT -DUSE_KISS_FFT -DEXPORT="" -UHAVE_CONFIG_H  
7. LOCAL_C_INCLUDES := $(LOCAL_PATH)/include  
8.    
9. LOCAL_SRC_FILES :=  \  
10. ./speex_jni.cpp \  
11. ./libspeex/bits.c \  
12. ./libspeex/buffer.c \  
13. ./libspeex/cb_search.c \  
14. ./libspeex/exc_10_16_table.c \  
15. ./libspeex/exc_10_32_table.c \  
16. ./libspeex/exc_20_32_table.c \  
17. ./libspeex/exc_5_256_table.c \  
18. ./libspeex/exc_5_64_table.c \  
19. ./libspeex/exc_8_128_table.c \  
20. ./libspeex/fftwrap.c \  
21. ./libspeex/filterbank.c \  
22. ./libspeex/filters.c \  
23. ./libspeex/gain_table.c \  
24. ./libspeex/gain_table_lbr.c \  
25. ./libspeex/hexc_10_32_table.c \  
26. ./libspeex/hexc_table.c \  
27. ./libspeex/high_lsp_tables.c \  
28. ./libspeex/jitter.c \  
29. ./libspeex/kiss_fft.c \  
30. ./libspeex/kiss_fftr.c \  
31. ./libspeex/lpc.c \  
32. ./libspeex/lsp.c \  
33. ./libspeex/lsp_tables_nb.c \  
34. ./libspeex/ltp.c \  
35. ./libspeex/mdf.c \  
36. ./libspeex/modes.c \  
37. ./libspeex/modes_wb.c \  
38. ./libspeex/nb_celp.c \  
39. ./libspeex/preprocess.c \  
40. ./libspeex/quant_lsp.c \  
41. ./libspeex/resample.c \  
42. ./libspeex/sb_celp.c \  
43. ./libspeex/scal.c \  
44. ./libspeex/smallft.c \  
45. ./libspeex/speex.c \  
46. ./libspeex/speex_callbacks.c \  
47. ./libspeex/speex_header.c \  
48. ./libspeex/stereo.c \  
49. ./libspeex/vbr.c \  
50. ./libspeex/vq.c \  
51. ./libspeex/window.c \  
52.   
53. include $(BUILD_SHARED_LIBRARY)  

因为是编译静态库，NDK还需要新建一个Application.mk

[cpp]  view plain copy print ?

1. APP_ABI := armeabi armeabi-v7a  

接着进入/jni/incllude/speex/ ，如果没有speex_config_types.h ，就新建一个，修改内容为：

[cpp]  view plain copy print ?

1. #ifndef __SPEEX_TYPES_H__  
2. #define __SPEEX_TYPES_H__  
3. typedef short spx_int16_t;  
4. typedef unsigned short spx_uint16_t;  
5. typedef int spx_int32_t;  
6. typedef unsigned int spx_uint32_t;  
7. #endif  

最后在cygwin里进入你的$project/

>ndk-build

等待编译成功。。。

成功之后，你会看到你的$project目录下会生成一个libs文件夹，里面存放了libspeex.so。

然后在eclipse中，刷新一下工程，就可以运行了。