Dianne Hackborn | 7da6ac3 | 2010-12-09 19:22:04 -0800 | [diff] [blame] | 1 | /* |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 2 | ** Copyright 2006, The Android Open Source Project |
| 3 | ** |
Jim Miller | 4eeb4f6 | 2012-11-08 00:04:29 -0800 | [diff] [blame] | 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 |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 7 | ** |
Jim Miller | 4eeb4f6 | 2012-11-08 00:04:29 -0800 | [diff] [blame] | 8 | ** http://www.apache.org/licenses/LICENSE-2.0 |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 9 | ** |
Jim Miller | 4eeb4f6 | 2012-11-08 00:04:29 -0800 | [diff] [blame] | 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 |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 14 | ** limitations under the License. |
| 15 | */ |
| 16 | |
| 17 | package android.view; |
| 18 | |
Dianne Hackborn | 27eac1d | 2015-03-16 17:15:53 -0700 | [diff] [blame] | 19 | import com.android.internal.app.IAssistScreenshotReceiver; |
Clara Bayarri | 75e0979 | 2015-07-29 16:20:40 +0100 | [diff] [blame] | 20 | import com.android.internal.os.IResultReceiver; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 21 | import com.android.internal.view.IInputContext; |
| 22 | import com.android.internal.view.IInputMethodClient; |
Muyuan Li | 94ce94e | 2016-02-24 16:20:54 -0800 | [diff] [blame] | 23 | import com.android.internal.policy.IShortcutService; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 24 | |
Dianne Hackborn | 2f0b175 | 2011-05-31 17:59:49 -0700 | [diff] [blame] | 25 | import android.content.res.CompatibilityInfo; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 26 | import android.content.res.Configuration; |
Dianne Hackborn | 0aae2d4 | 2010-12-07 23:51:29 -0800 | [diff] [blame] | 27 | import android.graphics.Bitmap; |
Dianne Hackborn | ac8dea1 | 2011-04-20 18:18:51 -0700 | [diff] [blame] | 28 | import android.graphics.Point; |
Svetoslav Ganov | c9c9a48 | 2012-07-16 08:46:07 -0700 | [diff] [blame] | 29 | import android.graphics.Rect; |
Adam Cohen | f752202 | 2012-10-03 20:03:18 -0700 | [diff] [blame] | 30 | import android.os.Bundle; |
Dianne Hackborn | 38e29a6 | 2011-09-18 14:43:08 -0700 | [diff] [blame] | 31 | import android.os.IRemoteCallback; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 32 | import android.view.IApplicationToken; |
Jorim Jaggi | 2f7d292 | 2015-10-29 13:08:29 +0100 | [diff] [blame] | 33 | import android.view.IAppTransitionAnimationSpecsFuture; |
Jorim Jaggi | a6c934e | 2015-12-21 13:22:31 +0100 | [diff] [blame] | 34 | import android.view.IDockedStackListener; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 35 | import android.view.IOnKeyguardExitResult; |
| 36 | import android.view.IRotationWatcher; |
| 37 | import android.view.IWindowSession; |
Dianne Hackborn | eb94fa7 | 2014-06-03 17:48:12 -0700 | [diff] [blame] | 38 | import android.view.IWindowSessionCallback; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 39 | import android.view.KeyEvent; |
Jeff Brown | 6ec402b | 2010-07-28 15:48:59 -0700 | [diff] [blame] | 40 | import android.view.InputEvent; |
Svetoslav Ganov | 152e9bb | 2012-10-12 20:15:29 -0700 | [diff] [blame] | 41 | import android.view.MagnificationSpec; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 42 | import android.view.MotionEvent; |
Jeff Brown | a41ca77 | 2010-08-11 14:46:32 -0700 | [diff] [blame] | 43 | import android.view.InputChannel; |
Jeff Brown | 8d60866 | 2010-08-30 03:02:23 -0700 | [diff] [blame] | 44 | import android.view.InputDevice; |
Svetoslav Ganov | 1cf70bb | 2012-08-06 10:53:34 -0700 | [diff] [blame] | 45 | import android.view.IInputFilter; |
Filip Gruszczynski | 170192a | 2015-08-16 17:46:34 -0700 | [diff] [blame] | 46 | import android.view.AppTransitionAnimationSpec; |
Svetoslav | 1376d60 | 2014-03-13 11:17:26 -0700 | [diff] [blame] | 47 | import android.view.WindowContentFrameStats; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 48 | |
| 49 | /** |
| 50 | * System private interface to the window manager. |
| 51 | * |
| 52 | * {@hide} |
| 53 | */ |
| 54 | interface 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 Hackborn | eb94fa7 | 2014-06-03 17:48:12 -0700 | [diff] [blame] | 66 | IWindowSession openSession(in IWindowSessionCallback callback, in IInputMethodClient client, |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 67 | in IInputContext inputContext); |
| 68 | boolean inputMethodClientHasFocus(IInputMethodClient client); |
Dianne Hackborn | ac8dea1 | 2011-04-20 18:18:51 -0700 | [diff] [blame] | 69 | |
Dianne Hackborn | 672cf45 | 2013-03-26 15:24:24 -0700 | [diff] [blame] | 70 | void getInitialDisplaySize(int displayId, out Point size); |
| 71 | void getBaseDisplaySize(int displayId, out Point size); |
Jeff Brown | 43aa159 | 2012-09-10 17:36:31 -0700 | [diff] [blame] | 72 | void setForcedDisplaySize(int displayId, int width, int height); |
Craig Mautner | 59c0097 | 2012-07-30 12:10:24 -0700 | [diff] [blame] | 73 | void clearForcedDisplaySize(int displayId); |
Dianne Hackborn | 672cf45 | 2013-03-26 15:24:24 -0700 | [diff] [blame] | 74 | int getInitialDisplayDensity(int displayId); |
| 75 | int getBaseDisplayDensity(int displayId); |
Alan Viverette | df3a7ca | 2016-09-06 17:13:41 -0400 | [diff] [blame] | 76 | void setForcedDisplayDensityForUser(int displayId, int density, int userId); |
| 77 | void clearForcedDisplayDensityForUser(int displayId, int userId); |
Jeff Brown | d46747a | 2015-04-15 19:02:36 -0700 | [diff] [blame] | 78 | void setForcedDisplayScalingMode(int displayId, int mode); // 0 = auto, 1 = disable |
Dianne Hackborn | 7916ac6 | 2011-05-16 20:45:48 -0700 | [diff] [blame] | 79 | |
Dianne Hackborn | c652de8 | 2013-02-15 16:32:56 -0800 | [diff] [blame] | 80 | void setOverscan(int displayId, int left, int top, int right, int bottom); |
| 81 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 82 | // 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 Hackborn | e4fbd62 | 2009-03-27 18:09:16 -0700 | [diff] [blame] | 86 | void addWindowToken(IBinder token, int type); |
| 87 | void removeWindowToken(IBinder token); |
Wale Ogunwale | 706ed79 | 2015-08-02 10:29:44 -0700 | [diff] [blame] | 88 | /** |
| 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 Gruszczynski | ebcc875 | 2015-08-25 16:51:05 -0700 | [diff] [blame] | 104 | * @param configuration Configuration that is being used with this task. |
Wale Ogunwale | b1faf60 | 2016-01-27 09:12:31 -0800 | [diff] [blame] | 105 | * @param taskResizeMode The resize mode of the task. |
Wale Ogunwale | 6cae765 | 2015-12-26 07:36:26 -0800 | [diff] [blame] | 106 | * @param alwaysFocusable True if the app windows are always focusable regardless of the stack |
| 107 | * they are in. |
Wale Ogunwale | b1faf60 | 2016-01-27 09:12:31 -0800 | [diff] [blame] | 108 | * @param homeTask True if this is the task. |
Yorke Lee | 0e85247 | 2016-06-15 10:03:18 -0700 | [diff] [blame] | 109 | * @param targetSdkVersion The application's target SDK version |
Wale Ogunwale | 706ed79 | 2015-08-02 10:29:44 -0700 | [diff] [blame] | 110 | */ |
Filip Gruszczynski | ebcc875 | 2015-08-25 16:51:05 -0700 | [diff] [blame] | 111 | void addAppToken(int addPos, IApplicationToken token, int taskId, int stackId, |
Craig Mautner | 5d9f547 | 2013-11-12 14:02:52 -0800 | [diff] [blame] | 112 | int requestedOrientation, boolean fullscreen, boolean showWhenLocked, int userId, |
Wale Ogunwale | 706ed79 | 2015-08-02 10:29:44 -0700 | [diff] [blame] | 113 | int configChanges, boolean voiceInteraction, boolean launchTaskBehind, |
Wale Ogunwale | b1faf60 | 2016-01-27 09:12:31 -0800 | [diff] [blame] | 114 | in Rect taskBounds, in Configuration configuration, int taskResizeMode, |
Robert Carr | fd10cd1 | 2016-06-29 16:41:50 -0700 | [diff] [blame] | 115 | boolean alwaysFocusable, boolean homeTask, int targetSdkVersion, int rotationAnimationHint); |
Wale Ogunwale | 706ed79 | 2015-08-02 10:29:44 -0700 | [diff] [blame] | 116 | /** |
| 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 Ogunwale | 2998eef | 2015-12-02 19:46:29 -0800 | [diff] [blame] | 120 | * @param stackId Stack Id to create a new Task with the input task Id on |
| 121 | * if the task doesn't exist yet. |
Wale Ogunwale | 706ed79 | 2015-08-02 10:29:44 -0700 | [diff] [blame] | 122 | * @param taskBounds Bounds to use when creating a new Task with the input task Id if |
| 123 | * the task doesn't exist yet. |
Filip Gruszczynski | ebcc875 | 2015-08-25 16:51:05 -0700 | [diff] [blame] | 124 | * @param config Configuration that is being used with this task. |
Wale Ogunwale | b1faf60 | 2016-01-27 09:12:31 -0800 | [diff] [blame] | 125 | * @param taskResizeMode The resize mode of the task. |
| 126 | * @param homeTask True if this is the task. |
Wale Ogunwale | 706ed79 | 2015-08-02 10:29:44 -0700 | [diff] [blame] | 127 | */ |
Wale Ogunwale | b1faf60 | 2016-01-27 09:12:31 -0800 | [diff] [blame] | 128 | void setAppTask(IBinder token, int taskId, int stackId, in Rect taskBounds, |
| 129 | in Configuration config, int taskResizeMode, boolean homeTask); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 130 | void setAppOrientation(IApplicationToken token, int requestedOrientation); |
| 131 | int getAppOrientation(IApplicationToken token); |
| 132 | void setFocusedApp(IBinder token, boolean moveFocusNow); |
Dianne Hackborn | 7da6ac3 | 2010-12-09 19:22:04 -0800 | [diff] [blame] | 133 | void prepareAppTransition(int transit, boolean alwaysKeepCurrent); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 134 | int getPendingAppTransition(); |
Dianne Hackborn | 8437587 | 2012-06-01 19:03:50 -0700 | [diff] [blame] | 135 | void overridePendingAppTransition(String packageName, int enterAnim, int exitAnim, |
| 136 | IRemoteCallback startedCallback); |
Dianne Hackborn | eabfb3a | 2012-04-16 16:28:22 -0700 | [diff] [blame] | 137 | void overridePendingAppTransitionScaleUp(int startX, int startY, int startWidth, |
| 138 | int startHeight); |
Chet Haase | 10e23ab | 2015-02-11 15:08:38 -0800 | [diff] [blame] | 139 | void overridePendingAppTransitionClipReveal(int startX, int startY, |
| 140 | int startWidth, int startHeight); |
Dianne Hackborn | 8078d8c | 2012-03-20 11:11:26 -0700 | [diff] [blame] | 141 | void overridePendingAppTransitionThumb(in Bitmap srcThumb, int startX, int startY, |
Michael Jurka | 832cb22 | 2012-04-13 09:32:47 -0700 | [diff] [blame] | 142 | IRemoteCallback startedCallback, boolean scaleUp); |
Winson Chung | a4ccb86 | 2014-08-22 15:26:27 -0700 | [diff] [blame] | 143 | void overridePendingAppTransitionAspectScaledThumb(in Bitmap srcThumb, int startX, |
Winson Chung | 2e7f3bd | 2014-09-05 13:17:22 +0200 | [diff] [blame] | 144 | int startY, int targetWidth, int targetHeight, IRemoteCallback startedCallback, |
| 145 | boolean scaleUp); |
Filip Gruszczynski | 170192a | 2015-08-16 17:46:34 -0700 | [diff] [blame] | 146 | /** |
| 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 Gruszczynski | 1a5203d | 2015-10-29 17:43:49 -0700 | [diff] [blame] | 155 | IRemoteCallback startedCallback, IRemoteCallback finishedCallback, boolean scaleUp); |
Winson Chung | 044d529 | 2014-11-06 11:05:19 -0800 | [diff] [blame] | 156 | void overridePendingAppTransitionInPlace(String packageName, int anim); |
Jorim Jaggi | 2f7d292 | 2015-10-29 13:08:29 +0100 | [diff] [blame] | 157 | |
| 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 Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 166 | void executeAppTransition(); |
Wale Ogunwale | 3b23239 | 2016-05-13 15:37:13 -0700 | [diff] [blame] | 167 | |
| 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 Hackborn | 2f0b175 | 2011-05-31 17:59:49 -0700 | [diff] [blame] | 173 | in CompatibilityInfo compatInfo, CharSequence nonLocalizedLabel, int labelRes, |
Adam Powell | 04fe6eb | 2013-05-31 14:39:48 -0700 | [diff] [blame] | 174 | int icon, int logo, int windowFlags, IBinder transferFrom, boolean createIfNeeded); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 175 | void setAppVisibility(IBinder token, boolean visible); |
Chong Zhang | 813be13 | 2016-08-25 12:12:33 -0700 | [diff] [blame] | 176 | void notifyAppResumed(IBinder token, boolean wasStopped, boolean allowSavedSurface); |
Chong Zhang | 45e6d2d | 2016-07-20 18:33:56 -0700 | [diff] [blame] | 177 | void notifyAppStopped(IBinder token); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 178 | void startAppFreezingScreen(IBinder token, int configChanges); |
| 179 | void stopAppFreezingScreen(IBinder token, boolean force); |
| 180 | void removeAppToken(IBinder token); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 181 | |
Filip Gruszczynski | 14b4e57 | 2015-11-03 15:53:55 -0800 | [diff] [blame] | 182 | /** Used by system ui to report that recents has shown itself. */ |
| 183 | void endProlongedAnimations(); |
| 184 | |
Dianne Hackborn | e36d6e2 | 2010-02-17 19:46:25 -0800 | [diff] [blame] | 185 | // 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 Zhang | 167bbfac | 2016-03-31 09:44:34 -0700 | [diff] [blame] | 190 | // 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 Miller | 4eeb4f6 | 2012-11-08 00:04:29 -0800 | [diff] [blame] | 196 | |
Dianne Hackborn | 9d9ece3 | 2012-09-10 15:33:52 -0700 | [diff] [blame] | 197 | void startFreezingScreen(int exitAnim, int enterAnim); |
| 198 | void stopFreezingScreen(); |
| 199 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 200 | // these require DISABLE_KEYGUARD permission |
| 201 | void disableKeyguard(IBinder token, String tag); |
| 202 | void reenableKeyguard(IBinder token); |
| 203 | void exitKeyguardSecurely(IOnKeyguardExitResult callback); |
Mike Lockwood | 520d8bc | 2011-02-18 13:23:13 -0500 | [diff] [blame] | 204 | boolean isKeyguardLocked(); |
| 205 | boolean isKeyguardSecure(); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 206 | boolean inKeyguardRestrictedInputMode(); |
Dianne Hackborn | 90c52de | 2011-09-23 12:57:44 -0700 | [diff] [blame] | 207 | void dismissKeyguard(); |
Adrian Roos | d5c2db6 | 2016-03-08 16:11:31 -0800 | [diff] [blame] | 208 | void keyguardGoingAway(int flags); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 209 | |
Dianne Hackborn | ffa4248 | 2009-09-23 22:20:11 -0700 | [diff] [blame] | 210 | void closeSystemDialogs(String reason); |
Jim Miller | 4eeb4f6 | 2012-11-08 00:04:29 -0800 | [diff] [blame] | 211 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 212 | // 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 Miller | 4eeb4f6 | 2012-11-08 00:04:29 -0800 | [diff] [blame] | 217 | |
Dianne Hackborn | eb94fa7 | 2014-06-03 17:48:12 -0700 | [diff] [blame] | 218 | float getCurrentAnimatorScale(); |
| 219 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 220 | // For testing |
| 221 | void setInTouchMode(boolean showFocus); |
Brad Fitzpatrick | 6804433 | 2010-11-22 18:19:48 -0800 | [diff] [blame] | 222 | |
| 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 Fitzpatrick | c1a968a | 2010-11-24 08:56:40 -0800 | [diff] [blame] | 230 | // 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 Alewijnse | d2a1eec | 2014-07-09 12:57:05 +0100 | [diff] [blame] | 236 | /** |
Sander Alewijnse | a87863a | 2014-07-29 12:01:38 +0100 | [diff] [blame] | 237 | * Set whether screen capture is disabled for all windows of a specific user |
Sander Alewijnse | d2a1eec | 2014-07-09 12:57:05 +0100 | [diff] [blame] | 238 | */ |
Sander Alewijnse | a87863a | 2014-07-29 12:01:38 +0100 | [diff] [blame] | 239 | void setScreenCaptureDisabled(int userId, boolean disabled); |
Sander Alewijnse | d2a1eec | 2014-07-09 12:57:05 +0100 | [diff] [blame] | 240 | |
Winson | c28098f | 2015-10-30 14:50:19 -0700 | [diff] [blame] | 241 | /** |
| 242 | * Cancels the window transitions for the given task. |
| 243 | */ |
| 244 | void cancelTaskWindowTransition(int taskId); |
| 245 | |
Winson | 13d3066 | 2015-11-06 15:30:29 -0800 | [diff] [blame] | 246 | /** |
| 247 | * Cancels the thumbnail transitions for the given task. |
| 248 | */ |
| 249 | void cancelTaskThumbnailTransition(int taskId); |
| 250 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 251 | // These can only be called with the SET_ORIENTATION permission. |
| 252 | /** |
Jeff Brown | 01a98dd | 2011-09-20 15:08:29 -0700 | [diff] [blame] | 253 | * Update the current screen rotation based on the current state of |
| 254 | * the world. |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 255 | * @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 Hackborn | f87d196 | 2012-04-04 12:48:24 -0700 | [diff] [blame] | 258 | * @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 Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 260 | */ |
Dianne Hackborn | f87d196 | 2012-04-04 12:48:24 -0700 | [diff] [blame] | 261 | void updateRotation(boolean alwaysSendConfiguration, boolean forceRelayout); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 262 | |
| 263 | /** |
| 264 | * Retrieve the current screen orientation, constants as per |
| 265 | * {@link android.view.Surface}. |
| 266 | */ |
| 267 | int getRotation(); |
Jim Miller | 4eeb4f6 | 2012-11-08 00:04:29 -0800 | [diff] [blame] | 268 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 269 | /** |
| 270 | * Watch the rotation of the screen. Returns the current rotation, |
| 271 | * calls back when it changes. |
| 272 | */ |
| 273 | int watchRotation(IRotationWatcher watcher); |
Daniel Sandler | b73617d | 2010-08-17 00:41:00 -0400 | [diff] [blame] | 274 | |
Adam Powell | dfee59a | 2011-08-05 20:48:30 -0700 | [diff] [blame] | 275 | /** |
Brian Colonna | b1b9a8a | 2013-03-29 11:52:42 -0400 | [diff] [blame] | 276 | * Remove a rotation watcher set using watchRotation. |
| 277 | * @hide |
| 278 | */ |
| 279 | void removeRotationWatcher(IRotationWatcher watcher); |
| 280 | |
| 281 | /** |
Adam Powell | dfee59a | 2011-08-05 20:48:30 -0700 | [diff] [blame] | 282 | * 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 Miller | 4eeb4f6 | 2012-11-08 00:04:29 -0800 | [diff] [blame] | 288 | /** |
| 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 Sandler | b73617d | 2010-08-17 00:41:00 -0400 | [diff] [blame] | 295 | |
Jim Miller | 4eeb4f6 | 2012-11-08 00:04:29 -0800 | [diff] [blame] | 296 | /** |
| 297 | * Release the orientation lock imposed by freezeRotation(). |
| 298 | * @hide |
| 299 | */ |
| 300 | void thawRotation(); |
Dianne Hackborn | 0aae2d4 | 2010-12-07 23:51:29 -0800 | [diff] [blame] | 301 | |
Jim Miller | 4eeb4f6 | 2012-11-08 00:04:29 -0800 | [diff] [blame] | 302 | /** |
Svetoslav | 8e3feb1 | 2014-02-24 13:46:47 -0800 | [diff] [blame] | 303 | * Gets whether the rotation is frozen. |
Svetoslav Ganov | 80943d8 | 2013-01-02 10:25:37 -0800 | [diff] [blame] | 304 | * |
| 305 | * @return Whether the rotation is frozen. |
| 306 | */ |
| 307 | boolean isRotationFrozen(); |
| 308 | |
| 309 | /** |
Zak Cohen | 3683fb1 | 2016-07-11 19:47:37 +0100 | [diff] [blame] | 310 | * Screenshot the current wallpaper layer, including the whole screen. |
| 311 | */ |
| 312 | Bitmap screenshotWallpaper(); |
| 313 | |
| 314 | /** |
Dianne Hackborn | 27eac1d | 2015-03-16 17:15:53 -0700 | [diff] [blame] | 315 | * Used only for assist -- request a screenshot of the current application. |
| 316 | */ |
| 317 | boolean requestAssistScreenshot(IAssistScreenshotReceiver receiver); |
| 318 | |
| 319 | /** |
Jim Miller | 4eeb4f6 | 2012-11-08 00:04:29 -0800 | [diff] [blame] | 320 | * Create a screenshot of the applications currently displayed. |
Winson | 8b1871d | 2015-11-20 09:56:20 -0800 | [diff] [blame] | 321 | * |
Filip Gruszczynski | 64cdc14 | 2015-11-29 21:10:07 -0800 | [diff] [blame] | 322 | * @param frameScale the scale to apply to the frame, only used when width = -1 and |
Winson | 8b1871d | 2015-11-20 09:56:20 -0800 | [diff] [blame] | 323 | * height = -1 |
Jim Miller | 4eeb4f6 | 2012-11-08 00:04:29 -0800 | [diff] [blame] | 324 | */ |
Filip Gruszczynski | 64cdc14 | 2015-11-29 21:10:07 -0800 | [diff] [blame] | 325 | Bitmap screenshotApplications(IBinder appToken, int displayId, int maxWidth, int maxHeight, |
Winson | 8b1871d | 2015-11-20 09:56:20 -0800 | [diff] [blame] | 326 | float frameScale); |
Joe Onorato | 664644d | 2011-01-23 17:53:23 -0800 | [diff] [blame] | 327 | |
| 328 | /** |
| 329 | * Called by the status bar to notify Views of changes to System UI visiblity. |
| 330 | */ |
John Spurlock | e7c2857 | 2013-10-29 14:23:51 -0400 | [diff] [blame] | 331 | oneway void statusBarVisibilityChanged(int visibility); |
Jeff Brown | 1a84fd1 | 2011-06-02 01:26:32 -0700 | [diff] [blame] | 332 | |
| 333 | /** |
Winson | ab21660 | 2016-08-09 14:05:20 -0700 | [diff] [blame^] | 334 | * 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 Sandler | 0c4ccff | 2011-10-19 16:39:14 -0400 | [diff] [blame] | 344 | * Device has a software navigation bar (separate from the status bar). |
| 345 | */ |
| 346 | boolean hasNavigationBar(); |
Jim Miller | 93c518e | 2012-01-17 15:55:31 -0800 | [diff] [blame] | 347 | |
| 348 | /** |
Adam Cohen | f752202 | 2012-10-03 20:03:18 -0700 | [diff] [blame] | 349 | * Lock the device immediately with the specified options (can be null). |
Jim Miller | 93c518e | 2012-01-17 15:55:31 -0800 | [diff] [blame] | 350 | */ |
Adam Cohen | f752202 | 2012-10-03 20:03:18 -0700 | [diff] [blame] | 351 | void lockNow(in Bundle options); |
Svetoslav Ganov | c9c9a48 | 2012-07-16 08:46:07 -0700 | [diff] [blame] | 352 | |
| 353 | /** |
Jim Miller | bfec0a8 | 2012-11-05 20:05:22 -0800 | [diff] [blame] | 354 | * Device is in safe mode. |
| 355 | */ |
| 356 | boolean isSafeModeEnabled(); |
Jorim Jaggi | cff0acb | 2014-03-31 16:35:15 +0200 | [diff] [blame] | 357 | |
| 358 | /** |
| 359 | * Enables the screen if all conditions are met. |
| 360 | */ |
| 361 | void enableScreenIfNeeded(); |
Svetoslav | dd137a8 | 2014-04-10 12:48:07 -0700 | [diff] [blame] | 362 | |
| 363 | /** |
Svetoslav | 1376d60 | 2014-03-13 11:17:26 -0700 | [diff] [blame] | 364 | * 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 Jaggi | 61f39a7 | 2015-10-29 16:54:18 +0100 | [diff] [blame] | 378 | |
| 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 Gruszczynski | 64cdc14 | 2015-11-29 21:10:07 -0800 | [diff] [blame] | 390 | |
| 391 | /** |
Jorim Jaggi | d47e7e1 | 2016-03-01 09:57:38 +0100 | [diff] [blame] | 392 | * 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 Jaggi | a6c934e | 2015-12-21 13:22:31 +0100 | [diff] [blame] | 398 | * Registers a listener that will be called when the dock divider changes its visibility or when |
| 399 | * the docked stack gets added/removed. |
Filip Gruszczynski | 64cdc14 | 2015-11-29 21:10:07 -0800 | [diff] [blame] | 400 | */ |
Jorim Jaggi | a6c934e | 2015-12-21 13:22:31 +0100 | [diff] [blame] | 401 | void registerDockedStackListener(IDockedStackListener listener); |
Jorim Jaggi | 5098159 | 2015-12-29 17:54:12 +0100 | [diff] [blame] | 402 | |
| 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 Bayarri | 75e0979 | 2015-07-29 16:20:40 +0100 | [diff] [blame] | 411 | |
| 412 | /** |
| 413 | * Requests Keyboard Shortcuts from the displayed window. |
| 414 | * |
| 415 | * @param receiver The receiver to deliver the results to. |
| 416 | */ |
Clara Bayarri | fcd7e80 | 2016-03-10 12:58:18 +0000 | [diff] [blame] | 417 | void requestAppKeyboardShortcuts(IResultReceiver receiver, int deviceId); |
Jorim Jaggi | c6c89a8 | 2016-01-28 17:48:21 -0800 | [diff] [blame] | 418 | |
| 419 | /** |
| 420 | * Retrieves the current stable insets from the primary display. |
| 421 | */ |
| 422 | void getStableInsets(out Rect outInsets); |
Muyuan Li | 94ce94e | 2016-02-24 16:20:54 -0800 | [diff] [blame] | 423 | |
| 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 Kaznacheev | 0d50d86 | 2016-03-29 15:43:28 -0700 | [diff] [blame] | 430 | |
| 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 Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 440 | } |