OpenCV4Android开发实录(1)：移植OpenCV3.3.0库到Android Studio

OpenCV4Android开发实录(1)：移植OpenCV3.3.0库到Android Studio

转载请声明出处：http://blog.csdn.net/andrexpert/article/details/78993533

 

OpenCV4Android系列：

1. OpenCV4Android开发实录(1)：移植OpenCV3.3.0库到Android Studio

2.OpenCV4Android开发实录(2)： 使用OpenCV3.3.0库实现人脸检测

 

1.OpenCV开源框架简介
    OpenCV是一个基于BSD许可（开源）发行的跨平台计算机视觉库，可以运行在Linux、Windows、Android和Mac OS操作系统上。它轻量级而且高效——由一系列 C 函数和少量 C++ 类构成，同时提供了Python、Ruby、MATLAB等语言的接口，实现了图像处理和计算机视觉方面的很多通用算法。截止本文日期，OpenCV官方提供的最新版本为OpenCV3.4.0，但是这里将以OpenCV3.3.0为主，根据不同的平台下载方式如下：

   

(1)  OpenCV核心框架

(2) OpenCV SDK介绍

2. 移植OpenCV库到Android Studio

以静态加载方式
(1) 创建新的Android Studio工程，将OpenCV库以Module的形式引入到工程中，即File->Import Module，Source directory选中...\opencv-3.3.0-android-sdk\OpenCV-android-
sdk\sdk\java目录，然后直接下一步即可。

(2) 添加openCVLibrary330库作为app module的依赖
步骤：File->Project Structure->选中app的Dependencies选项，点击”+”选中Module dependencies
 
(3) 配置NDK环境。由于在后面演示使用官方Sample需要使用NDK编译，这里需要在Android Studio工程中配置好NDK环境。
步骤：File->Project Structure->选中SDK Location选项，设置Android NDK location路径
 
(4)修改app模块中的build.gradle，添加sourceSets字段。

android {
    compileSdkVersion 25
    defaultConfig {
        applicationId "com.jiangdg.opencv4android"
        minSdkVersion 15
        targetSdkVersion 25
        versionCode 1
        versionName "1.0"
    }
    ….// 代码省略
    sourceSets {
        main {
            jniLibs.srcDirs = ['libs']
        }
    }
}

将工程切换到Android选项，就会看到在app目录下自动生成一个jniLibs目录，然后，我们再将OpenCV本地库(…\opencv-3.3.0-android-sdk\OpenCV-android-sdk\sdk\native\libs)拷贝到工程的jniLibs目录。这里我根据项目所需只拷贝了arm64-v8a、armeabi、armeabi-v7a架构文件，内容如下：
 
至此，OpenCV库的移植就完成了，整个工程视图如下：

3.编写第一个OpenCV实例：Hello OpenCV
    HelloOpenCV实例功能比较简单，即通过OpenCV库实现Camera渲染到手机屏幕，以便验证OpenCV库移植到Android Studio是否成功。核心代码如下：
(1) HelloOpenCVActivity.class

/**
 * 第一个OpenCV例子
 * Created by jiangdongguo on 2017/12/29.
 */
public class HelloOpenCVActivity extends AppCompatActivity {
    private static final String TAG = "HelloOpenCVActivity";
    @BindView(R.id.HelloOpenCvView)
    CameraBridgeViewBase mOpenCvCameraView;
    private LoaderCallbackInterface mLoaderCallback = new BaseLoaderCallback(this) {
        @Override
        public void onManagerConnected(int status) {
            switch (status) {
                // OpenCV引擎初始化加载成功
                case LoaderCallbackInterface.SUCCESS:
                    Log.i(TAG, "OpenCV loaded successfully.");
                    // 连接到Camera
                    mOpenCvCameraView.enableView();
                    break;
                default:
                    super.onManagerConnected(status);
                    break;
            }
        }
    };
    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 全屏显示
        getWindow().addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN);


        setContentView(R.layout.activity_hello);
        // 绑定View
        ButterKnife.bind(this);
        mOpenCvCameraView.setVisibility(SurfaceView.VISIBLE);
        // 注册Camera连接状态事件监听器
        mOpenCvCameraView.setCvCameraViewListener(new CameraBridgeViewBase.CvCameraViewListener2() {


            @Override
            public void onCameraViewStarted(int width, int height) {
            }

            @Override
            public void onCameraViewStopped() {
            }

            @Override
            public Mat onCameraFrame(CameraBridgeViewBase.CvCameraViewFrame inputFrame) {
                return inputFrame.rgba();
            }
        });
    }

    @Override
    protected void onResume() {
        super.onResume();
        // OpenCVLoader.initDebug()静态加载OpenCV库
	    // OpenCVLoader.initAsync()为动态加载OpenCV库，即需要安装OpenCV Manager
        if (!OpenCVLoader.initDebug()) {
            Log.w(TAG, "static loading library fail,Using Manager for initialization");
            OpenCVLoader.initAsync(OpenCVLoader.OPENCV_VERSION_3_3_0, this, mLoaderCallback);
        } else {
            Log.w(TAG, "OpenCV library found inside package. Using it!");
            mLoaderCallback.onManagerConnected(LoaderCallbackInterface.SUCCESS);
        }
    }

    @Override
    protected void onPause() {
        super.onPause();
        // 断开与Camera的连接
        if (mOpenCvCameraView != null) {
            mOpenCvCameraView.disableView();
        }
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        // 断开与Camera的连接
        if (mOpenCvCameraView != null) {
            mOpenCvCameraView.disableView();
        }
    }
}

(2) activity_hello.xml

 

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:opencv="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <org.opencv.android.JavaCameraView
        android:id="@+id/HelloOpenCvView"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent"
        android:visibility="gone"
        opencv:camera_id="any"
        opencv:show_fps="true" />
</LinearLayout>

注：通过JavaCameraView源码可知，JavaCameraView实际上是SurfaceView的一个子类，自定义属性opencv:camera_id为指定摄像头ID，其默认为开启后置摄像头；opencv:show_fps为是否显示帧率。
(3) AndroidMainfest.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"/>
<uses-feature android:name="android.hardware.camera.front" android:required="false"/>
<uses-feature android:name="android.hardware.camera.front.autofocus" android:required="false"/>

参考资料：
(1)  OpenCV4Android官网
(2) OpenCV Tutorials
(3) Android Development with OpenCV

 

(4) OpenCV4Android SDK

 

 

源码下载：https://github.com/jiangdongguo/OpenCV4Android（欢迎star & fork）