| /* |
| * Copyright (C) 2017 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.server.wm; |
| |
| import android.annotation.NonNull; |
| import android.annotation.Nullable; |
| import android.content.ClipData; |
| import android.graphics.Rect; |
| import android.graphics.Region; |
| import android.hardware.display.DisplayManagerInternal; |
| import android.os.IBinder; |
| import android.view.Display; |
| import android.view.IInputFilter; |
| import android.view.IWindow; |
| import android.view.InputChannel; |
| import android.view.MagnificationSpec; |
| import android.view.WindowInfo; |
| |
| import com.android.server.input.InputManagerService; |
| import com.android.server.policy.WindowManagerPolicy; |
| |
| import java.util.List; |
| |
| /** |
| * Window manager local system service interface. |
| * |
| * @hide Only for use within the system server. |
| */ |
| public abstract class WindowManagerInternal { |
| |
| /** |
| * Interface to receive a callback when the windows reported for |
| * accessibility changed. |
| */ |
| public interface WindowsForAccessibilityCallback { |
| |
| /** |
| * Called when the windows for accessibility changed. |
| * |
| * @param windows The windows for accessibility. |
| */ |
| public void onWindowsForAccessibilityChanged(List<WindowInfo> windows); |
| } |
| |
| /** |
| * Callbacks for contextual changes that affect the screen magnification |
| * feature. |
| */ |
| public interface MagnificationCallbacks { |
| |
| /** |
| * Called when the region where magnification operates changes. Note that this isn't the |
| * entire screen. For example, IMEs are not magnified. |
| * |
| * @param magnificationRegion the current magnification region |
| */ |
| public void onMagnificationRegionChanged(Region magnificationRegion); |
| |
| /** |
| * Called when an application requests a rectangle on the screen to allow |
| * the client to apply the appropriate pan and scale. |
| * |
| * @param left The rectangle left. |
| * @param top The rectangle top. |
| * @param right The rectangle right. |
| * @param bottom The rectangle bottom. |
| */ |
| public void onRectangleOnScreenRequested(int left, int top, int right, int bottom); |
| |
| /** |
| * Notifies that the rotation changed. |
| * |
| * @param rotation The current rotation. |
| */ |
| public void onRotationChanged(int rotation); |
| |
| /** |
| * Notifies that the context of the user changed. For example, an application |
| * was started. |
| */ |
| public void onUserContextChanged(); |
| } |
| |
| /** |
| * Abstract class to be notified about {@link com.android.server.wm.AppTransition} events. Held |
| * as an abstract class so a listener only needs to implement the methods of its interest. |
| */ |
| public static abstract class AppTransitionListener { |
| |
| /** |
| * Called when an app transition is being setup and about to be executed. |
| */ |
| public void onAppTransitionPendingLocked() {} |
| |
| /** |
| * Called when a pending app transition gets cancelled. |
| * |
| * @param transit transition type indicating what kind of transition got cancelled |
| */ |
| public void onAppTransitionCancelledLocked(int transit) {} |
| |
| /** |
| * Called when an app transition gets started |
| * |
| * @param transit transition type indicating what kind of transition gets run, must be one |
| * of AppTransition.TRANSIT_* values |
| * @param duration the total duration of the transition |
| * @param statusBarAnimationStartTime the desired start time for all visual animations in |
| * the status bar caused by this app transition in uptime millis |
| * @param statusBarAnimationDuration the duration for all visual animations in the status |
| * bar caused by this app transition in millis |
| * |
| * @return Return any bit set of {@link WindowManagerPolicy#FINISH_LAYOUT_REDO_LAYOUT}, |
| * {@link WindowManagerPolicy#FINISH_LAYOUT_REDO_CONFIG}, |
| * {@link WindowManagerPolicy#FINISH_LAYOUT_REDO_WALLPAPER}, |
| * or {@link WindowManagerPolicy#FINISH_LAYOUT_REDO_ANIM}. |
| */ |
| public int onAppTransitionStartingLocked(int transit, long duration, |
| long statusBarAnimationStartTime, long statusBarAnimationDuration) { |
| return 0; |
| } |
| |
| /** |
| * Called when an app transition is finished running. |
| * |
| * @param token the token for app whose transition has finished |
| */ |
| public void onAppTransitionFinishedLocked(IBinder token) {} |
| } |
| |
| /** |
| * An interface to be notified about hardware keyboard status. |
| */ |
| public interface OnHardKeyboardStatusChangeListener { |
| public void onHardKeyboardStatusChange(boolean available); |
| } |
| |
| /** |
| * An interface to customize drag and drop behaviors. |
| */ |
| public interface IDragDropCallback { |
| default boolean registerInputChannel( |
| DragState state, Display display, InputManagerService service, |
| InputChannel source) { |
| state.mTransferTouchFromToken = source.getToken(); |
| state.register(display); |
| return true; |
| } |
| |
| /** |
| * Called when drag operation is starting. |
| */ |
| default boolean prePerformDrag(IWindow window, IBinder dragToken, |
| int touchSource, float touchX, float touchY, float thumbCenterX, float thumbCenterY, |
| ClipData data) { |
| return true; |
| } |
| |
| /** |
| * Called when drag operation is started. |
| */ |
| default void postPerformDrag() {} |
| |
| /** |
| * Called when drop result is being reported. |
| */ |
| default void preReportDropResult(IWindow window, boolean consumed) {} |
| |
| /** |
| * Called when drop result was reported. |
| */ |
| default void postReportDropResult() {} |
| |
| /** |
| * Called when drag operation is being cancelled. |
| */ |
| default void preCancelDragAndDrop(IBinder dragToken) {} |
| |
| /** |
| * Called when drag operation was cancelled. |
| */ |
| default void postCancelDragAndDrop() {} |
| } |
| |
| /** |
| * Request that the window manager call |
| * {@link DisplayManagerInternal#performTraversalInTransactionFromWindowManager} |
| * within a surface transaction at a later time. |
| */ |
| public abstract void requestTraversalFromDisplayManager(); |
| |
| /** |
| * Set by the accessibility layer to observe changes in the magnified region, |
| * rotation, and other window transformations related to display magnification |
| * as the window manager is responsible for doing the actual magnification |
| * and has access to the raw window data while the accessibility layer serves |
| * as a controller. |
| * |
| * @param displayId The logical display id. |
| * @param callbacks The callbacks to invoke. |
| * @return {@code false} if display id is not valid. |
| */ |
| public abstract boolean setMagnificationCallbacks(int displayId, |
| @Nullable MagnificationCallbacks callbacks); |
| |
| /** |
| * Set by the accessibility layer to specify the magnification and panning to |
| * be applied to all windows that should be magnified. |
| * |
| * @param displayId The logical display id. |
| * @param spec The MagnficationSpec to set. |
| * |
| * @see #setMagnificationCallbacks(int, MagnificationCallbacks) |
| */ |
| public abstract void setMagnificationSpec(int displayId, MagnificationSpec spec); |
| |
| /** |
| * Set by the accessibility framework to indicate whether the magnifiable regions of the display |
| * should be shown. |
| * |
| * @param displayId The logical display id. |
| * @param show {@code true} to show magnifiable region bounds, {@code false} to hide |
| */ |
| public abstract void setForceShowMagnifiableBounds(int displayId, boolean show); |
| |
| /** |
| * Obtains the magnification regions. |
| * |
| * @param displayId The logical display id. |
| * @param magnificationRegion the current magnification region |
| */ |
| public abstract void getMagnificationRegion(int displayId, @NonNull Region magnificationRegion); |
| |
| /** |
| * Gets the magnification and translation applied to a window given its token. |
| * Not all windows are magnified and the window manager policy determines which |
| * windows are magnified. The returned result also takes into account the compat |
| * scale if necessary. |
| * |
| * @param windowToken The window's token. |
| * |
| * @return The magnification spec for the window. |
| * |
| * @see #setMagnificationCallbacks(int, MagnificationCallbacks) |
| */ |
| public abstract MagnificationSpec getCompatibleMagnificationSpecForWindow( |
| IBinder windowToken); |
| |
| /** |
| * Sets a callback for observing which windows are touchable for the purposes |
| * of accessibility. |
| * |
| * @param callback The callback. |
| */ |
| public abstract void setWindowsForAccessibilityCallback( |
| WindowsForAccessibilityCallback callback); |
| |
| /** |
| * Sets a filter for manipulating the input event stream. |
| * |
| * @param filter The filter implementation. |
| */ |
| public abstract void setInputFilter(IInputFilter filter); |
| |
| /** |
| * Gets the token of the window that has input focus. |
| * |
| * @return The token. |
| */ |
| public abstract IBinder getFocusedWindowToken(); |
| |
| /** |
| * @return Whether the keyguard is engaged. |
| */ |
| public abstract boolean isKeyguardLocked(); |
| |
| /** |
| * @return Whether the keyguard is showing and not occluded. |
| */ |
| public abstract boolean isKeyguardShowingAndNotOccluded(); |
| |
| /** |
| * Gets the frame of a window given its token. |
| * |
| * @param token The token. |
| * @param outBounds The frame to populate. |
| */ |
| public abstract void getWindowFrame(IBinder token, Rect outBounds); |
| |
| /** |
| * Opens the global actions dialog. |
| */ |
| public abstract void showGlobalActions(); |
| |
| /** |
| * Invalidate all visible windows. Then report back on the callback once all windows have |
| * redrawn. |
| */ |
| public abstract void waitForAllWindowsDrawn(Runnable callback, long timeout); |
| |
| /** |
| * Overrides the display size. |
| * |
| * @param displayId The display to override the display size. |
| * @param width The width to override. |
| * @param height The height to override. |
| */ |
| public abstract void setForcedDisplaySize(int displayId, int width, int height); |
| |
| /** |
| * Recover the display size to real display size. |
| * |
| * @param displayId The display to recover the display size. |
| */ |
| public abstract void clearForcedDisplaySize(int displayId); |
| |
| /** |
| * Adds a window token for a given window type. |
| * |
| * @param token The token to add. |
| * @param type The window type. |
| * @param displayId The display to add the token to. |
| */ |
| public abstract void addWindowToken(android.os.IBinder token, int type, int displayId); |
| |
| /** |
| * Removes a window token. |
| * |
| * @param token The toke to remove. |
| * @param removeWindows Whether to also remove the windows associated with the token. |
| * @param displayId The display to remove the token from. |
| */ |
| public abstract void removeWindowToken(android.os.IBinder token, boolean removeWindows, |
| int displayId); |
| |
| /** |
| * Registers a listener to be notified about app transition events. |
| * |
| * @param listener The listener to register. |
| */ |
| public abstract void registerAppTransitionListener(AppTransitionListener listener); |
| |
| /** |
| * Reports that the password for the given user has changed. |
| */ |
| public abstract void reportPasswordChanged(int userId); |
| |
| /** |
| * Retrieves a height of input method window for given display. |
| */ |
| public abstract int getInputMethodWindowVisibleHeight(int displayId); |
| |
| /** |
| * Notifies WindowManagerService that the current IME window status is being changed. |
| * |
| * <p>Only {@link com.android.server.inputmethod.InputMethodManagerService} is the expected and |
| * tested caller of this method.</p> |
| * |
| * @param imeToken token to track the active input method. Corresponding IME windows can be |
| * identified by checking {@link android.view.WindowManager.LayoutParams#token}. |
| * Note that there is no guarantee that the corresponding window is already |
| * created |
| * @param imeWindowVisible whether the active IME thinks that its window should be visible or |
| * hidden, no matter how WindowManagerService will react / has reacted |
| * to corresponding API calls. Note that this state is not guaranteed |
| * to be synchronized with state in WindowManagerService. |
| * @param dismissImeOnBackKeyPressed {@code true} if the software keyboard is shown and the back |
| * key is expected to dismiss the software keyboard. |
| */ |
| public abstract void updateInputMethodWindowStatus(@NonNull IBinder imeToken, |
| boolean imeWindowVisible, boolean dismissImeOnBackKeyPressed); |
| |
| /** |
| * Notifies WindowManagerService that the current IME window status is being changed. |
| * |
| * <p>Only {@link com.android.server.inputmethod.InputMethodManagerService} is the expected and |
| * tested caller of this method.</p> |
| * |
| * @param imeToken token to track the active input method. Corresponding IME windows can be |
| * identified by checking {@link android.view.WindowManager.LayoutParams#token}. |
| * Note that there is no guarantee that the corresponding window is already |
| * created |
| * @param imeTargetWindowToken token to identify the target window that the IME is associated |
| * with |
| */ |
| public abstract void updateInputMethodTargetWindow(@NonNull IBinder imeToken, |
| @NonNull IBinder imeTargetWindowToken); |
| |
| /** |
| * Returns true when the hardware keyboard is available. |
| */ |
| public abstract boolean isHardKeyboardAvailable(); |
| |
| /** |
| * Sets the callback listener for hardware keyboard status changes. |
| * |
| * @param listener The listener to set. |
| */ |
| public abstract void setOnHardKeyboardStatusChangeListener( |
| OnHardKeyboardStatusChangeListener listener); |
| |
| /** Returns true if a stack in the windowing mode is currently visible. */ |
| public abstract boolean isStackVisible(int windowingMode); |
| |
| /** |
| * Requests the window manager to resend the windows for accessibility. |
| */ |
| public abstract void computeWindowsForAccessibility(); |
| |
| /** |
| * Called after virtual display Id is updated by |
| * {@link com.android.server.vr.Vr2dDisplay} with a specific |
| * {@param vr2dDisplayId}. |
| */ |
| public abstract void setVr2dDisplayId(int vr2dDisplayId); |
| |
| /** |
| * Sets callback to DragDropController. |
| */ |
| public abstract void registerDragDropControllerCallback(IDragDropCallback callback); |
| |
| /** |
| * @see android.view.IWindowManager#lockNow |
| */ |
| public abstract void lockNow(); |
| |
| /** |
| * Return the user that owns the given window, {@link android.os.UserHandle#USER_NULL} if |
| * the window token is not found. |
| */ |
| public abstract int getWindowOwnerUserId(IBinder windowToken); |
| |
| /** |
| * Returns {@code true} if a Window owned by {@code uid} has focus. |
| */ |
| public abstract boolean isUidFocused(int uid); |
| |
| /** |
| * Checks whether the specified IME client has IME focus or not. |
| * |
| * @param uid UID of the process to be queried |
| * @param pid PID of the process to be queried |
| * @param displayId Display ID reported from the client. Note that this method also verifies |
| * whether the specified process is allowed to access to this display or not |
| * @return {@code true} if the IME client specified with {@code uid}, {@code pid}, and |
| * {@code displayId} has IME focus |
| */ |
| public abstract boolean isInputMethodClientFocus(int uid, int pid, int displayId); |
| |
| /** |
| * Checks whether the given {@code uid} is allowed to use the given {@code displayId} or not. |
| * |
| * @param displayId Display ID to be checked |
| * @param uid UID to be checked. |
| * @return {@code true} if the given {@code uid} is allowed to use the given {@code displayId} |
| */ |
| public abstract boolean isUidAllowedOnDisplay(int displayId, int uid); |
| |
| /** |
| * Return the display Id for given window. |
| */ |
| public abstract int getDisplayIdForWindow(IBinder windowToken); |
| |
| /** |
| * Checks whether this display should support showing system decorations. |
| */ |
| public abstract boolean shouldShowSystemDecorOnDisplay(int displayId); |
| } |