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
175
176
177
178
179
180
181
182
183
184
|
/*
* Copyright (C) 2019 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.systemui.statusbar;
import static java.lang.annotation.RetentionPolicy.SOURCE;
import android.annotation.IntDef;
import android.view.InsetsVisibilities;
import android.view.View;
import android.view.WindowInsetsController.Appearance;
import android.view.WindowInsetsController.Behavior;
import com.android.systemui.plugins.statusbar.StatusBarStateController;
import com.android.systemui.statusbar.phone.StatusBar;
import java.lang.annotation.Retention;
/**
* Sends updates to {@link StateListener}s about changes to the status bar state and dozing state
*/
public interface SysuiStatusBarStateController extends StatusBarStateController {
// TODO: b/115739177 (remove this explicit ordering if we can)
@Retention(SOURCE)
@IntDef({RANK_STATUS_BAR, RANK_STATUS_BAR_WINDOW_CONTROLLER, RANK_STACK_SCROLLER, RANK_SHELF})
@interface SbStateListenerRank {}
// This is the set of known dependencies when updating StatusBarState
int RANK_STATUS_BAR = 0;
int RANK_STATUS_BAR_WINDOW_CONTROLLER = 1;
int RANK_STACK_SCROLLER = 2;
int RANK_SHELF = 3;
/**
* Add a listener and a rank based on the priority of this message
* @param listener the listener
* @param rank the order in which you'd like to be called. Ranked listeners will be
* notified before unranked, and we will sort ranked listeners from low to high
*
* @deprecated This method exists only to solve latent inter-dependencies from refactoring
* StatusBarState out of StatusBar.java. Any new listeners should be built not to need ranking
* (i.e., they are non-dependent on the order of operations of StatusBarState listeners).
*/
@Deprecated
void addCallback(StateListener listener, int rank);
/**
* Update the status bar state
* @param state see {@link StatusBarState} for valid options
* @return {@code true} if the state changed, else {@code false}
*/
default boolean setState(int state) {
return setState(state, false /* force */);
}
/**
* Update the status bar state
* @param state see {@link StatusBarState} for valid options
* @param force whether to set the state even if it's the same as the current state. This will
* dispatch the state to all StatusBarStateListeners, ensuring that all listening
* components are reset to this state.
* @return {@code true} if the state was changed or set forcefully
*/
boolean setState(int state, boolean force);
/**
* Provides a hint that the status bar has started to transition to another
* {@link StatusBarState}. This suggests that a matching call to setState() with the same value
* will happen in the near future, although that may not happen if the animation is canceled,
* etc.
*/
void setUpcomingState(int state);
/**
* If the status bar is in the process of transitioning to a new state, returns that state.
* Otherwise, returns the current state.
*/
int getCurrentOrUpcomingState();
/**
* Update the dozing state from {@link StatusBar}'s perspective
* @param isDozing well, are we dozing?
* @return {@code true} if the state changed, else {@code false}
*/
boolean setIsDozing(boolean isDozing);
/**
* Changes the current doze amount.
*
* @param dozeAmount New doze/dark amount.
* @param animated If change should be animated or not. This will cancel current animations.
*/
void setDozeAmount(float dozeAmount, boolean animated);
/**
* Changes the current doze amount, also starts the
* {@link com.android.internal.jank.InteractionJankMonitor InteractionJankMonitor} as possible.
*
* @param view An attached view, which will be used by InteractionJankMonitor.
* @param dozeAmount New doze/dark amount.
* @param animated If change should be animated or not. This will cancel current animations.
*/
void setAndInstrumentDozeAmount(View view, float dozeAmount, boolean animated);
/**
* Update the expanded state from {@link StatusBar}'s perspective
* @param expanded are we expanded?
* @return {@code true} if the state changed, else {@code false}
*/
boolean setPanelExpanded(boolean expanded);
/**
* Sets whether to leave status bar open when hiding keyguard
*/
void setLeaveOpenOnKeyguardHide(boolean leaveOpen);
/**
* Whether to leave status bar open when hiding keyguard
*/
boolean leaveOpenOnKeyguardHide();
/**
* Interpolated doze amount
*/
float getInterpolatedDozeAmount();
/**
* Whether status bar is going to full shade
*/
boolean goingToFullShade();
/**
* Whether the previous state of the status bar was the shade locked
*/
boolean fromShadeLocked();
/**
* Set keyguard requested
*/
void setKeyguardRequested(boolean keyguardRequested);
/**
* Is keyguard requested
*/
boolean isKeyguardRequested();
/**
* Set the system bar attributes
*/
void setSystemBarAttributes(@Appearance int appearance, @Behavior int behavior,
InsetsVisibilities requestedVisibilities, String packageName);
/**
* Set pulsing
*/
void setPulsing(boolean visibility);
/**
* Listener with rankings SbStateListenerRank that have dependencies so must be updated
* in a certain order
*/
class RankedListener {
final StateListener mListener;
final int mRank;
RankedListener(StateListener l, int r) {
mListener = l;
mRank = r;
}
}
}
|
