FirebaseVision

Entry class for Firebase machine learning vision services.

To use this class, get an instance via getInstance() or getInstance(FirebaseApp), and then get an instance of a detector. The code below is an example of getting an instance of a face detector:


 FirebaseVisionFaceDetector faceDetector = FirebaseVision.getInstance().getVisionFaceDetector();

See individual detector classes for details.

Public Method Summary

FirebaseVisionDocumentTextRecognizer	getCloudDocumentTextRecognizer(FirebaseVisionCloudDocumentRecognizerOptions options) Gets a `FirebaseVisionDocumentTextRecognizer` that can detect document text in a supplied image.
FirebaseVisionDocumentTextRecognizer	getCloudDocumentTextRecognizer() Gets a `FirebaseVisionDocumentTextRecognizer` that can detect document text in a supplied image with default options.
FirebaseVisionImageLabeler	getCloudImageLabeler(FirebaseVisionCloudImageLabelerOptions options) Gets a cloud version of `FirebaseVisionImageLabeler` that can detect labels in a supplied image.
FirebaseVisionImageLabeler	getCloudImageLabeler() Gets a cloud version of `FirebaseVisionImageLabeler` that can detect labels in a supplied image with default options.
FirebaseVisionTextRecognizer	getCloudTextRecognizer() Gets a `FirebaseVisionTextRecognizer` to perform optical character recognition with cloud model and default options.
FirebaseVisionTextRecognizer	getCloudTextRecognizer(FirebaseVisionCloudTextRecognizerOptions options) Gets a `FirebaseVisionTextRecognizer` to perform optical character recognition with cloud model and provided options.
static FirebaseVision	getInstance() Gets an instance of `FirebaseVision` associated with the default `FirebaseApp`.
static FirebaseVision	getInstance(FirebaseApp app) Gets an instance of `FirebaseVision` associated with the supplied `FirebaseApp`.
FirebaseVisionImageLabeler	getOnDeviceAutoMLImageLabeler(FirebaseVisionOnDeviceAutoMLImageLabelerOptions options) Gets an on device version of `FirebaseVisionImageLabeler` that labels a supplied image, using a model trained from Firebase AutoML.
FirebaseVisionImageLabeler	getOnDeviceImageLabeler() Gets an on device version of `FirebaseVisionImageLabeler` that labels a supplied image with a default `FirebaseVisionOnDeviceImageLabelerOptions`.
FirebaseVisionImageLabeler	getOnDeviceImageLabeler(FirebaseVisionOnDeviceImageLabelerOptions options) Gets an on device version of `FirebaseVisionImageLabeler` that labels a supplied image.
FirebaseVisionObjectDetector	getOnDeviceObjectDetector() Gets a `FirebaseVisionObjectDetector` that can detect objects in a supplied image with default options.
FirebaseVisionObjectDetector	getOnDeviceObjectDetector(FirebaseVisionObjectDetectorOptions options) Gets a `FirebaseVisionObjectDetector` that can detect objects in a supplied image with given options.
FirebaseVisionTextRecognizer	getOnDeviceTextRecognizer() Gets a `FirebaseVisionTextRecognizer` to perform optical character recognition with on-device model.
FirebaseVisionBarcodeDetector	getVisionBarcodeDetector(FirebaseVisionBarcodeDetectorOptions options) Gets a `FirebaseVisionBarcodeDetector` that can detect barcodes in a supplied image.
FirebaseVisionBarcodeDetector	getVisionBarcodeDetector() Gets a `FirebaseVisionBarcodeDetector` that can detect barcodes in a supplied image with a default `FirebaseVisionBarcodeDetectorOptions`.
FirebaseVisionCloudLandmarkDetector	getVisionCloudLandmarkDetector() Gets a `FirebaseVisionCloudLandmarkDetector` that can detect landmark in a supplied image with default options.
FirebaseVisionCloudLandmarkDetector	getVisionCloudLandmarkDetector(FirebaseVisionCloudDetectorOptions options) Gets a `FirebaseVisionCloudLandmarkDetector` that can detect landmark in a supplied image.
FirebaseVisionFaceDetector	getVisionFaceDetector() Gets a `FirebaseVisionFaceDetector` that detects faces in a supplied image with a default `FirebaseVisionFaceDetectorOptions`.
FirebaseVisionFaceDetector	getVisionFaceDetector(FirebaseVisionFaceDetectorOptions options) Gets a `FirebaseVisionFaceDetector` that detects faces in a supplied image.
boolean	isStatsCollectionEnabled() Determines whether stats collection in `FirebaseVision` is enabled or disabled
void	setStatsCollectionEnabled(boolean enable) Enables stats collection in ML Kit vision.

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 FirebaseVisionDocumentTextRecognizer getCloudDocumentTextRecognizer (FirebaseVisionCloudDocumentRecognizerOptions options)

