TextClassification
class TextClassification : Parcelable
kotlin.Any | |
↳ | android.view.textclassifier.TextClassification |
Information for generating a widget to handle classified text.
A TextClassification object contains icons, labels, onClickListeners and intents that may be used to build a widget that can be used to act on classified text. There is the concept of a primary action and other secondary actions.
e.g. building a view that, when clicked, shares the classified text with the preferred app:
<code>// Called preferably outside the UiThread. TextClassification classification = textClassifier.classifyText(allText, 10, 25); // Called on the UiThread. Button button = new Button(context); button.setCompoundDrawablesWithIntrinsicBounds(classification.getIcon(), null, null, null); button.setText(classification.getLabel()); button.setOnClickListener(v -> classification.getActions().get(0).getActionIntent().send()); </code>
e.g. starting an action mode with menu items that can handle the classified text:
<code>// Called preferably outside the UiThread. final TextClassification classification = textClassifier.classifyText(allText, 10, 25); // Called on the UiThread. view.startActionMode(new ActionMode.Callback() { public boolean onCreateActionMode(ActionMode mode, Menu menu) { for (int i = 0; i < classification.getActions().size(); ++i) { RemoteAction action = classification.getActions().get(i); menu.add(Menu.NONE, i, 20, action.getTitle()) .setIcon(action.getIcon()); } return true; } public boolean onActionItemClicked(ActionMode mode, MenuItem item) { classification.getActions().get(item.getItemId()).getActionIntent().send(); return true; } ... }); </code>
Summary
Nested classes | |
---|---|
Builder for building |
|
A request object for generating TextClassification. |
Inherited constants | |
---|---|
Public methods | |
---|---|
Int | |
MutableList<RemoteAction!>! |
Returns a list of actions that may be performed on the text. |
Float |
getConfidenceScore(entity: String!) Returns the confidence score for the specified entity. |
String |
Returns the entity at the specified index. |
Int |
Returns the number of entities found in the classified text. |
Bundle |
Returns the extended data. |
Drawable? |
getIcon() Returns an icon that may be rendered on a widget used to act on the classified text. |
String? |
getId() Returns the id, if one exists, for this object. |
Intent? |
Returns an intent that may be fired to act on the classified text. |
CharSequence? |
getLabel() Returns a label that may be rendered on a widget used to act on the classified text. |
View.OnClickListener? |
Returns the OnClickListener that may be triggered to act on the classified text. |
String? |
getText() Gets the classified text. |
String |
toString() |
Unit |
writeToParcel(dest: Parcel, flags: Int) |
Properties | |
---|---|
static Parcelable.Creator<TextClassification!> |
Public methods
describeContents
fun describeContents(): Int
Return | |
---|---|
Int |
a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either 0 or android.os.Parcelable#CONTENTS_FILE_DESCRIPTOR |
getActions
fun getActions(): MutableList<RemoteAction!>!
Returns a list of actions that may be performed on the text. The list is ordered based on the likelihood that a user will use the action, with the most likely action appearing first.
getConfidenceScore
fun getConfidenceScore(entity: String!): Float
Returns the confidence score for the specified entity. The value ranges from 0 (low confidence) to 1 (high confidence). 0 indicates that the entity was not found for the classified text.
Return | |
---|---|
Float |
Value is between 0.0 and 1.0 inclusive |
getEntity
fun getEntity(index: Int): String
Returns the entity at the specified index. Entities are ordered from high confidence to low confidence.
Exceptions | |
---|---|
java.lang.IndexOutOfBoundsException |
if the specified index is out of range. |
See Also
getEntityCount
fun getEntityCount(): Int
Returns the number of entities found in the classified text.
Return | |
---|---|
Int |
Value is 0 or greater |
getExtras
fun getExtras(): Bundle
Returns the extended data.
NOTE: Do not modify this bundle.
Return | |
---|---|
Bundle |
This value cannot be null . |
getIcon
fungetIcon(): Drawable?
Deprecated: Use getActions()
instead.
Returns an icon that may be rendered on a widget used to act on the classified text.
NOTE: This field is not parcelable and only represents the icon of the first RemoteAction
(if one exists) when this object is read from a parcel.
Return | |
---|---|
Drawable? |
This value may be null . |
getId
fun getId(): String?
Returns the id, if one exists, for this object.
Return | |
---|---|
String? |
This value may be null . |
getIntent
fungetIntent(): Intent?
Deprecated: Use getActions()
instead.
Returns an intent that may be fired to act on the classified text.
NOTE: This field is not parcelled and will always return null when this object is read from a parcel.
getLabel
fungetLabel(): CharSequence?
Deprecated: Use getActions()
instead.
Returns a label that may be rendered on a widget used to act on the classified text.
NOTE: This field is not parcelable and only represents the label of the first RemoteAction
(if one exists) when this object is read from a parcel.
Return | |
---|---|
CharSequence? |
This value may be null . |
getOnClickListener
fungetOnClickListener(): View.OnClickListener?
Deprecated: Use getActions()
instead.
Returns the OnClickListener that may be triggered to act on the classified text.
NOTE: This field is not parcelable and only represents the first RemoteAction
(if one exists) when this object is read from a parcel.
Return | |
---|---|
View.OnClickListener? |
This value may be null . |
getText
fun getText(): String?
Gets the classified text.
Return | |
---|---|
String? |
This value may be null . |
toString
fun toString(): String
Return | |
---|---|
String |
a string representation of the object. |
writeToParcel
fun writeToParcel(
dest: Parcel,
flags: Int
): Unit
Parameters | |
---|---|
dest |
Parcel: The Parcel in which the object should be written. This value cannot be null . |
flags |
Int: Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE . Value is either 0 or a combination of android.os.Parcelable#PARCELABLE_WRITE_RETURN_VALUE , and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES |