implementation 'com.google.firebase:firebase-ml-vision:18.0.1'
implementation 'com.google.firebase:firebase-ml-vision-face-model:17.0.2'
在本教程中,您将使用远程图像。为便于下载和显示此类图像,请为Picasso库添加依赖项:
implementation 'com.squareup.picasso:picasso:2.71828'
ML Kit的面部轮廓检测始终在用户设备上本地运行。默认情况下,在用户首次打开应用程序时会自动下载进行面部轮廓检测的机器学习模型。但是,为了改善用户体验,我建议您在用户安装应用后立即开始下载。为此,请将以下 标记添加到AndroidManifest.xml 文件中:
<meta-data
android:name="com.google.firebase.ml.vision.DEPENDENCIES"
android:value="face" />
您将在应用程序的布局中需要三个小部件:EditText 用户可以在其中键入在线照片的URL的ImageView 小部件,用于显示照片的Button 小部件以及用于启动面部轮廓检测过程的 小部件。此外,您还需要一个 RelativeLayout 小部件来定位三个小部件。因此,将以下代码添加到主活动的布局XML文件中:
`<``RelativeLayout`
`xmlns:android``=``"[http://schemas.android.com/apk/res/android]( )"`
`android:layout_width``=``"match_parent"`
`android:layout_height``=``"match_parent"`
`android:padding``=``"16dp"``>`
`<``EditText` `android:layout_width``=``"match_parent"`
`android:layout_height``=``"wrap_content"`
`android:hint``=``"Image URL"`
`android:imeOptions``=``"actionGo"`
`android:inputType``=``"textUri"`
`android:id``=``"@+id/user_input"` `/>`
`<``Button` `android:layout_width``=``"match_parent"`
`android:layout_height``=``"wrap_content"`
`android:text``=``"Detect contours"`
`android:layout_alignParentBottom``=``"true"`
`android:id``=``"@+id/action_button"` `/>`
`<``ImageView` `android:layout_width``=``"match_parent"`
`android:layout_height``=``"match_parent"`
`android:id``=``"@+id/photo"`
`android:layout_below``=``"@+id/user_input"`
`android:layout_above``=``"@id/action_button"`
`android:scaleType``=``"centerCrop"``/>`
`</``RelativeLayout``>`
===========================================================================
使用Picasso库,下载和显示远程图像只需要调用两种方法。首先,调用load() 方法以指定要下载的图像的URL,然后调用该into() 方法以指定ImageView 要在其中显示下载图像的窗口小部件。
当然,只有在用户输入URL后才能调用这两种方法。因此,请确保在OnEditorActionListener 附加到EditText 上一步中创建的窗口小部件的对象中调用它们。以下代码显示了如何执行此操作:
user_input.setOnEditorActionListener { _, action, _ ->
if(action == EditorInfo.IME_ACTION_GO) {
Picasso.get()
.load(user_input.text.toString())
.into(photo)
true
}
false
}
立即运行应用程序并尝试键入有效的图像URL以确保其正常工作。
=============================================================================
您将在附加到Button 布局窗口小部件的单击事件处理程序中运行所有面部轮廓检测操作。因此,在继续之前,请将以下代码添加到您的活动:
action_button.setOnClickListener {
// Rest of the code goes here
}
为了能够处理面部数据,您现在必须创建一个 FirebaseVisionFaceDetector 对象。但是,由于默认情况下它不会检测面的轮廓,因此您还必须创建一个FirebaseVisionFaceDetectorOptions 可以对其进行配置的对象。
要创建有效的选项对象,必须遵循构建器模式。因此,创建FirebaseVisionFaceDetectorOptions.Builder 类的实例,调用其 setContourMode() 方法,并将ALL_CONTOURS 常量传递给它,以指定您要检测图像中存在的所有面的轮廓。
然后调用build() 构建器的方法来生成选项对象。
val detectorOptions =
FirebaseVisionFaceDetectorOptions.Builder()
.setContourMode(
FirebaseVisionFaceDetectorOptions.ALL_CONTOURS
).build()
您现在可以将选项对象传递给getVisionFaceDetector() ML Kit FirebaseVision 类的方法来创建面部轮廓检测器。
val detector = FirebaseVision
.getInstance()
.getVisionFaceDetector(detectorOptions)
==========================================================================
面部轮廓检测器无法直接使用ImageView 窗口小部件显示的照片 。相反,它希望您将FirebaseVisionImage 对象传递给它。要生成此类对象,必须将照片转换为Bitmap 对象。以下代码显示了如何执行此操作:
val visionImage = FirebaseVisionImage.fromBitmap(
(photo.drawable as BitmapDrawable).bitmap
)
您现在可以调用detectInImage() 检测器的方法来检测照片中存在的所有面部的轮廓。该方法以异步方式运行,并在FirebaseVisionFace 成功完成后返回对象列表 。
detector.detectInImage(visionImage).addOnSuccessListener {
// More code here
}
在on-success侦听器中,您可以使用it 隐式变量来遍历检测到的面部列表。每个面都有大量与之相关的轮廓点。要访问这些点,您必须调用该getContour() 方法。该方法可以返回几个不同面部标志的轮廓点。例如,如果将常量传递 LEFT_EYE 给它,它将返回左眼轮廓所需的点。同样,如果你传递UPPER_LIP_TOP 给它,你将得到与上唇顶边相关的点。
在本教程中,我们将使用FACE 常量,因为我们想要突出显示面部本身。以下代码显示如何打印沿每个面边缘存在的所有点的X和Y坐标:
it.forEach {
val contour = it.getContour(FirebaseVisionFaceContour.FACE)
contour.points.forEach {
println("Point at ${it.x}, ${it.y}")
}
// More code here
}
如果您现在尝试使用该应用程序并指定其中至少有一个面部的图像,您应该在Logcat 窗口中看到类似的内容:
要突出显示检测到的面部,让我们使用轮廓点简单地绘制它们周围的路径。为了能够绘制这样的路径,您需要一个ImageView
小部件位图的可变副本。通过调用其copy()
方法创建一个。
val mutableBitmap =
(photo.drawable as BitmapDrawable).bitmap.copy(
Bitmap.Config.ARGB_8888, true
)
通过直接修改位图的像素来绘制路径可能很困难。因此,通过将它传递给Canvas 类的构造函数,为它创建一个新的2D画布 。
此外,创建一个Paint 对象以指定要在画布上绘制的像素的颜色。以下代码显示如何创建可在其上绘制半透明红色像素的画布:
val canvas = Canvas(mutableBitmap)
ImageView` 小部件位图的可变副本。通过调用其`copy()` 方法创建一个。
val mutableBitmap =
(photo.drawable as BitmapDrawable).bitmap.copy(
Bitmap.Config.ARGB_8888, true
)
通过直接修改位图的像素来绘制路径可能很困难。因此,通过将它传递给Canvas 类的构造函数,为它创建一个新的2D画布 。
此外,创建一个Paint 对象以指定要在画布上绘制的像素的颜色。以下代码显示如何创建可在其上绘制半透明红色像素的画布:
val canvas = Canvas(mutableBitmap)