Gets a FirebaseVisionDocumentTextRecognizer that can detect document text in a supplied image.

Parameters

options	the options for the cloud text detector.

Returns

an instance of FirebaseVisionDocumentTextRecognizer. Note that text detector instance will be the same instance if the supplied options are the same and under the same FirebaseVision.

public FirebaseVisionDocumentTextRecognizer getCloudDocumentTextRecognizer ()

Gets a FirebaseVisionDocumentTextRecognizer that can detect document text in a supplied image with default options.

Returns

an instance of FirebaseVisionDocumentTextRecognizer. Note that multiple calls of this API would always return the same cloud document text instance and under the same FirebaseVision.

public FirebaseVisionImageLabeler getCloudImageLabeler (FirebaseVisionCloudImageLabelerOptions options)

Gets a cloud version of FirebaseVisionImageLabeler that can detect labels in a supplied image.

Parameters

options	the options for the cloud image labeler.

Returns

an instance of FirebaseVisionImageLabeler. Note that image labeler instance will be the same instance if the supplied options are the same and under the same FirebaseVision.

public FirebaseVisionImageLabeler getCloudImageLabeler ()

Gets a cloud version of FirebaseVisionImageLabeler that can detect labels in a supplied image with default options.

Returns

an instance of FirebaseVisionImageLabeler. Note that multiple calls of this API would always return the same cloud label instance and under the same FirebaseVision.

public FirebaseVisionTextRecognizer getCloudTextRecognizer ()

Gets a FirebaseVisionTextRecognizer to perform optical character recognition with cloud model and default options.

Returns

an instance of FirebaseVisionTextRecognizer. Note there is only one instance of cloud FirebaseVisionTextRecognizer and under the same FirebaseVision.

public FirebaseVisionTextRecognizer getCloudTextRecognizer (FirebaseVisionCloudTextRecognizerOptions options)

Gets a FirebaseVisionTextRecognizer to perform optical character recognition with cloud model and provided options.

Returns

an instance of FirebaseVisionTextRecognizer. Note that the returned instance will be the same if the supplied options are the same and under the same FirebaseVision.

public static FirebaseVision getInstance ()

Gets an instance of FirebaseVision associated with the default FirebaseApp.

public static FirebaseVision getInstance (FirebaseApp app)

Gets an instance of FirebaseVision associated with the supplied FirebaseApp.

Parameters

app	the `FirebaseApp` to associate this `FirebaseVision` with.

public FirebaseVisionImageLabeler getOnDeviceAutoMLImageLabeler (FirebaseVisionOnDeviceAutoMLImageLabelerOptions options)

Gets an on device version of FirebaseVisionImageLabeler that labels a supplied image, using a model trained from Firebase AutoML.

Parameters

options	the options for the on device automl image labeler.

Returns

an instance of FirebaseVisionImageLabeler. Note that multiple calls of this API would always return the same image labeler instance and under the same FirebaseVision.

Throws

FirebaseMLException	if failed to instantiate a `FirebaseVisionImageLabeler`.

public FirebaseVisionImageLabeler getOnDeviceImageLabeler ()

Gets an on device version of FirebaseVisionImageLabeler that labels a supplied image with a default FirebaseVisionOnDeviceImageLabelerOptions.

Returns

an instance of FirebaseVisionImageLabeler. Note that multiple calls of this API would always return the same image label detector instance and under the same FirebaseVision.

public FirebaseVisionImageLabeler getOnDeviceImageLabeler (FirebaseVisionOnDeviceImageLabelerOptions options)

Gets an on device version of FirebaseVisionImageLabeler that labels a supplied image.

