ContentCaptureSession

close

open fun close(): Unit

Closes this resource, relinquishing any underlying resources. This method is invoked automatically on objects managed by the try-with-resources statement.

createContentCaptureSession

fun createContentCaptureSession(context: ContentCaptureContext): ContentCaptureSession

Creates a new ContentCaptureSession.

See View.setContentCaptureSession(ContentCaptureSession) for more info.

destroy

fun destroy(): Unit

Destroys this session, flushing out all pending notifications to the service.

Once destroyed, any new notification will be dropped.

flush

open fun flush(): Unit

Flushes an internal buffer of UI events and signals System Intelligence (SI) that a semantically meaningful state has been reached. SI uses this signal to potentially rebuild the view hierarchy and understand the current state of the UI.

UI events are often batched together for performance reasons. A semantic batch represents a series of events that, when applied sequentially, result in a meaningful and complete UI state.

It is crucial to call flush() after completing a semantic batch to ensure SI can accurately reconstruct the view hierarchy.

Premature Flushing: Calling flush() within a semantic batch may lead to SI failing to rebuild the view hierarchy correctly. This could manifest as incorrect ordering of sibling nodes.

Delayed Flushing: While not immediately flushing after a semantic batch is generally safe, it's recommended to do so as soon as possible. In the worst-case scenario where a flush() is never called, SI will attempt to process the events after a short delay based on view appearance and disappearance events.

Note; This function belongs to Content Capture Version 1.

getContentCaptureContext

fun getContentCaptureContext(): ContentCaptureContext?

Gets the ContentCaptureContext associated with the session.

getContentCaptureSessionId

fun getContentCaptureSessionId(): ContentCaptureSessionId

Gets the id used to identify this session.

newAutofillId

open fun newAutofillId(
    hostId: AutofillId, 
    virtualChildId: Long
): AutofillId

Creates a new AutofillId for a virtual child, so it can be used to uniquely identify the children in the session.

newViewStructure

fun newViewStructure(view: View): ViewStructure

Creates a ViewStructure for a "standard" view.

This method should be called after a visible view is laid out; the view then must populate the structure and pass it to notifyViewAppeared(ViewStructure). Note: views that manage a virtual structure under this view must populate just the node representing this view and return right away, then asynchronously report (not necessarily in the UI thread) when the children nodes appear, disappear or have their text changed by calling ContentCaptureSession.notifyViewAppeared(ViewStructure), ContentCaptureSession.notifyViewDisappeared(AutofillId), and ContentCaptureSession.notifyViewTextChanged(AutofillId,CharSequence) respectively. The structure for the a child must be created using ContentCaptureSession.newVirtualViewStructure(AutofillId,long), and the autofillId for a child can be obtained either through childStructure.getAutofillId() or ContentCaptureSession.newAutofillId(AutofillId,long).

When the virtual view hierarchy represents a web page, you should also:

• Call ContentCaptureManager.getContentCaptureConditions() to infer content capture events should be generate for that URL.
• Create a new ContentCaptureSession child for every HTML element that renders a new URL (like an IFRAME) and use that session to notify events from that subtree.

Note: the following methods of the structure will be ignored:

• ViewStructure.setChildCount(int)
• ViewStructure.addChildCount(int)
• ViewStructure.getChildCount()
• ViewStructure.newChild(int)
• ViewStructure.asyncNewChild(int)
• ViewStructure.asyncCommit()
• ViewStructure.setWebDomain(String)
• ViewStructure.newHtmlInfoBuilder(String)
• ViewStructure.setHtmlInfo(android.view.ViewStructure.HtmlInfo)
• ViewStructure.setDataIsSensitive(boolean)
• ViewStructure.setAlpha(float)
• ViewStructure.setElevation(float)
• ViewStructure.setTransformation(android.graphics.Matrix)

Note: This function belongs to Content Capture Version 1.

newVirtualViewStructure

fun newVirtualViewStructure(
    parentId: AutofillId, 
    virtualId: Long
): ViewStructure

Creates a ViewStructure for a "virtual" view, so it can be passed to notifyViewAppeared(ViewStructure) by the view managing the virtual view hierarchy.

Note: This function belongs to Content Capture Version 1.

notifyContentInteractionEvent

open fun notifyContentInteractionEvent(autofillId: AutofillId): Unit

Notifies the Intelligence Service that a view has been interacted.

The view must have appeared before sending the interaction event.

notifySessionPaused

fun notifySessionPaused(): Unit

Notifies the Content Capture Service that a session has paused.

notifySessionResumed

fun notifySessionResumed(): Unit

Notifies the Content Capture Service that a session has resumed.

notifyViewAppeared

fun notifyViewAppeared(node: ViewStructure): Unit

Notifies the Content Capture Service that a node has been added to the view structure.

Typically called "manually" by views that handle their own virtual view hierarchy, or automatically by the Android System for views that return true on View.onProvideContentCaptureStructure(ViewStructure,int).

Consider use notifyViewsAppeared which has a better performance when notifying a list of nodes has appeared.

Note; This function belongs to Content Capture Version 1.

notifyViewDisappeared

fun notifyViewDisappeared(id: AutofillId): Unit

Notifies the Content Capture Service that a node has been removed from the view structure.

Typically called "manually" by views that handle their own virtual view hierarchy, or automatically by the Android System for standard views.

Consider use notifyViewsDisappeared which has a better performance when notifying a list of nodes has disappeared.

Note; This function belongs to Content Capture Version 1.

notifyViewInsetsChanged

fun notifyViewInsetsChanged(viewInsets: Insets): Unit

Notifies the Intelligence Service that the insets of a view have changed.

Note; This function belongs to Content Capture Version 1.

notifyViewTextChanged

fun notifyViewTextChanged(
    id: AutofillId, 
    text: CharSequence?
): Unit

Notifies the Intelligence Service that the value of a text node has been changed.

Note; This function belongs to Content Capture Version 1.

notifyViewsAppeared

fun notifyViewsAppeared(appearedNodes: MutableList<ViewStructure!>): Unit

Notifies the Content Capture Service that a list of nodes has appeared in the view structure.

Typically called manually by views that handle their own virtual view hierarchy.

Note; This function belongs to Content Capture Version 1.

notifyViewsDisappeared

fun notifyViewsDisappeared(
    hostId: AutofillId, 
    virtualIds: LongArray
): Unit

Notifies the Content Capture Service that many nodes has been removed from a virtual view structure.

Should only be called by views that handle their own virtual view hierarchy.

After UPSIDE_DOWN_CAKE, this method wraps the virtual children with a pair of view tree appearing and view tree appeared events.

Note; This function belongs to Content Capture Version 1.

setContentCaptureContext

fun setContentCaptureContext(context: ContentCaptureContext?): Unit

Sets the ContentCaptureContext associated with the session.

Typically used to change the context associated with the default session from an activity.

toString

open fun toString(): String

Returns a string representation of the object.