使用 OpenCV 进行 Android 开发

本教程旨在帮助您在 Android 项目中使用 OpenCV 库。

本指南已在 Ubuntu 上进行了检查，但不包含与平台相关的部分，因此应与 Android Studio 和 OpenCV4Android SDK 支持的任何操作系统兼容。

本教程假定您已安装并配置了以下内容：

• Android Studio的
• JDK的
• Android SDK 和 NDK
• 可选：OpenCV for Android SDK，来自 Github 或?SourceForge?的官方发布页面。高级：作为替代方案，SDK 可以通过?wiki 上的说明从源代码构建。

如果您需要上述任何方面的帮助，请参阅我们的?Android 开发简介指南。

如果您在彻底执行这些步骤后遇到任何错误，请随时通过 OpenCV?论坛与我们联系。我们将尽最大努力为您提供帮助。

使用 SDK 的 Hello OpenCV 示例

在本节中，我们将创建一个简单的应用程序，它只执行 OpenCV 加载。在下一节中，我们将扩展它以支持相机。

除了此说明之外，您还可以使用一些视频指南，例如这个

1. 打开 Android Studio，然后选择?Empty Views Activity （空视图活动） 创建空项目

2. 设置项目：

   • 选择?Java?语言
   • 选择?Groovy DSL?构建配置语言
   • 选择版本号不低于 OpenCV 4 Android 构建期间使用的版本号的 Minumum SDK
     • 如果你不知道，你可以在文件中找到它OpenCV-android-sdk/sdk/build.gradleandroid -> defaultConfig -> minSdkVersion

   

3. 单击“文件”->“新建”-“>导入模块...”，然后选择“OpenCV SDK 路径”

   

4. 将模块名称设置为并按OpenCVFinish

   

5. OpenCV 还提供体验式 Kotlin 支持。请将 Android Kotlin 插件添加到文件中：MyApplication/OpenCV/build.gradle
   插件 {

   ID：'org.jetbrains.kotlin.android'，版本：'1.7.10'，#version 可能因您的设置而异

   }
   喜欢这个：

   

   如果不这样做，可能会出现错误：
   任务失败，出现异常。

   -----------

   *哪里：

   构建文件“/home/alexander/AndroidStudioProjects/MyApplication/opencv/build.gradle”行：4

   * 出了什么问题：

   评估项目“：opencv”时出现问题。

   找不到 ID 为“kotlin-android”的>插件。
   修复程序是在这里找到的
6. OpenCV 项目使用功能。请在文件中启用它以阻止：buildConfigMyApplication/OpenCV/build.gradleandroid
   buildFeatures{

   buildConfig 为 true

   }
   喜欢这个：

   

   如果不这样做，可能会出现错误：
   JavaCameraView.java：15：错误：找不到符号导入 org.opencv.BuildConfig;^ symbol： class BuildConfig location： package org.opencv
   修复程序是在这里和这里找到的

7. 将模块添加到项目中：

   • 单击“文件”->“项目结构...”->依赖关系 ->所有模块 -> +（“添加依赖项”按钮） -> 模块依赖项

   

   • 选择app

   

   • 选择OpenCV

   

8. 在使用任何 OpenCV 函数之前，您必须先加载库。如果您的应用程序包含其他依赖于 OpenCV 的本机库，则应在 OpenCV 初始化后加载它们。添加以下代码以在应用启动时加载库：
   如果 （OpenCVLoader.initLocal（）） {

   Log.i（TAG， “OpenCV 加载成功”);

   } 还 {

   Log.e（TAG， “OpenCV 初始化失败！”);

   （Toast.makeText（this， “OpenCV 初始化失败！”， Toast.LENGTH_LONG））.show（）;

   返回;

   }
   喜欢这个：

   

9. 选择要检查示例的设备，然后按按钮运行代码run

   

使用 Maven Central 的 Hello OpenCV 示例

从 OpenCV 4.9.0 开始，OpenCV for Android 包随 Maven Central 一起提供，并且可以作为 Gradle 依赖项自动安装。在本节中，我们将创建一个简单的应用程序，它只使用 Maven Central 加载 OpenCV。

1. 打开 Android Studio，然后选择?Empty Views Activity （空视图活动） 创建空项目

   