Parameters

options	the options for the on device image labeler.

Returns

an instance of FirebaseVisionImageLabeler. Note that image labeler instance will be the same instance if the supplied options are the same and under the same FirebaseVision.

public FirebaseVisionObjectDetector getOnDeviceObjectDetector ()

Gets a FirebaseVisionObjectDetector that can detect objects in a supplied image with default options.

Returns

an instance of FirebaseVisionObjectDetector. Note that multiple calls of this API would always return the same object detector instance and under the same FirebaseVision.

public FirebaseVisionObjectDetector getOnDeviceObjectDetector (FirebaseVisionObjectDetectorOptions options)

Gets a FirebaseVisionObjectDetector that can detect objects in a supplied image with given options.

Returns

an instance of FirebaseVisionObjectDetector. Note that multiple calls of this API would always return the same object detector instance if the supplied options are the same and under the same FirebaseVision.

public FirebaseVisionTextRecognizer getOnDeviceTextRecognizer ()

Gets a FirebaseVisionTextRecognizer to perform optical character recognition with on-device model.

Returns

an instance of FirebaseVisionTextRecognizer. Note there is only one instance of on-device FirebaseVisionTextRecognizer and under the same FirebaseVision.

public FirebaseVisionBarcodeDetector getVisionBarcodeDetector (FirebaseVisionBarcodeDetectorOptions options)

Gets a FirebaseVisionBarcodeDetector that can detect barcodes in a supplied image.

Parameters

options	the options for the barcode detector.

Returns

an instance of FirebaseVisionBarcodeDetector. Note that barcode detector instance will be the same instance if the supplied options are the same and under the same FirebaseVision.

public FirebaseVisionBarcodeDetector getVisionBarcodeDetector ()

Gets a FirebaseVisionBarcodeDetector that can detect barcodes in a supplied image with a default FirebaseVisionBarcodeDetectorOptions.

Returns

an instance of FirebaseVisionBarcodeDetector. Note that multiple calls of this API would always return the same barcode detector instance and under the same FirebaseVision.

public FirebaseVisionCloudLandmarkDetector getVisionCloudLandmarkDetector ()

Gets a FirebaseVisionCloudLandmarkDetector that can detect landmark in a supplied image with default options.

Returns

an instance of FirebaseVisionCloudLandmarkDetector. Note that multiple calls of this API would always return the same cloud landmark instance and under the same FirebaseVision.

public FirebaseVisionCloudLandmarkDetector getVisionCloudLandmarkDetector (FirebaseVisionCloudDetectorOptions options)

Gets a FirebaseVisionCloudLandmarkDetector that can detect landmark in a supplied image.

Parameters

options	the options for the cloud landmark detector.

Returns

an instance of FirebaseVisionCloudLandmarkDetector. Note that landmark detector instance will be the same instance if the supplied options are the same and under the same FirebaseVision.

public FirebaseVisionFaceDetector getVisionFaceDetector ()

Gets a FirebaseVisionFaceDetector that detects faces in a supplied image with a default FirebaseVisionFaceDetectorOptions.

Returns

an instance of FirebaseVisionFaceDetector. Note that multiple calls of this API would always return the same cloud face instance and under the same FirebaseVision.

public FirebaseVisionFaceDetector getVisionFaceDetector (FirebaseVisionFaceDetectorOptions options)

Gets a FirebaseVisionFaceDetector that detects faces in a supplied image.

Parameters

options	the options for the face detector.

Returns

an instance of FirebaseVisionFaceDetector. Note that face detector instance will be the same instance if the supplied options are the same and under the same FirebaseVision.

public boolean isStatsCollectionEnabled ()

Determines whether stats collection in FirebaseVision is enabled or disabled

Returns

true if stats collection is enabled and false otherwise.

public void setStatsCollectionEnabled (boolean enable)

Enables stats collection in ML Kit vision. The stats include API calls counts, errors, API call durations, options, etc. No personally identifiable information is logged.

The setting is per FirebaseApp, and it is persistent together with app's private data. It means if the user uninstalls the app or clears all app data, the setting will be erased. The best practice is to set the flag in each initialization.

By default the logging is enabled. You have to specifically set it to false to disable logging.