FaceDetection

AI-generated Key Takeaways

• FaceDetection is the entry point for using ML Kit's face detection capabilities to find faces within images.

• You create a FaceDetector instance using FaceDetection.getClient() with optional custom options or default settings.

• Face detection is performed by processing an InputImage created from a source like a Bitmap using the FaceDetector.

• To obtain specific facial features, use the methods in the Face object.

• Remember to release the FaceDetector resources when done by calling FaceDetector.close().

public class FaceDetection extends Object

Entry point to get a FaceDetector for finding Faces in a supplied image.

A FaceDetector is created via getClient(FaceDetectorOptions) or getClient() if you wish to use the default options. For example, the code below creates a FaceDetector with default options.

 FaceDetector faceDetector = FaceDetection.getClient(); 

To perform face detection in an image, you first need to create an instance of InputImage from a Bitmap, ByteBuffer, Image etc. See InputImage documentation for more details. For example, the code below creates an InputImage from a Bitmap.

 InputImage image = InputImage.fromBitmap(bitmap, rotationDegrees); 

Then the code below can detect faces in the supplied InputImage.

 Task<List<Face>> task = faceDetector.process(image);
 task.addOnSuccessListener(...).addOnFailureListener(...); 

Public Method Summary

static FaceDetector	getClient(FaceDetectorOptions options) Gets a new instance of FaceDetector that detects faces in a supplied image.
static FaceDetector	getClient() Gets an instance of FaceDetector that detects faces in a supplied image with a default FaceDetectorOptions.

Inherited Method Summary

From class java.lang.Object

Object	clone()
boolean	equals(Object arg0)
void	finalize()
final Class<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

Public Methods

public static FaceDetector getClient (FaceDetectorOptions options)

Gets a new instance of FaceDetector that detects faces in a supplied image.

To release the resources associated with a FaceDetector, you need to ensure that FaceDetector.close() is called on the resulting FaceDetector object once it will no longer be used.

Parameters

options	the options for the face detector

public static FaceDetector getClient ()

Gets an instance of FaceDetector that detects faces in a supplied image with a default FaceDetectorOptions.