2. 设置项目：

   • 选择?Java?语言
   • 选择?Groovy DSL?构建配置语言
   • 选择版本号不小于 OpenCV 支持的?Minumum SDK。对于 4.9.0，最低 SDK 版本为 21。

   

3. 编辑 OpenCV 库并将其添加到依赖项列表，如下所示：build.gradle
   依赖项 {

   实现“org.opencv：opencv：4.9.0”

   }
   4.9.0可以被官方发布的任何版本所取代。
4. 在使用任何 OpenCV 函数之前，您必须先加载库。如果您的应用程序包含其他依赖于 OpenCV 的本机库，则应在 OpenCV 初始化后加载它们。添加以下代码以在应用启动时加载库：
   如果 （OpenCVLoader.initLocal（）） {

   Log.i（TAG， “OpenCV 加载成功”);

   } 还 {

   Log.e（TAG， “OpenCV 初始化失败！”);

   （Toast.makeText（this， “OpenCV 初始化失败！”， Toast.LENGTH_LONG））.show（）;

   返回;

   }
   喜欢这个：

   

5. 选择要检查示例的设备，然后按按钮运行代码run

   

相机视图示例

在本节中，我们将扩展在上一节中创建的空 OpenCV 应用程序以支持相机。我们将拍摄相机帧并将它们显示在屏幕上。

1. 告诉系统我们需要相机权限。将以下代码添加到该文件中：MyApplication/app/src/main/AndroidManifest.xml
   <使用权限 android：name=“android.permission.CAMERA”/>

   <使用功能 android：name=“android.hardware.camera” android：required=“false”/>

   <使用功能 android：name=“android.hardware.camera.autofocus” android：required=“false”/>

   <使用功能 android：name=“android.hardware.camera.front” android：required=“false”/>

   <使用功能 android：name=“android.hardware.camera.front.autofocus” android：required=“false”/>
   喜欢这个：

   

2. 转到布局并删除带有文本“Hello World！”activity_main.xml

   

   这也可以通过从 XML 文件中删除块在代码或拆分模式下完成。TextView

3. 将相机视图添加到布局中：

   1. 在布局描述中添加方案：
      xmlns：opencv=“http://schemas.android.com/apk/res-auto”
   2. 替换为小部件：TextVieworg.opencv.android.JavaCameraView
      <org.opencv.android.JavaCameraView

      安卓：layout_width=“fill_parent”

      安卓：layout_height=“fill_parent”

      android：visibility=“消失了”

      android：id=“@+id/tutorial1_activity_java_surface_view”

      opencv：show_fps=“真”

      opencv：camera_id=“任何” />
   3. 如果收到布局警告，请将值替换为 for 和 propertiesfill_parentmatch_parentandroid:layout_widthandroid:layout_height

   你会得到这样的代码：

   <FrameLayout 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”

   安卓：layout_width=“match_parent”

   安卓：layout_height=“match_parent” >

   <!-- [camera_view] -->

   <org.opencv.android.JavaCameraView

   安卓：layout_width=“fill_parent”

   安卓：layout_height=“fill_parent”

   android：visibility=“消失了”

   android：id=“@+id/tutorial1_activity_java_surface_view”

   opencv：show_fps=“真”

   opencv：camera_id=“任何” />

   <!-- [camera_view] -->

   </FrameLayout（框架布局）>
4. 从 继承主类。CameraActivity 实现了 CV 应用程序所需的相机周边要求和其他一些实用程序。我们感兴趣的重写方法是 、 、 和org.opencv.android.CameraActivityonCreateonDestroyonPauseonResumegetCameraViewList
5. 实现接口方法应返回包含渲染内容的对象。此示例仅返回用于预览的相机帧：org.opencv.android.CameraBridgeViewBase.CvCameraViewListener2onCameraFrameMatreturn inputFrame.rgba();
6. 分配对象：org.opencv.android.CameraBridgeViewBase
   • 它应该在应用程序启动（方法）时创建，并且此类应设置为侦听器onCreate
   • 在暂停/恢复 （， 方法） 时，它应该被禁用/启用onPauseonResume
   • 应在应用完成时禁用（方法）onDestroy
   • 应该在getCameraViewList

7. 或者，您可以禁止手机调暗屏幕或锁定：

   getWindow（）.addFlags（WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON）;

   最后，你将获得类似于以下内容的源代码：

就是这样！现在，您可以在设备上运行代码进行检查。