1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
|
/*
* Copyright (C) 2020 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.android.keyguard;
import android.os.Bundle;
import android.view.View;
import android.view.ViewGroup;
import android.view.ViewRootImpl;
import com.android.systemui.keyguard.DismissCallbackRegistry;
import com.android.systemui.keyguard.KeyguardViewMediator;
import com.android.systemui.plugins.FalsingManager;
import com.android.systemui.statusbar.phone.BiometricUnlockController;
import com.android.systemui.statusbar.phone.KeyguardBypassController;
import com.android.systemui.statusbar.phone.NotificationPanelViewController;
import com.android.systemui.statusbar.phone.StatusBar;
/**
* Interface to control Keyguard View. It should be implemented by KeyguardViewManagers, which
* should, in turn, be injected into {@link KeyguardViewMediator}.
*/
public interface KeyguardViewController {
/**
* Shows Keyguard.
* @param options
*/
void show(Bundle options);
/**
* Hides Keyguard with the fade-out animation as configured by the parameters provided.
*
* @param startTime
* @param fadeoutDuration
*/
void hide(long startTime, long fadeoutDuration);
/**
* Resets the state of Keyguard View.
* @param hideBouncerWhenShowing
*/
void reset(boolean hideBouncerWhenShowing);
/**
* Called when the device started going to sleep.
*/
default void onStartedGoingToSleep() {};
/**
* Called when the device has finished going to sleep.
*/
default void onFinishedGoingToSleep() {};
/**
* Called when the device started waking up.
*/
default void onStartedWakingUp() {};
/**
* Called when the device started turning on.
*/
default void onScreenTurningOn() {};
/**
* Called when the device has finished turning on.
*/
default void onScreenTurnedOn() {};
/**
* Sets whether the Keyguard needs input.
* @param needsInput
*/
void setNeedsInput(boolean needsInput);
/**
* Called when cancel button in bouncer is pressed.
*/
void onCancelClicked();
/**
* Sets whether the keyguard is occluded by another window.
*
* @param occluded
* @param animate
*/
void setOccluded(boolean occluded, boolean animate);
/**
* @return Whether the keyguard is showing
*/
boolean isShowing();
/**
* Dismisses the keyguard by going to the next screen or making it gone.
*/
void dismissAndCollapse();
/**
* Notifies that Keyguard is just about to go away.
*/
void keyguardGoingAway();
/**
* @return Whether window animation for unlock should be disabled.
*/
boolean shouldDisableWindowAnimationsForUnlock();
/**
* @return Whether the keyguard is going to notification shade.
*/
boolean isGoingToNotificationShade();
/**
* @return Whether subtle animation should be used for unlocking the device.
*/
boolean isUnlockWithWallpaper();
/**
* @return Whether subtle animation should be used for unlocking the device.
*/
boolean shouldSubtleWindowAnimationsForUnlock();
/**
* Starts the animation before we dismiss Keyguard, i.e. an disappearing animation on the
* security view of the bouncer.
*
* @param finishRunnable the runnable to be run after the animation finished, or {@code null} if
* no action should be run
*/
void startPreHideAnimation(Runnable finishRunnable);
/**
* @return the ViewRootImpl of the View where the Keyguard is mounted.
*/
ViewRootImpl getViewRootImpl();
// TODO: Deprecate registerStatusBar in KeyguardViewController interface. It is currently
// only used for testing purposes in StatusBarKeyguardViewManager, and it prevents us from
// achieving complete abstraction away from where the Keyguard View is mounted.
/**
* Registers the StatusBar to which this Keyguard View is mounted.
*
* @param statusBar
* @param container
* @param notificationPanelViewController
* @param biometricUnlockController
* @param dismissCallbackRegistry
* @param lockIconContainer
* @param notificationContainer
* @param bypassController
* @param falsingManager
*/
void registerStatusBar(StatusBar statusBar,
ViewGroup container,
NotificationPanelViewController notificationPanelViewController,
BiometricUnlockController biometricUnlockController,
DismissCallbackRegistry dismissCallbackRegistry,
ViewGroup lockIconContainer, View notificationContainer,
KeyguardBypassController bypassController, FalsingManager falsingManager);
}
|
