ObjectDetector

  • ObjectDetector is used for finding DetectedObjects in an image.

  • An ObjectDetector instance is created using ObjectDetection.getClient(ObjectDetectorOptionsBase).

  • To perform object detection, you first create an InputImage from a source like a Bitmap.

  • The process method is used to detect objects from a supplied image, returning a Task with a list of DetectedObjects.

  • The close method releases the resources used by the detector.
public interface ObjectDetector extends Detector<List<DetectedObject>>

An ObjectDetection client for finding DetectedObjects in a supplied image.

An ObjectDetector is created via ObjectDetection.getClient(ObjectDetectorOptionsBase).

Example:

ObjectDetector objectDetector = ObjectDetection.getClient(options);

To perform object detection in an image, you first need to create an instance of InputImage from a Bitmap, ByteBuffer, 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 objects in the supplied InputImage.

Task<List<DetectedObject>> task = objectDetector.process(image);
 task.addOnSuccessListener(...).addOnFailureListener(...);

Public Method Summary

abstract void
close()
Closes the detector and releases its resources.
abstract Task<List<DetectedObject>>
process(MlImage image)
Detects objects from a supplied image.
abstract Task<List<DetectedObject>>
process(InputImage image)
Detects objects from a supplied image.

Inherited Method Summary

Public Methods

public abstract void close ()

Closes the detector and releases its resources.

public abstract Task<List<DetectedObject>> process (MlImage image)

Detects objects from a supplied image.

This is an experimental API in beta version.

Create an MlImage object using one of MlImage's builder methods. See MlImage documentation for more details.

Note that the width and height of the provided image cannot be less than 32.

When calling this method on an ObjectDetector created with CustomObjectDetectorOptions, the returned Task will contain an MlKitException with specific error code in the following cases: (1) with error code MlKitException.NOT_FOUND if cannot find the custom classifier model file; (2) with error code MlKitException.INVALID_ARGUMENT if the custom model file is not compatible with this SDK.

Returns

public abstract Task<List<DetectedObject>> process (InputImage image)

Detects objects from a supplied image.

Create an InputImage object using one of InputImage's factory methods. See InputImage documentation for more details.

Note that the width and height of the provided image cannot be less than 32.

When calling this method on an ObjectDetector created with CustomObjectDetectorOptions, the returned Task will contain an MlKitException with specific error code in the following cases: (1) with error code MlKitException.NOT_FOUND if cannot find the custom classifier model file; (2) with error code MlKitException.INVALID_ARGUMENT if the custom model file is not compatible with this SDK.

Returns