blob: 855b1bce115842baa10db62737061abb2ed43ffb [file] [log] [blame]
Dianne Hackborn7da6ac32010-12-09 19:22:04 -08001/*
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08002** Copyright 2006, The Android Open Source Project
3**
Jim Miller4eeb4f62012-11-08 00:04:29 -08004** 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
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08007**
Jim Miller4eeb4f62012-11-08 00:04:29 -08008** http://www.apache.org/licenses/LICENSE-2.0
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08009**
Jim Miller4eeb4f62012-11-08 00:04:29 -080010** 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
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080014** limitations under the License.
15*/
16
17package android.view;
18
Dianne Hackborn27eac1d2015-03-16 17:15:53 -070019import com.android.internal.app.IAssistScreenshotReceiver;
Clara Bayarri75e09792015-07-29 16:20:40 +010020import com.android.internal.os.IResultReceiver;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080021import com.android.internal.view.IInputContext;
22import com.android.internal.view.IInputMethodClient;
Muyuan Li94ce94e2016-02-24 16:20:54 -080023import com.android.internal.policy.IShortcutService;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080024
Dianne Hackborn2f0b1752011-05-31 17:59:49 -070025import android.content.res.CompatibilityInfo;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080026import android.content.res.Configuration;
Dianne Hackborn0aae2d42010-12-07 23:51:29 -080027import android.graphics.Bitmap;
Dianne Hackbornac8dea12011-04-20 18:18:51 -070028import android.graphics.Point;
Svetoslav Ganovc9c9a482012-07-16 08:46:07 -070029import android.graphics.Rect;
Adam Cohenf7522022012-10-03 20:03:18 -070030import android.os.Bundle;
Dianne Hackborn38e29a62011-09-18 14:43:08 -070031import android.os.IRemoteCallback;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080032import android.view.IApplicationToken;
Jorim Jaggi2f7d2922015-10-29 13:08:29 +010033import android.view.IAppTransitionAnimationSpecsFuture;
Jorim Jaggia6c934e2015-12-21 13:22:31 +010034import android.view.IDockedStackListener;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080035import android.view.IOnKeyguardExitResult;
36import android.view.IRotationWatcher;
37import android.view.IWindowSession;
Dianne Hackborneb94fa72014-06-03 17:48:12 -070038import android.view.IWindowSessionCallback;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080039import android.view.KeyEvent;
Jeff Brown6ec402b2010-07-28 15:48:59 -070040import android.view.InputEvent;
Svetoslav Ganov152e9bb2012-10-12 20:15:29 -070041import android.view.MagnificationSpec;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080042import android.view.MotionEvent;
Jeff Browna41ca772010-08-11 14:46:32 -070043import android.view.InputChannel;
Jeff Brown8d608662010-08-30 03:02:23 -070044import android.view.InputDevice;
Svetoslav Ganov1cf70bb2012-08-06 10:53:34 -070045import android.view.IInputFilter;
Filip Gruszczynski170192a2015-08-16 17:46:34 -070046import android.view.AppTransitionAnimationSpec;
Svetoslav1376d602014-03-13 11:17:26 -070047import android.view.WindowContentFrameStats;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080048
49/**
50 * System private interface to the window manager.
51 *
52 * {@hide}
53 */
54interface IWindowManager
55{
56 /**
57 * ===== NOTICE =====
58 * The first three methods must remain the first three methods. Scripts
59 * and tools rely on their transaction number to work properly.
60 */
61 // This is used for debugging
62 boolean startViewServer(int port); // Transaction #1
63 boolean stopViewServer(); // Transaction #2
64 boolean isViewServerRunning(); // Transaction #3
65
Dianne Hackborneb94fa72014-06-03 17:48:12 -070066 IWindowSession openSession(in IWindowSessionCallback callback, in IInputMethodClient client,
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080067 in IInputContext inputContext);
68 boolean inputMethodClientHasFocus(IInputMethodClient client);
Dianne Hackbornac8dea12011-04-20 18:18:51 -070069
Dianne Hackborn672cf452013-03-26 15:24:24 -070070 void getInitialDisplaySize(int displayId, out Point size);
71 void getBaseDisplaySize(int displayId, out Point size);
Jeff Brown43aa1592012-09-10 17:36:31 -070072 void setForcedDisplaySize(int displayId, int width, int height);
Craig Mautner59c00972012-07-30 12:10:24 -070073 void clearForcedDisplaySize(int displayId);
Dianne Hackborn672cf452013-03-26 15:24:24 -070074 int getInitialDisplayDensity(int displayId);
75 int getBaseDisplayDensity(int displayId);
Alan Viverettedf3a7ca2016-09-06 17:13:41 -040076 void setForcedDisplayDensityForUser(int displayId, int density, int userId);
77 void clearForcedDisplayDensityForUser(int displayId, int userId);
Jeff Brownd46747a2015-04-15 19:02:36 -070078 void setForcedDisplayScalingMode(int displayId, int mode); // 0 = auto, 1 = disable
Dianne Hackborn7916ac62011-05-16 20:45:48 -070079
Dianne Hackbornc652de82013-02-15 16:32:56 -080080 void setOverscan(int displayId, int left, int top, int right, int bottom);
81
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080082 // These can only be called when holding the MANAGE_APP_TOKENS permission.
83 void pauseKeyDispatching(IBinder token);
84 void resumeKeyDispatching(IBinder token);
85 void setEventDispatching(boolean enabled);
Dianne Hackborne4fbd622009-03-27 18:09:16 -070086 void addWindowToken(IBinder token, int type);
87 void removeWindowToken(IBinder token);
Wale Ogunwale706ed792015-08-02 10:29:44 -070088 /**
89 * Adds an application token to the specified task Id.
90 * @param addPos The position to add the token to in the task.
91 * @param token The token to add.
92 * @param taskId The Id of the task we are adding the token to.
93 * @param stackId Stack Id to create a new Task with the input task Id on
94 * if the task doesn't exist yet.
95 * @param requestedOrientation Orientation to use.
96 * @param fullscreen True if the application token is fullscreen.
97 * @param showWhenLocked True if the application token should be shown when locked.
98 * @param userId Id of user to associate the token with.
99 * @param configChanges Input configuration changes.
100 * @param voiceInteraction True if the token is in voice interaction mode.
101 * @param launchTaskBehind True if the token is been launched from behind.
102 * @param taskBounds Bounds to use when creating a new Task with the input task Id if
103 * the task doesn't exist yet.
Filip Gruszczynskiebcc8752015-08-25 16:51:05 -0700104 * @param configuration Configuration that is being used with this task.
Wale Ogunwaleb1faf602016-01-27 09:12:31 -0800105 * @param taskResizeMode The resize mode of the task.
Wale Ogunwale6cae7652015-12-26 07:36:26 -0800106 * @param alwaysFocusable True if the app windows are always focusable regardless of the stack
107 * they are in.
Wale Ogunwaleb1faf602016-01-27 09:12:31 -0800108 * @param homeTask True if this is the task.
Yorke Lee0e852472016-06-15 10:03:18 -0700109 * @param targetSdkVersion The application's target SDK version
Wale Ogunwale706ed792015-08-02 10:29:44 -0700110 */
Filip Gruszczynskiebcc8752015-08-25 16:51:05 -0700111 void addAppToken(int addPos, IApplicationToken token, int taskId, int stackId,
Craig Mautner5d9f5472013-11-12 14:02:52 -0800112 int requestedOrientation, boolean fullscreen, boolean showWhenLocked, int userId,
Wale Ogunwale706ed792015-08-02 10:29:44 -0700113 int configChanges, boolean voiceInteraction, boolean launchTaskBehind,
Wale Ogunwaleb1faf602016-01-27 09:12:31 -0800114 in Rect taskBounds, in Configuration configuration, int taskResizeMode,
Robert Carrfd10cd12016-06-29 16:41:50 -0700115 boolean alwaysFocusable, boolean homeTask, int targetSdkVersion, int rotationAnimationHint);
Wale Ogunwale706ed792015-08-02 10:29:44 -0700116 /**
117 *
118 * @param token The token we are adding to the input task Id.
119 * @param taskId The Id of the task we are adding the token to.
Wale Ogunwale2998eef2015-12-02 19:46:29 -0800120 * @param stackId Stack Id to create a new Task with the input task Id on
121 * if the task doesn't exist yet.
Wale Ogunwale706ed792015-08-02 10:29:44 -0700122 * @param taskBounds Bounds to use when creating a new Task with the input task Id if
123 * the task doesn't exist yet.
Filip Gruszczynskiebcc8752015-08-25 16:51:05 -0700124 * @param config Configuration that is being used with this task.
Wale Ogunwaleb1faf602016-01-27 09:12:31 -0800125 * @param taskResizeMode The resize mode of the task.
126 * @param homeTask True if this is the task.
Wale Ogunwale706ed792015-08-02 10:29:44 -0700127 */
Wale Ogunwaleb1faf602016-01-27 09:12:31 -0800128 void setAppTask(IBinder token, int taskId, int stackId, in Rect taskBounds,
129 in Configuration config, int taskResizeMode, boolean homeTask);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800130 void setAppOrientation(IApplicationToken token, int requestedOrientation);
131 int getAppOrientation(IApplicationToken token);
132 void setFocusedApp(IBinder token, boolean moveFocusNow);
Dianne Hackborn7da6ac32010-12-09 19:22:04 -0800133 void prepareAppTransition(int transit, boolean alwaysKeepCurrent);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800134 int getPendingAppTransition();
Dianne Hackborn84375872012-06-01 19:03:50 -0700135 void overridePendingAppTransition(String packageName, int enterAnim, int exitAnim,
136 IRemoteCallback startedCallback);
Dianne Hackborneabfb3a2012-04-16 16:28:22 -0700137 void overridePendingAppTransitionScaleUp(int startX, int startY, int startWidth,
138 int startHeight);
Chet Haase10e23ab2015-02-11 15:08:38 -0800139 void overridePendingAppTransitionClipReveal(int startX, int startY,
140 int startWidth, int startHeight);
Dianne Hackborn8078d8c2012-03-20 11:11:26 -0700141 void overridePendingAppTransitionThumb(in Bitmap srcThumb, int startX, int startY,
Michael Jurka832cb222012-04-13 09:32:47 -0700142 IRemoteCallback startedCallback, boolean scaleUp);
Winson Chunga4ccb862014-08-22 15:26:27 -0700143 void overridePendingAppTransitionAspectScaledThumb(in Bitmap srcThumb, int startX,
Winson Chung2e7f3bd2014-09-05 13:17:22 +0200144 int startY, int targetWidth, int targetHeight, IRemoteCallback startedCallback,
145 boolean scaleUp);
Filip Gruszczynski170192a2015-08-16 17:46:34 -0700146 /**
147 * Overrides animation for app transition that exits from an application to a multi-window
148 * environment and allows specifying transition animation parameters for each window.
149 *
150 * @param specs Array of transition animation descriptions for entering windows.
151 *
152 * @hide
153 */
154 void overridePendingAppTransitionMultiThumb(in AppTransitionAnimationSpec[] specs,
Filip Gruszczynski1a5203d2015-10-29 17:43:49 -0700155 IRemoteCallback startedCallback, IRemoteCallback finishedCallback, boolean scaleUp);
Winson Chung044d5292014-11-06 11:05:19 -0800156 void overridePendingAppTransitionInPlace(String packageName, int anim);
Jorim Jaggi2f7d2922015-10-29 13:08:29 +0100157
158 /**
159 * Like overridePendingAppTransitionMultiThumb, but uses a future to supply the specs. This is
160 * used for recents, where generating the thumbnails of the specs takes a non-trivial amount of
161 * time, so we want to move that off the critical path for starting the new activity.
162 */
163 void overridePendingAppTransitionMultiThumbFuture(
164 IAppTransitionAnimationSpecsFuture specsFuture, IRemoteCallback startedCallback,
165 boolean scaleUp);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800166 void executeAppTransition();
Wale Ogunwale3b232392016-05-13 15:37:13 -0700167
168 /**
169 * Called to set the starting window for the input token and returns true if the starting
170 * window was set for the token.
171 */
172 boolean setAppStartingWindow(IBinder token, String pkg, int theme,
Dianne Hackborn2f0b1752011-05-31 17:59:49 -0700173 in CompatibilityInfo compatInfo, CharSequence nonLocalizedLabel, int labelRes,
Adam Powell04fe6eb2013-05-31 14:39:48 -0700174 int icon, int logo, int windowFlags, IBinder transferFrom, boolean createIfNeeded);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800175 void setAppVisibility(IBinder token, boolean visible);
Chong Zhang813be132016-08-25 12:12:33 -0700176 void notifyAppResumed(IBinder token, boolean wasStopped, boolean allowSavedSurface);
Chong Zhang45e6d2d2016-07-20 18:33:56 -0700177 void notifyAppStopped(IBinder token);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800178 void startAppFreezingScreen(IBinder token, int configChanges);
179 void stopAppFreezingScreen(IBinder token, boolean force);
180 void removeAppToken(IBinder token);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800181
Filip Gruszczynski14b4e572015-11-03 15:53:55 -0800182 /** Used by system ui to report that recents has shown itself. */
183 void endProlongedAnimations();
184
Dianne Hackborne36d6e22010-02-17 19:46:25 -0800185 // Re-evaluate the current orientation from the caller's state.
186 // If there is a change, the new Configuration is returned and the
187 // caller must call setNewConfiguration() sometime later.
188 Configuration updateOrientationFromAppTokens(in Configuration currentConfig,
189 IBinder freezeThisOneIfNeeded);
Chong Zhang167bbfac2016-03-31 09:44:34 -0700190 // Notify window manager of the new configuration. Returns an array of stack ids that's
191 // affected by the update, ActivityManager should resize these stacks.
192 int[] setNewConfiguration(in Configuration config);
193
194 // Retrieves the new bounds after the configuration update evaluated by window manager.
195 Rect getBoundsForNewConfiguration(int stackId);
Jim Miller4eeb4f62012-11-08 00:04:29 -0800196
Dianne Hackborn9d9ece32012-09-10 15:33:52 -0700197 void startFreezingScreen(int exitAnim, int enterAnim);
198 void stopFreezingScreen();
199
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800200 // these require DISABLE_KEYGUARD permission
201 void disableKeyguard(IBinder token, String tag);
202 void reenableKeyguard(IBinder token);
203 void exitKeyguardSecurely(IOnKeyguardExitResult callback);
Mike Lockwood520d8bc2011-02-18 13:23:13 -0500204 boolean isKeyguardLocked();
205 boolean isKeyguardSecure();
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800206 boolean inKeyguardRestrictedInputMode();
Dianne Hackborn90c52de2011-09-23 12:57:44 -0700207 void dismissKeyguard();
Adrian Roosd5c2db62016-03-08 16:11:31 -0800208 void keyguardGoingAway(int flags);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800209
Dianne Hackbornffa42482009-09-23 22:20:11 -0700210 void closeSystemDialogs(String reason);
Jim Miller4eeb4f62012-11-08 00:04:29 -0800211
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800212 // These can only be called with the SET_ANIMATON_SCALE permission.
213 float getAnimationScale(int which);
214 float[] getAnimationScales();
215 void setAnimationScale(int which, float scale);
216 void setAnimationScales(in float[] scales);
Jim Miller4eeb4f62012-11-08 00:04:29 -0800217
Dianne Hackborneb94fa72014-06-03 17:48:12 -0700218 float getCurrentAnimatorScale();
219
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800220 // For testing
221 void setInTouchMode(boolean showFocus);
Brad Fitzpatrick68044332010-11-22 18:19:48 -0800222
223 // For StrictMode flashing a red border on violations from the UI
224 // thread. The uid/pid is implicit from the Binder call, and the Window
225 // Manager uses that to determine whether or not the red border should
226 // actually be shown. (it will be ignored that pid doesn't have windows
227 // on screen)
228 void showStrictModeViolation(boolean on);
229
Brad Fitzpatrickc1a968a2010-11-24 08:56:40 -0800230 // Proxy to set the system property for whether the flashing
231 // should be enabled. The 'enabled' value is null or blank for
232 // the system default (differs per build variant) or any valid
233 // boolean string as parsed by SystemProperties.getBoolean().
234 void setStrictModeVisualIndicatorPreference(String enabled);
235
Sander Alewijnsed2a1eec2014-07-09 12:57:05 +0100236 /**
Sander Alewijnsea87863a2014-07-29 12:01:38 +0100237 * Set whether screen capture is disabled for all windows of a specific user
Sander Alewijnsed2a1eec2014-07-09 12:57:05 +0100238 */
Sander Alewijnsea87863a2014-07-29 12:01:38 +0100239 void setScreenCaptureDisabled(int userId, boolean disabled);
Sander Alewijnsed2a1eec2014-07-09 12:57:05 +0100240
Winsonc28098f2015-10-30 14:50:19 -0700241 /**
242 * Cancels the window transitions for the given task.
243 */
244 void cancelTaskWindowTransition(int taskId);
245
Winson13d30662015-11-06 15:30:29 -0800246 /**
247 * Cancels the thumbnail transitions for the given task.
248 */
249 void cancelTaskThumbnailTransition(int taskId);
250
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800251 // These can only be called with the SET_ORIENTATION permission.
252 /**
Jeff Brown01a98dd2011-09-20 15:08:29 -0700253 * Update the current screen rotation based on the current state of
254 * the world.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800255 * @param alwaysSendConfiguration Flag to force a new configuration to
256 * be evaluated. This can be used when there are other parameters in
257 * configuration that are changing.
Dianne Hackbornf87d1962012-04-04 12:48:24 -0700258 * @param forceRelayout If true, the window manager will always do a relayout
259 * of its windows even if the rotation hasn't changed.
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800260 */
Dianne Hackbornf87d1962012-04-04 12:48:24 -0700261 void updateRotation(boolean alwaysSendConfiguration, boolean forceRelayout);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800262
263 /**
264 * Retrieve the current screen orientation, constants as per
265 * {@link android.view.Surface}.
266 */
267 int getRotation();
Jim Miller4eeb4f62012-11-08 00:04:29 -0800268
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800269 /**
270 * Watch the rotation of the screen. Returns the current rotation,
271 * calls back when it changes.
272 */
273 int watchRotation(IRotationWatcher watcher);
Daniel Sandlerb73617d2010-08-17 00:41:00 -0400274
Adam Powelldfee59a2011-08-05 20:48:30 -0700275 /**
Brian Colonnab1b9a8a2013-03-29 11:52:42 -0400276 * Remove a rotation watcher set using watchRotation.
277 * @hide
278 */
279 void removeRotationWatcher(IRotationWatcher watcher);
280
281 /**
Adam Powelldfee59a2011-08-05 20:48:30 -0700282 * Determine the preferred edge of the screen to pin the compact options menu against.
283 * @return a Gravity value for the options menu panel
284 * @hide
285 */
286 int getPreferredOptionsPanelGravity();
287
Jim Miller4eeb4f62012-11-08 00:04:29 -0800288 /**
289 * Lock the device orientation to the specified rotation, or to the
290 * current rotation if -1. Sensor input will be ignored until
291 * thawRotation() is called.
292 * @hide
293 */
294 void freezeRotation(int rotation);
Daniel Sandlerb73617d2010-08-17 00:41:00 -0400295
Jim Miller4eeb4f62012-11-08 00:04:29 -0800296 /**
297 * Release the orientation lock imposed by freezeRotation().
298 * @hide
299 */
300 void thawRotation();
Dianne Hackborn0aae2d42010-12-07 23:51:29 -0800301
Jim Miller4eeb4f62012-11-08 00:04:29 -0800302 /**
Svetoslav8e3feb12014-02-24 13:46:47 -0800303 * Gets whether the rotation is frozen.
Svetoslav Ganov80943d82013-01-02 10:25:37 -0800304 *
305 * @return Whether the rotation is frozen.
306 */
307 boolean isRotationFrozen();
308
309 /**
Zak Cohen3683fb12016-07-11 19:47:37 +0100310 * Screenshot the current wallpaper layer, including the whole screen.
311 */
312 Bitmap screenshotWallpaper();
313
314 /**
Dianne Hackborn27eac1d2015-03-16 17:15:53 -0700315 * Used only for assist -- request a screenshot of the current application.
316 */
317 boolean requestAssistScreenshot(IAssistScreenshotReceiver receiver);
318
319 /**
Jim Miller4eeb4f62012-11-08 00:04:29 -0800320 * Create a screenshot of the applications currently displayed.
Winson8b1871d2015-11-20 09:56:20 -0800321 *
Filip Gruszczynski64cdc142015-11-29 21:10:07 -0800322 * @param frameScale the scale to apply to the frame, only used when width = -1 and
Winson8b1871d2015-11-20 09:56:20 -0800323 * height = -1
Jim Miller4eeb4f62012-11-08 00:04:29 -0800324 */
Filip Gruszczynski64cdc142015-11-29 21:10:07 -0800325 Bitmap screenshotApplications(IBinder appToken, int displayId, int maxWidth, int maxHeight,
Winson8b1871d2015-11-20 09:56:20 -0800326 float frameScale);
Joe Onorato664644d2011-01-23 17:53:23 -0800327
328 /**
329 * Called by the status bar to notify Views of changes to System UI visiblity.
330 */
John Spurlocke7c28572013-10-29 14:23:51 -0400331 oneway void statusBarVisibilityChanged(int visibility);
Jeff Brown1a84fd12011-06-02 01:26:32 -0700332
333 /**
Winsonab216602016-08-09 14:05:20 -0700334 * Called by System UI to notify of changes to the visibility of Recents.
335 */
336 oneway void setRecentsVisibility(boolean visible);
337
338 /**
339 * Called by System UI to notify of changes to the visibility of PIP.
340 */
341 oneway void setTvPipVisibility(boolean visible);
342
343 /**
Daniel Sandler0c4ccff2011-10-19 16:39:14 -0400344 * Device has a software navigation bar (separate from the status bar).
345 */
346 boolean hasNavigationBar();
Jim Miller93c518e2012-01-17 15:55:31 -0800347
348 /**
Adam Cohenf7522022012-10-03 20:03:18 -0700349 * Lock the device immediately with the specified options (can be null).
Jim Miller93c518e2012-01-17 15:55:31 -0800350 */
Adam Cohenf7522022012-10-03 20:03:18 -0700351 void lockNow(in Bundle options);
Svetoslav Ganovc9c9a482012-07-16 08:46:07 -0700352
353 /**
Jim Millerbfec0a82012-11-05 20:05:22 -0800354 * Device is in safe mode.
355 */
356 boolean isSafeModeEnabled();
Jorim Jaggicff0acb2014-03-31 16:35:15 +0200357
358 /**
359 * Enables the screen if all conditions are met.
360 */
361 void enableScreenIfNeeded();
Svetoslavdd137a82014-04-10 12:48:07 -0700362
363 /**
Svetoslav1376d602014-03-13 11:17:26 -0700364 * Clears the frame statistics for a given window.
365 *
366 * @param token The window token.
367 * @return Whether the frame statistics were cleared.
368 */
369 boolean clearWindowContentFrameStats(IBinder token);
370
371 /**
372 * Gets the content frame statistics for a given window.
373 *
374 * @param token The window token.
375 * @return The frame statistics or null if the window does not exist.
376 */
377 WindowContentFrameStats getWindowContentFrameStats(IBinder token);
Jorim Jaggi61f39a72015-10-29 16:54:18 +0100378
379 /**
380 * @return the dock side the current docked stack is at; must be one of the
381 * WindowManagerGlobal.DOCKED_* values
382 */
383 int getDockedStackSide();
384
385 /**
386 * Sets whether we are currently in a drag resize operation where we are changing the docked
387 * stack size.
388 */
389 void setDockedStackResizing(boolean resizing);
Filip Gruszczynski64cdc142015-11-29 21:10:07 -0800390
391 /**
Jorim Jaggid47e7e12016-03-01 09:57:38 +0100392 * Sets the region the user can touch the divider. This region will be excluded from the region
393 * which is used to cause a focus switch when dispatching touch.
394 */
395 void setDockedStackDividerTouchRegion(in Rect touchableRegion);
396
397 /**
Jorim Jaggia6c934e2015-12-21 13:22:31 +0100398 * Registers a listener that will be called when the dock divider changes its visibility or when
399 * the docked stack gets added/removed.
Filip Gruszczynski64cdc142015-11-29 21:10:07 -0800400 */
Jorim Jaggia6c934e2015-12-21 13:22:31 +0100401 void registerDockedStackListener(IDockedStackListener listener);
Jorim Jaggi50981592015-12-29 17:54:12 +0100402
403 /**
404 * Updates the dim layer used while resizing.
405 *
406 * @param visible Whether the dim layer should be visible.
407 * @param targetStackId The id of the task stack the dim layer should be placed on.
408 * @param alpha The translucency of the dim layer, between 0 and 1.
409 */
410 void setResizeDimLayer(boolean visible, int targetStackId, float alpha);
Clara Bayarri75e09792015-07-29 16:20:40 +0100411
412 /**
413 * Requests Keyboard Shortcuts from the displayed window.
414 *
415 * @param receiver The receiver to deliver the results to.
416 */
Clara Bayarrifcd7e802016-03-10 12:58:18 +0000417 void requestAppKeyboardShortcuts(IResultReceiver receiver, int deviceId);
Jorim Jaggic6c89a82016-01-28 17:48:21 -0800418
419 /**
420 * Retrieves the current stable insets from the primary display.
421 */
422 void getStableInsets(out Rect outInsets);
Muyuan Li94ce94e2016-02-24 16:20:54 -0800423
424 /**
425 * Register shortcut key. Shortcut code is packed as:
426 * (MetaState << Integer.SIZE) | KeyCode
427 * @hide
428 */
429 void registerShortcutKey(in long shortcutCode, IShortcutService keySubscriber);
Vladislav Kaznacheev0d50d862016-03-29 15:43:28 -0700430
431 /**
432 * Create the input consumer for wallpaper events.
433 */
434 void createWallpaperInputConsumer(out InputChannel inputChannel);
435
436 /**
437 * Remove the input consumer for wallpaper events.
438 */
439 void removeWallpaperInputConsumer();
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800440}