一、知识准备:
1.了解Android工程如何运行在设备上
2.了解C/C++编译过程,能够读懂makefile
二、实现流程:
1.打开Eclipse,新建一个空白的Android工程:
项目名称为OpenCV_Test:
2.为新建工程引入OpenCV Library - 3.1.0库工程:
选择工程,右键点击Properties(属性),然后在Android页签中,用Add功能添加一个库工程引用。
3.打开src目录下面的MainActivity,由于我们的目标是在应用中通过OpenCV的Java API实现打开相机全屏显示,并获取预览框,所以MainActivity需要实现CvCameraViewListener2接口,可以实现三个方法,分别是:onCameraViewStarted、onCameraViewStopped和onCameraFrame,关键的图像处理写在onCameraFrame函数中:
4.修改AndroidManifest.xml文件:
添加相机的相关权限:
- <uses-permission android:name="android.permission.CAMERA"/>
- <uses-feature android:name="android.hardware.camera" android:required="false"/>
- <uses-feature android:name="android.hardware.camera.autofocus" android:required="false"/>
设置应用的界面主题为没有顶部标题栏且全屏显示的,在application标签中添加:
- <application
- android:allowBackup="true"
- android:icon="@drawable/ic_launcher"
- android:label="@string/app_name"
- android:theme="@android:style/Theme.NoTitleBar.Fullscreen" >
5.为界面布局文件添加显示相机内容的组件:
打开res/layout下面的activity_main.xml布局文件,往布局中添加一个OpenCV的视觉组件JavaCameraView:
- <RelativeLayout
- xmlns:android="http://schemas.android.com/apk/res/android"
- xmlns:tools="http://schemas.android.com/tools"
- xmlns:opencv="http://schemas.android.com/apk/res-auto"
- android:layout_width="match_parent"
- android:layout_height="match_parent">
-
- <org.opencv.android.JavaCameraView
- android:layout_width="fill_parent"
- android:layout_height="fill_parent"
- android:id="@+id/camera_view"
- opencv:show_fps="true"
- opencv:camera_id="any"/>
-
- </RelativeLayout>
6.回到MainActivity中,完成API的调用:
声明一个CameraBridgeViewBase对象,用于存放activity_main.xml中的JavaCameraView组件,并在OnCreate中实现绑定和添加事件监听:
- mCVCamera = (CameraBridgeViewBase) findViewById(R.id.camera_view);
- mCVCamera.setCvCameraViewListener(this);
7.添加C/C++编译支持,即Add Native Support,这是为了不依赖于OpenCV Manager,直接引入库文件进行编译:
记住这里的填写的名称就是引入的库文件被编译生成.so文件的名称:
打开生成的jni目录下的Android.mk文件,这个是C/C++编译和链接时使用到的makefile配置文件,稍微做一点点修改内容,在“include $(CLEAR_VARS)”后面添加以下内容:
- OPENCV_CAMERA_MODULES:=on
- OPENCV_INSTALL_MODULES:=on
- OPENCV_LIB_TYPE:=SHARED
- ifdef OPENCV_ANDROID_SDK
- ifneq ("","$(wildcard $(OPENCV_ANDROID_SDK)/OpenCV.mk)")
- include ${OPENCV_ANDROID_SDK}/OpenCV.mk
- else
- include ${OPENCV_ANDROID_SDK}/sdk/native/jni/OpenCV.mk
- endif
- else
- include ../../sdk/native/jni/OpenCV.mk
- endif
如此,我们就完成了库文件的引入操作,那么接下来就是让相机的输入帧展示在预览组件JavaCameraView上。
8.修改public Mat onCameraFrame(CvCameraViewFrame inputFrame)回调函数的内容了,这个函数在相机刷新每一帧都会调用一次,而且每次的输入参数就是当前相机视图信息,我们直接获取其中的RGBA信息作为Mat数据返回给显示组件即可:
-
-
-
- @Override
- public Mat onCameraFrame(CvCameraViewFrame inputFrame) {
-
- return inputFrame.rgba();
- }
9.以上操作中,我们在OnCreate函数中已经获取到mCVCamera对象,只有调用mCVCamera.enableView()之后,预览组件才会显示每一帧的Mat图像,但是在显示之前我们必须先确保OpenCV的库文件已经加载完成,所以调用此方法需要进行异步处理:
-
-
-
- BaseLoaderCallback mLoaderCallback = new BaseLoaderCallback(this) {
- @Override
- public void onManagerConnected(int status){
- switch (status) {
- case LoaderCallbackInterface.SUCCESS:
- Log.i(TAG,"OpenCV loaded successfully");
- mCVCamera.enableView();
- break;
- default:
- break;
- }
- }
- };
所以只有当mLoaderCallback收到LoaderCallbackInterface.SUCCESS消息的时候,才会打开预览显示,那么这个消息是从哪里发出来的呢,这就需要我们重写Activity的onRusume方法了,因为每次当前Activity激活都会调用此方法,所以可以在此处检测OpenCV的库文件是否加载完毕:
- @Override
- public void onResume() {
- super.onResume();
- if (!OpenCVLoader.initDebug()) {
- Log.d(TAG,"OpenCV library not found!");
- } else {
- Log.d(TAG, "OpenCV library found inside package. Using it!");
- mLoaderCallback.onManagerConnected(LoaderCallbackInterface.SUCCESS);
- }
- };
三、结果展示:
至此,我们就完成了设备
相机打开
以及
输入预览数据的获取
,运行在设备上可以看到: