1/*
2** Copyright 2006, 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
17package android.view;
18
19import com.android.internal.view.IInputContext;
20import com.android.internal.view.IInputMethodClient;
21
22import android.content.res.CompatibilityInfo;
23import android.content.res.Configuration;
24import android.graphics.Bitmap;
25import android.graphics.Point;
26import android.graphics.Rect;
27import android.os.Bundle;
28import android.os.IRemoteCallback;
29import android.view.IApplicationToken;
30import android.view.IDisplayContentChangeListener;
31import android.view.IOnKeyguardExitResult;
32import android.view.IRotationWatcher;
33import android.view.IWindowSession;
34import android.view.KeyEvent;
35import android.view.InputEvent;
36import android.view.MotionEvent;
37import android.view.InputChannel;
38import android.view.InputDevice;
39import android.view.IInputFilter;
40import android.view.WindowInfo;
41
42/**
43 * System private interface to the window manager.
44 *
45 * {@hide}
46 */
47interface IWindowManager
48{
49    /**
50     * ===== NOTICE =====
51     * The first three methods must remain the first three methods. Scripts
52     * and tools rely on their transaction number to work properly.
53     */
54    // This is used for debugging
55    boolean startViewServer(int port);   // Transaction #1
56    boolean stopViewServer();            // Transaction #2
57    boolean isViewServerRunning();       // Transaction #3
58
59    IWindowSession openSession(in IInputMethodClient client,
60            in IInputContext inputContext);
61    boolean inputMethodClientHasFocus(IInputMethodClient client);
62
63    void setForcedDisplaySize(int displayId, int width, int height);
64    void clearForcedDisplaySize(int displayId);
65    void setForcedDisplayDensity(int displayId, int density);
66    void clearForcedDisplayDensity(int displayId);
67
68    // Is the device configured to have a full system bar for larger screens?
69    boolean hasSystemNavBar();
70
71    // These can only be called when holding the MANAGE_APP_TOKENS permission.
72    void pauseKeyDispatching(IBinder token);
73    void resumeKeyDispatching(IBinder token);
74    void setEventDispatching(boolean enabled);
75    void addWindowToken(IBinder token, int type);
76    void removeWindowToken(IBinder token);
77    void addAppToken(int addPos, IApplicationToken token,
78            int groupId, int requestedOrientation, boolean fullscreen, boolean showWhenLocked);
79    void setAppGroupId(IBinder token, int groupId);
80    void setAppOrientation(IApplicationToken token, int requestedOrientation);
81    int getAppOrientation(IApplicationToken token);
82    void setFocusedApp(IBinder token, boolean moveFocusNow);
83    void prepareAppTransition(int transit, boolean alwaysKeepCurrent);
84    int getPendingAppTransition();
85    void overridePendingAppTransition(String packageName, int enterAnim, int exitAnim,
86            IRemoteCallback startedCallback);
87    void overridePendingAppTransitionScaleUp(int startX, int startY, int startWidth,
88            int startHeight);
89    void overridePendingAppTransitionThumb(in Bitmap srcThumb, int startX, int startY,
90            IRemoteCallback startedCallback, boolean scaleUp);
91    void executeAppTransition();
92    void setAppStartingWindow(IBinder token, String pkg, int theme,
93            in CompatibilityInfo compatInfo, CharSequence nonLocalizedLabel, int labelRes,
94            int icon, int windowFlags, IBinder transferFrom, boolean createIfNeeded);
95    void setAppWillBeHidden(IBinder token);
96    void setAppVisibility(IBinder token, boolean visible);
97    void startAppFreezingScreen(IBinder token, int configChanges);
98    void stopAppFreezingScreen(IBinder token, boolean force);
99    void removeAppToken(IBinder token);
100    void moveAppToken(int index, IBinder token);
101    void moveAppTokensToTop(in List<IBinder> tokens);
102    void moveAppTokensToBottom(in List<IBinder> tokens);
103
104    // Re-evaluate the current orientation from the caller's state.
105    // If there is a change, the new Configuration is returned and the
106    // caller must call setNewConfiguration() sometime later.
107    Configuration updateOrientationFromAppTokens(in Configuration currentConfig,
108            IBinder freezeThisOneIfNeeded);
109    void setNewConfiguration(in Configuration config);
110
111    void startFreezingScreen(int exitAnim, int enterAnim);
112    void stopFreezingScreen();
113
114    // these require DISABLE_KEYGUARD permission
115    void disableKeyguard(IBinder token, String tag);
116    void reenableKeyguard(IBinder token);
117    void exitKeyguardSecurely(IOnKeyguardExitResult callback);
118    boolean isKeyguardLocked();
119    boolean isKeyguardSecure();
120    boolean inKeyguardRestrictedInputMode();
121    void dismissKeyguard();
122
123    void closeSystemDialogs(String reason);
124
125    // These can only be called with the SET_ANIMATON_SCALE permission.
126    float getAnimationScale(int which);
127    float[] getAnimationScales();
128    void setAnimationScale(int which, float scale);
129    void setAnimationScales(in float[] scales);
130
131    // For testing
132    void setInTouchMode(boolean showFocus);
133
134    // For StrictMode flashing a red border on violations from the UI
135    // thread.  The uid/pid is implicit from the Binder call, and the Window
136    // Manager uses that to determine whether or not the red border should
137    // actually be shown.  (it will be ignored that pid doesn't have windows
138    // on screen)
139    void showStrictModeViolation(boolean on);
140
141    // Proxy to set the system property for whether the flashing
142    // should be enabled.  The 'enabled' value is null or blank for
143    // the system default (differs per build variant) or any valid
144    // boolean string as parsed by SystemProperties.getBoolean().
145    void setStrictModeVisualIndicatorPreference(String enabled);
146
147    // These can only be called with the SET_ORIENTATION permission.
148    /**
149     * Update the current screen rotation based on the current state of
150     * the world.
151     * @param alwaysSendConfiguration Flag to force a new configuration to
152     * be evaluated.  This can be used when there are other parameters in
153     * configuration that are changing.
154     * @param forceRelayout If true, the window manager will always do a relayout
155     * of its windows even if the rotation hasn't changed.
156     */
157    void updateRotation(boolean alwaysSendConfiguration, boolean forceRelayout);
158
159    /**
160     * Retrieve the current screen orientation, constants as per
161     * {@link android.view.Surface}.
162     */
163    int getRotation();
164
165    /**
166     * Watch the rotation of the screen.  Returns the current rotation,
167     * calls back when it changes.
168     */
169    int watchRotation(IRotationWatcher watcher);
170
171    /**
172     * Determine the preferred edge of the screen to pin the compact options menu against.
173     * @return a Gravity value for the options menu panel
174     * @hide
175     */
176    int getPreferredOptionsPanelGravity();
177
178    /**
179     * Lock the device orientation to the specified rotation, or to the
180     * current rotation if -1.  Sensor input will be ignored until
181     * thawRotation() is called.
182     * @hide
183     */
184    void freezeRotation(int rotation);
185
186    /**
187     * Release the orientation lock imposed by freezeRotation().
188     * @hide
189     */
190    void thawRotation();
191
192    /**
193     * Create a screenshot of the applications currently displayed.
194     */
195    Bitmap screenshotApplications(IBinder appToken, int displayId, int maxWidth, int maxHeight);
196
197    /**
198     * Called by the status bar to notify Views of changes to System UI visiblity.
199     */
200    void statusBarVisibilityChanged(int visibility);
201
202    /**
203     * Block until the given window has been drawn to the screen.
204     * Returns true if really waiting, false if the window does not exist.
205     */
206    boolean waitForWindowDrawn(IBinder token, in IRemoteCallback callback);
207
208    /**
209     * Device has a software navigation bar (separate from the status bar).
210     */
211    boolean hasNavigationBar();
212
213    /**
214     * Lock the device immediately with the specified options (can be null).
215     */
216    void lockNow(in Bundle options);
217
218    /**
219     * Gets the token for the focused window.
220     */
221    IBinder getFocusedWindowToken();
222
223    /**
224     * Gets the compatibility scale of e window given its token.
225     */
226    float getWindowCompatibilityScale(IBinder windowToken);
227
228    /**
229     * Sets an input filter for manipulating the input event stream.
230     */
231    void setInputFilter(in IInputFilter filter);
232
233    /**
234     * Sets the scale and offset for implementing accessibility magnification.
235     */
236    void magnifyDisplay(int dipslayId, float scale, float offsetX, float offsetY);
237
238    /**
239     * Adds a listener for display content changes.
240     */
241    void addDisplayContentChangeListener(int displayId, IDisplayContentChangeListener listener);
242
243    /**
244     * Removes a listener for display content changes.
245     */
246    void removeDisplayContentChangeListener(int displayId, IDisplayContentChangeListener listener);
247
248    /**
249     * Gets the info for a window given its token.
250     */
251    WindowInfo getWindowInfo(IBinder token);
252
253    /**
254     * Gets the infos for all visible windows.
255     */
256    void getVisibleWindowsForDisplay(int displayId, out List<WindowInfo> outInfos);
257
258    /**
259     * Device is in safe mode.
260     */
261    boolean isSafeModeEnabled();
262
263    /**
264     * Tell keyguard to show the assistant (Intent.ACTION_ASSIST) after asking for the user's
265     * credentials.
266     */
267    void showAssistant();
268}
269