OpenCV-android-sdk 配置以及使用(Java)

weixin_33728268發表於2018-11-03
OpenCVAndroidJava

OpenCV是Open Source Computer Vision Library 縮寫, 主要由Intel公司的一些大佬寫的, 功能是提供大量的圖形圖形處理(計算機視覺)的庫, 並且提供 iOS 和 Android 的 SDK, 由於我主要工作是和Camera以及演算法整合有關, 所以經常會用到這個工具, 在此記錄下 Android 端的 SDK 使用和配置

OpenCV-android-sdk下載

下載地址(官網): https://opencv.org/releases.html
最新的版本是4.0.0 beta, 我們下載穩定版本3.4.3, 直接點選Android pack進行下載, 下載後解壓即可.

匯入Java SDK到Android Studio

  1. 開啟Android Studio後新建一個專案 OpencvDemo,建好後, 依次點選
    File --> New --> Import Module , 如圖所示:
11656926-5b108879db687aea.PNG
import1.PNG
  1. 在開啟的視窗中選擇Opencv-android-sdk資料夾下面的sdk目錄, 如圖所示:
11656926-43bc38bec84ebb51.PNG
import2.PNG

將Module name 命名為 opencvSdk, 點選 Finish.

  1. 匯入過程中 Android Studio 會提示 Manifest 中 sdkVersion 設定的錯誤, 我們需要直接刪除 opencvSdk 中 AndroidManifest.xml 的 minSdkVersion 和 targetSdkVersion, 原因是現在 sdkVersion 的設定現在放到了 gradle 配置檔案中, 刪除 uses-sdk, 如圖所示:
11656926-781ac0bdc699abad.PNG
捕獲6.PNG
  1. 將opencvSdk中 build.gradle 關於android sdk 的相關設定改為和當前專案相同, 只需修改 compileSdkVersion minSdkVersion 和 targeSdkVersion, 如果所示:
11656926-81f630bfccaaa1fc.PNG
捕獲8.PNG
  1. 改完後重新編譯一下, OpenCV 匯入就大功告成了, 接下來是在我們自己的專案中進行使用.

使用Opencv中的高斯模糊

接下來我們寫個 Demo 來使用 OpenCV 中的高斯模糊, 首先在我們專案的中新增我們匯入的 opencvSdk 作為依賴, 在 build.gradle 中加入 implementation project(':opencvSdk') 如圖所示:

11656926-494f027717aa8f51.PNG
捕獲11.PNG

編寫 Demo, 做法是一個 ImageView 顯示清晰的圖片, 點選 Button 後將圖片進行高斯模糊, 並重新顯示出來, 高斯模糊使用程式碼如下:

import org.opencv.android.Utils;
import org.opencv.core.Mat;
import org.opencv.core.Size;
import org.opencv.imgproc.Imgproc;
//部分程式碼省略
public class MainActivity extends AppCompatActivity {

    private ImageView mImageView;
    // opencv相關功能實現所需要的so庫
    static {
        System.loadLibrary("opencv_java3");
    }

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar);
        setSupportActionBar(toolbar);

        mImageView = findViewById(R.id.iv_image);
        final Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.mipmap.ic_bg);
        mImageView.setImageBitmap(bitmap);

        FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab);
        fab.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                blurImage(bitmap);
                mImageView.setImageBitmap(bitmap);
            }
        });
    }
    //傳入任意bitmap, 返回模糊過後的bitmap
    private Bitmap blurImage(Bitmap origin) {
        Mat mat = new Mat();
        Utils.bitmapToMat(origin, mat);
        Imgproc.GaussianBlur(mat, mat, new Size(15, 15), 0);
        Utils.matToBitmap(mat, origin);
        return origin;
    }
}

重複點選 Button 可讓圖片越來越模糊, 效果圖片:


11656926-353a74fd778b37f0.PNG
捕獲12.PNG

說明

  • 從上面 Demo 中可以看到, 呼叫了 System.loadLibrary("opencv_java3");, 其實 OpenCV 核心功能都是通過C++實現的, android sdk 基本上就是封裝了 JNI 的呼叫, 所以執行時候必須載入核心庫 libopencv_java3.so, so庫的位置為 OpenCV-android-sdk\sdk\native\libs, 此目錄下有多個 CPU 架構的演算法庫, 上面 Demo 預設將所有的庫都打包到 apk 中了, 編譯完後 apk 體積會有 80M 左右, 但正常情況我們只需要 armeabi-v7a 和 arm64-v8a 這兩個目錄的庫, 因為現在手機端幾乎所有 CPU 都是 ARM 架構的.

  • 關於OpencvManager, OpencvManager 是官方推出的一個App, OpencvManager 是一個單獨的app, 安裝後, 我們就不需要將 libopencv_java3.so 打包到我們的 apk 中了, 只需通過 OpenCVLoader.initAsync() 方法進行初始化即可, 相當於將相關演算法庫單獨打包到了另一個 App 中, 這樣能減小 apk 體積, 但這種方法其實非常不實用, 因此很少有人使用.

從上面使用 OpenCV Java 的 SDK 可以看出來, 使用起來非常簡單, 但最大的問題是會增大 apk 體積, 由於我們只使用其中部分功能, 卻要將整個演算法庫都打包到 apk 中, 有沒有其他方式能減小 apk 體積呢?
答案是肯定的, 下篇文章中我將會講解如何不使用Java SDK 通過 JNI 呼叫 OpenCV SDK, 並最大程度減小 apk 佔用體積.

備註: 測試環境 Android Studio 3.2.1 compileSdkVersion 28 Android 8.1

相關文章