Add onLockoutChanged for IBiometricsFace

Lockout is moved to the HAL (as compared to IBiometricsFingerprint@2.1)
To maintain public API behavior (BiometricPrompt) there needs to be a
way to synchronously retrieve the lockout status.

Bug: 121196511
Bug: 121198195
Bug: 123262389

Test: Builds
Change-Id: Idb0a1225451e9f123ccb42accbbbd2914ad6cabc

1 files changed, 15 insertions, 0 deletions

diff --git a/biometrics/face/1.0/IBiometricsFaceClientCallback.hal b/biometrics/face/1.0/IBiometricsFaceClientCallback.hal
index 93848c57b..c9dd0e262 100644
--- a/biometrics/face/1.0/IBiometricsFaceClientCallback.hal
+++ b/biometrics/face/1.0/IBiometricsFaceClientCallback.hal
@@ -113,4 +113,19 @@ interface IBiometricsFaceClientCallback {
      */
     oneway onEnumerate(uint64_t deviceId, vec<uint32_t> faceIds,
         int32_t userId);
+
+    /**
+     * A callback invoked when the lockout state changes.
+     *
+     * This method must only be invoked when setActiveUser() is called,
+     * when lockout starts, and when lockout ends. When lockout starts,
+     * duration must be greater than 0, and when lockout ends, duration must
+     * be 0. This must be called before calling onError() with parameters
+     * LOCKOUT or LOCKOUT_PERMANENT. If the user is permanently locked out,
+     * the duration must be MAX_UINT64.
+     *
+     * @param duration the remaining lockout duration in milliseconds, or 0
+     *     if the user is not locked out.
+     */
+    oneway onLockoutChanged(uint64_t duration);
 };