1 /*
2  * Copyright (C) 2018 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 package android.hardware.biometrics;
17 
18 /**
19  * Communication channel from
20  *   1) BiometricDialogImpl (SysUI) back to BiometricService
21  *   2) <Biometric>Service back to BiometricService
22  * Receives messages from the above and does some handling before forwarding to BiometricPrompt
23  * via IBiometricServiceReceiver.
24  * @hide
25  */
26 oneway interface IBiometricServiceReceiverInternal {
27     // Notify BiometricService that authentication was successful. If user confirmation is required,
28     // the auth token must be submitted into KeyStore.
onAuthenticationSucceeded(boolean requireConfirmation, in byte[] token)29     void onAuthenticationSucceeded(boolean requireConfirmation, in byte[] token);
30     // Notify BiometricService that an error has occurred.
onAuthenticationFailed(int cookie, boolean requireConfirmation)31     void onAuthenticationFailed(int cookie, boolean requireConfirmation);
32     // Notify BiometricService than an error has occured. Forward to the correct receiver depending
33     // on the cookie.
onError(int cookie, int error, String message)34     void onError(int cookie, int error, String message);
35     // Notifies that a biometric has been acquired.
onAcquired(int acquiredInfo, String message)36     void onAcquired(int acquiredInfo, String message);
37     // Notifies that the SystemUI dialog has been dismissed.
onDialogDismissed(int reason)38     void onDialogDismissed(int reason);
39     // Notifies that the user has pressed the "try again" button on SystemUI
onTryAgainPressed()40     void onTryAgainPressed();
41 }
42