TextClassifier

HINT_TEXT_IS_EDITABLE

public static final String HINT_TEXT_IS_EDITABLE

Designates that the text in question is editable.

Constant Value: "android.text_is_editable"

HINT_TEXT_IS_NOT_EDITABLE

public static final String HINT_TEXT_IS_NOT_EDITABLE

Designates that the text in question is not editable.

Constant Value: "android.text_is_not_editable"

TYPE_ADDRESS

public static final String TYPE_ADDRESS

Physical address.

Constant Value: "address"

TYPE_DATE

public static final String TYPE_DATE

Time reference that is no more specific than a date. May be absolute such as "01/01/2000" or relative like "tomorrow".

Constant Value: "date"

TYPE_DATE_TIME

public static final String TYPE_DATE_TIME

Time reference that includes a specific time. May be absolute such as "01/01/2000 5:30pm" or relative like "tomorrow at 5:30pm".

Constant Value: "datetime"

TYPE_EMAIL

public static final String TYPE_EMAIL

E-mail address (e.g. "noreply@android.com").

Constant Value: "email"

TYPE_FLIGHT_NUMBER

public static final String TYPE_FLIGHT_NUMBER

Flight number in IATA format.

Constant Value: "flight"

TYPE_OTHER

public static final String TYPE_OTHER

The classifier ran, but didn't recognize a known entity.

Constant Value: "other"

TYPE_PHONE

public static final String TYPE_PHONE

Phone number (e.g. "555-123 456").

Constant Value: "phone"

TYPE_UNKNOWN

public static final String TYPE_UNKNOWN

The TextClassifier failed to run.

Constant Value: ""

TYPE_URL

public static final String TYPE_URL

Web URL.

Constant Value: "url"

WIDGET_TYPE_CUSTOM_EDITTEXT

public static final String WIDGET_TYPE_CUSTOM_EDITTEXT

The widget involved in the text classification session is a custom editable text widget.

Constant Value: "customedit"

WIDGET_TYPE_CUSTOM_TEXTVIEW

public static final String WIDGET_TYPE_CUSTOM_TEXTVIEW

The widget involved in the text classification session is a custom text widget.

Constant Value: "customview"

WIDGET_TYPE_CUSTOM_UNSELECTABLE_TEXTVIEW

public static final String WIDGET_TYPE_CUSTOM_UNSELECTABLE_TEXTVIEW

The widget involved in the text classification session is a custom non-selectable text widget.

Constant Value: "nosel-customview"

WIDGET_TYPE_EDITTEXT

public static final String WIDGET_TYPE_EDITTEXT

The widget involved in the text classification session is a standard EditText.

Constant Value: "edittext"

WIDGET_TYPE_EDIT_WEBVIEW

public static final String WIDGET_TYPE_EDIT_WEBVIEW

The widget involved in the text classification session is a standard editable WebView.

Constant Value: "edit-webview"

WIDGET_TYPE_TEXTVIEW

public static final String WIDGET_TYPE_TEXTVIEW

The widget involved in the text classification session is a standard TextView.

Constant Value: "textview"

WIDGET_TYPE_UNKNOWN

public static final String WIDGET_TYPE_UNKNOWN

The widget involved in the text classification session is of an unknown/unspecified type.

Constant Value: "unknown"

WIDGET_TYPE_UNSELECTABLE_TEXTVIEW

public static final String WIDGET_TYPE_UNSELECTABLE_TEXTVIEW

The widget involved in the text classification session is a standard non-selectable TextView.

Constant Value: "nosel-textview"

WIDGET_TYPE_WEBVIEW

public static final String WIDGET_TYPE_WEBVIEW

The widget involved in the text classification session is a standard WebView.

Constant Value: "webview"

NO_OP

public static final TextClassifier NO_OP

No-op TextClassifier. This may be used to turn off TextClassifier features.

classifyText

public TextClassification classifyText (TextClassification.Request request)

Classifies the specified text and returns a TextClassification object that can be used to generate a widget for handling the classified text.

NOTE: Call on a worker thread. NOTE: If a TextClassifier has been destroyed, calls to this method should throw an IllegalStateException. See isDestroyed().

This method may take several seconds to complete, so it should only be called from a worker thread.

classifyText

public TextClassification classifyText (CharSequence text,
                int startIndex,
                int endIndex,
                LocaleList defaultLocales)

Classifies the specified text and returns a TextClassification object that can be used to generate a widget for handling the classified text.

NOTE: Call on a worker thread.

NOTE: Do not implement. The default implementation of this method calls classifyText(TextClassification.Request). If that method calls this method, a stack overflow error will happen. NOTE: If a TextClassifier has been destroyed, calls to this method should throw an IllegalStateException. See isDestroyed().

This method may take several seconds to complete, so it should only be called from a worker thread.

destroy

public void destroy ()

Destroys this TextClassifier. NOTE: If a TextClassifier has been destroyed, calls to its methods should throw an IllegalStateException. See isDestroyed().

Subsequent calls to this method are no-ops.

generateLinks

public TextLinks generateLinks (TextLinks.Request request)

Generates and returns a TextLinks that may be applied to the text to annotate it with links information.

NOTE: Call on a worker thread. NOTE: If a TextClassifier has been destroyed, calls to this method should throw an IllegalStateException. See isDestroyed().

This method may take several seconds to complete, so it should only be called from a worker thread.

getMaxGenerateLinksTextLength

public int getMaxGenerateLinksTextLength ()

Returns the maximal length of text that can be processed by generateLinks. NOTE: If a TextClassifier has been destroyed, calls to this method should throw an IllegalStateException. See isDestroyed().

This method may take several seconds to complete, so it should only be called from a worker thread.

isDestroyed

public boolean isDestroyed ()

Returns whether or not this TextClassifier has been destroyed. NOTE: If a TextClassifier has been destroyed, caller should not interact with the classifier and an attempt to do so would throw an IllegalStateException. However, this method should never throw an IllegalStateException.

onSelectionEvent

public void onSelectionEvent (SelectionEvent event)

Reports a selection event. NOTE: If a TextClassifier has been destroyed, calls to this method should throw an IllegalStateException. See isDestroyed().

suggestSelection

public TextSelection suggestSelection (CharSequence text,
                int selectionStartIndex,
                int selectionEndIndex,
                LocaleList defaultLocales)

Returns suggested text selection start and end indices, recognized entity types, and their associated confidence scores. The entity types are ordered from highest to lowest scoring.

NOTE: Call on a worker thread.

NOTE: If a TextClassifier has been destroyed, calls to this method should throw an IllegalStateException. See isDestroyed().

NOTE: Do not implement. The default implementation of this method calls suggestSelection(TextSelection.Request). If that method calls this method, a stack overflow error will happen.

This method may take several seconds to complete, so it should only be called from a worker thread.

suggestSelection

public TextSelection suggestSelection (TextSelection.Request request)

Returns suggested text selection start and end indices, recognized entity types, and their associated confidence scores. The entity types are ordered from highest to lowest scoring.

NOTE: Call on a worker thread.

NOTE: If a TextClassifier has been destroyed, calls to this method should throw an IllegalStateException. See isDestroyed().

This method may take several seconds to complete, so it should only be called from a worker thread.