showFaceMatcherPrompt

suspend fun PromptModel.showFaceMatcherPrompt(matcher: FaceMatcher, referencePortrait: ByteString, reason: Reason = FaceMatchingReason, requireConfirmation: Boolean = false): Boolean

Prompts user to verify their identity by matching their face against a reference portrait using matcher.

Return

true if face match succeeded, false if dismissed, failed, or cancelled.

Parameters

matcher

the FaceMatcher to use for face verification.

referencePortrait

the reference portrait image bytes.

reason

the Reason describing why face matching is being requested. Defaults to FaceMatchingReason.

requireConfirmation

set to true to require explicit user confirmation after matching succeeds.

Throws

if coroutineContext does not have PromptModel.

if the UI layer hasn't bound any UI for PromptModel.