Sunny Goyal | 4c7f215 | 2017-10-17 17:17:16 -0700 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (C) 2017 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 | package com.android.launcher3; |
| 17 | |
| 18 | import static android.view.View.IMPORTANT_FOR_ACCESSIBILITY_AUTO; |
| 19 | import static android.view.View.IMPORTANT_FOR_ACCESSIBILITY_NO_HIDE_DESCENDANTS; |
Sunny Goyal | 3e3f44c | 2017-10-23 17:14:52 -0700 | [diff] [blame] | 20 | import static android.view.accessibility.AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED; |
Sunny Goyal | 0c72335 | 2017-12-12 12:02:29 -0800 | [diff] [blame] | 21 | import static com.android.launcher3.anim.Interpolators.ACCEL_2; |
Sunny Goyal | 623eddd | 2018-03-02 12:24:41 -0800 | [diff] [blame] | 22 | import static com.android.launcher3.states.RotationHelper.REQUEST_NONE; |
Sunny Goyal | 0c72335 | 2017-12-12 12:02:29 -0800 | [diff] [blame] | 23 | |
Sunny Goyal | be93f26 | 2017-10-20 17:05:27 -0700 | [diff] [blame] | 24 | import android.view.View; |
Sunny Goyal | 0c72335 | 2017-12-12 12:02:29 -0800 | [diff] [blame] | 25 | import android.view.animation.Interpolator; |
Sunny Goyal | be93f26 | 2017-10-20 17:05:27 -0700 | [diff] [blame] | 26 | |
Sunny Goyal | c99cb17 | 2017-10-19 16:15:09 -0700 | [diff] [blame] | 27 | import com.android.launcher3.states.SpringLoadedState; |
Sunny Goyal | 623eddd | 2018-03-02 12:24:41 -0800 | [diff] [blame] | 28 | import com.android.launcher3.uioverrides.AllAppsState; |
Sunny Goyal | 6c6c2f4 | 2018-03-02 14:57:46 -0800 | [diff] [blame] | 29 | import com.android.launcher3.uioverrides.FastOverviewState; |
Sunny Goyal | 8552517 | 2017-11-06 13:00:42 -0800 | [diff] [blame] | 30 | import com.android.launcher3.uioverrides.OverviewState; |
Sunny Goyal | 75c59ac | 2018-01-15 14:23:11 -0800 | [diff] [blame] | 31 | import com.android.launcher3.uioverrides.UiFactory; |
Sunny Goyal | 4c7f215 | 2017-10-17 17:17:16 -0700 | [diff] [blame] | 32 | import com.android.launcher3.userevent.nano.LauncherLogProto.ContainerType; |
| 33 | |
Sunny Goyal | cd7c0aa | 2017-10-19 12:36:27 -0700 | [diff] [blame] | 34 | import java.util.Arrays; |
| 35 | |
Sunny Goyal | 4c7f215 | 2017-10-17 17:17:16 -0700 | [diff] [blame] | 36 | |
| 37 | /** |
Sunny Goyal | be93f26 | 2017-10-20 17:05:27 -0700 | [diff] [blame] | 38 | * Base state for various states used for the Launcher |
Sunny Goyal | 4c7f215 | 2017-10-17 17:17:16 -0700 | [diff] [blame] | 39 | */ |
Sunny Goyal | cd7c0aa | 2017-10-19 12:36:27 -0700 | [diff] [blame] | 40 | public class LauncherState { |
Sunny Goyal | 4c7f215 | 2017-10-17 17:17:16 -0700 | [diff] [blame] | 41 | |
Sunny Goyal | 7185dd6 | 2018-03-14 17:51:49 -0700 | [diff] [blame] | 42 | |
| 43 | /** |
| 44 | * Set of elements indicating various workspace elements which change visibility across states |
| 45 | * Note that workspace is not included here as in that case, we animate individual pages |
| 46 | */ |
| 47 | public static final int NONE = 0; |
Tony Wickham | bd6f05e | 2018-03-21 08:16:33 -0700 | [diff] [blame] | 48 | public static final int HOTSEAT_ICONS = 1 << 0; |
Sunny Goyal | 81b4c7b | 2018-03-26 12:10:31 -0700 | [diff] [blame] | 49 | public static final int HOTSEAT_SEARCH_BOX = 1 << 1; |
Tony Wickham | bd6f05e | 2018-03-21 08:16:33 -0700 | [diff] [blame] | 50 | public static final int ALL_APPS_HEADER = 1 << 2; |
| 51 | public static final int ALL_APPS_HEADER_EXTRA = 1 << 3; // e.g. app predictions |
| 52 | public static final int ALL_APPS_CONTENT = 1 << 4; |
Sunny Goyal | 81b4c7b | 2018-03-26 12:10:31 -0700 | [diff] [blame] | 53 | public static final int DRAG_HANDLE_INDICATOR = 1 << 5; |
Sunny Goyal | 7185dd6 | 2018-03-14 17:51:49 -0700 | [diff] [blame] | 54 | |
Sunny Goyal | 927447e | 2018-05-04 13:19:29 -0700 | [diff] [blame^] | 55 | protected static final int FLAG_MULTI_PAGE = 1 << 0; |
| 56 | protected static final int FLAG_DISABLE_ACCESSIBILITY = 1 << 1; |
| 57 | protected static final int FLAG_DISABLE_RESTORE = 1 << 2; |
| 58 | protected static final int FLAG_WORKSPACE_ICONS_CAN_BE_DRAGGED = 1 << 3; |
| 59 | protected static final int FLAG_DISABLE_PAGE_CLIPPING = 1 << 4; |
| 60 | protected static final int FLAG_PAGE_BACKGROUNDS = 1 << 5; |
| 61 | protected static final int FLAG_DISABLE_INTERACTION = 1 << 6; |
| 62 | protected static final int FLAG_OVERVIEW_UI = 1 << 7; |
| 63 | protected static final int FLAG_HIDE_BACK_BUTTON = 1 << 8; |
Sunny Goyal | 6c6c2f4 | 2018-03-02 14:57:46 -0800 | [diff] [blame] | 64 | |
Sunny Goyal | 0c72335 | 2017-12-12 12:02:29 -0800 | [diff] [blame] | 65 | protected static final PageAlphaProvider DEFAULT_ALPHA_PROVIDER = |
| 66 | new PageAlphaProvider(ACCEL_2) { |
| 67 | @Override |
| 68 | public float getPageAlpha(int pageIndex) { |
| 69 | return 1; |
| 70 | } |
| 71 | }; |
Sunny Goyal | cd7c0aa | 2017-10-19 12:36:27 -0700 | [diff] [blame] | 72 | |
Sunny Goyal | 6c6c2f4 | 2018-03-02 14:57:46 -0800 | [diff] [blame] | 73 | private static final LauncherState[] sAllStates = new LauncherState[5]; |
Sunny Goyal | cd7c0aa | 2017-10-19 12:36:27 -0700 | [diff] [blame] | 74 | |
Sunny Goyal | 75c59ac | 2018-01-15 14:23:11 -0800 | [diff] [blame] | 75 | /** |
| 76 | * TODO: Create a separate class for NORMAL state. |
| 77 | */ |
Sunny Goyal | c99cb17 | 2017-10-19 16:15:09 -0700 | [diff] [blame] | 78 | public static final LauncherState NORMAL = new LauncherState(0, ContainerType.WORKSPACE, |
Tony Wickham | 76cf236 | 2018-03-20 14:13:16 -0700 | [diff] [blame] | 79 | 0, FLAG_DISABLE_RESTORE | FLAG_WORKSPACE_ICONS_CAN_BE_DRAGGED | FLAG_HIDE_BACK_BUTTON); |
Sunny Goyal | cd7c0aa | 2017-10-19 12:36:27 -0700 | [diff] [blame] | 80 | |
Sunny Goyal | 7185dd6 | 2018-03-14 17:51:49 -0700 | [diff] [blame] | 81 | /** |
| 82 | * Various Launcher states arranged in the increasing order of UI layers |
| 83 | */ |
| 84 | public static final LauncherState SPRING_LOADED = new SpringLoadedState(1); |
| 85 | public static final LauncherState OVERVIEW = new OverviewState(2); |
| 86 | public static final LauncherState FAST_OVERVIEW = new FastOverviewState(3); |
| 87 | public static final LauncherState ALL_APPS = new AllAppsState(4); |
Sunny Goyal | 6c6c2f4 | 2018-03-02 14:57:46 -0800 | [diff] [blame] | 88 | |
Sunny Goyal | cd7c0aa | 2017-10-19 12:36:27 -0700 | [diff] [blame] | 89 | public final int ordinal; |
| 90 | |
Sunny Goyal | f9403d9 | 2017-10-18 10:55:56 -0700 | [diff] [blame] | 91 | /** |
| 92 | * Used for containerType in {@link com.android.launcher3.logging.UserEventDispatcher} |
| 93 | */ |
Sunny Goyal | 4c7f215 | 2017-10-17 17:17:16 -0700 | [diff] [blame] | 94 | public final int containerType; |
| 95 | |
Sunny Goyal | f9403d9 | 2017-10-18 10:55:56 -0700 | [diff] [blame] | 96 | /** |
| 97 | * True if the state can be persisted across activity restarts. |
| 98 | */ |
Sunny Goyal | bc683e9 | 2017-12-06 10:25:07 -0800 | [diff] [blame] | 99 | public final boolean disableRestore; |
Sunny Goyal | f9403d9 | 2017-10-18 10:55:56 -0700 | [diff] [blame] | 100 | |
| 101 | /** |
| 102 | * True if workspace has multiple pages visible. |
| 103 | */ |
Sunny Goyal | 4c7f215 | 2017-10-17 17:17:16 -0700 | [diff] [blame] | 104 | public final boolean hasMultipleVisiblePages; |
Sunny Goyal | f9403d9 | 2017-10-18 10:55:56 -0700 | [diff] [blame] | 105 | |
| 106 | /** |
| 107 | * Accessibility flag for workspace and its pages. |
| 108 | * @see android.view.View#setImportantForAccessibility(int) |
| 109 | */ |
Sunny Goyal | 4c7f215 | 2017-10-17 17:17:16 -0700 | [diff] [blame] | 110 | public final int workspaceAccessibilityFlag; |
| 111 | |
Sunny Goyal | be93f26 | 2017-10-20 17:05:27 -0700 | [diff] [blame] | 112 | /** |
| 113 | * Properties related to state transition animation |
| 114 | * |
| 115 | * @see WorkspaceStateTransitionAnimation |
| 116 | */ |
Sunny Goyal | 6639a5d | 2018-02-28 15:09:36 -0800 | [diff] [blame] | 117 | public final boolean hasWorkspacePageBackground; |
Sunny Goyal | 6639a5d | 2018-02-28 15:09:36 -0800 | [diff] [blame] | 118 | |
Sunny Goyal | 4c7f215 | 2017-10-17 17:17:16 -0700 | [diff] [blame] | 119 | public final int transitionDuration; |
| 120 | |
Sunny Goyal | be93f26 | 2017-10-20 17:05:27 -0700 | [diff] [blame] | 121 | /** |
Tony Wickham | 5337067 | 2017-12-05 10:10:55 -0800 | [diff] [blame] | 122 | * True if the state allows workspace icons to be dragged. |
| 123 | */ |
| 124 | public final boolean workspaceIconsCanBeDragged; |
| 125 | |
Sunny Goyal | bc683e9 | 2017-12-06 10:25:07 -0800 | [diff] [blame] | 126 | /** |
| 127 | * True if the workspace pages should not be clipped relative to the workspace bounds |
| 128 | * for this state. |
| 129 | */ |
| 130 | public final boolean disablePageClipping; |
| 131 | |
Sunny Goyal | 6c6c2f4 | 2018-03-02 14:57:46 -0800 | [diff] [blame] | 132 | /** |
| 133 | * True if launcher can not be directly interacted in this state; |
| 134 | */ |
| 135 | public final boolean disableInteraction; |
| 136 | |
| 137 | /** |
| 138 | * True if the state has overview panel visible. |
| 139 | */ |
| 140 | public final boolean overviewUi; |
| 141 | |
Tony Wickham | 76cf236 | 2018-03-20 14:13:16 -0700 | [diff] [blame] | 142 | /** |
| 143 | * True if the back button should be hidden when in this state (assuming no floating views are |
| 144 | * open, launcher has window focus, etc). |
| 145 | */ |
| 146 | public final boolean hideBackButton; |
| 147 | |
Sunny Goyal | 228153d | 2018-01-04 15:35:22 -0800 | [diff] [blame] | 148 | public LauncherState(int id, int containerType, int transitionDuration, int flags) { |
Sunny Goyal | 4c7f215 | 2017-10-17 17:17:16 -0700 | [diff] [blame] | 149 | this.containerType = containerType; |
| 150 | this.transitionDuration = transitionDuration; |
| 151 | |
Sunny Goyal | 6639a5d | 2018-02-28 15:09:36 -0800 | [diff] [blame] | 152 | this.hasWorkspacePageBackground = (flags & FLAG_PAGE_BACKGROUNDS) != 0; |
Sunny Goyal | 4c7f215 | 2017-10-17 17:17:16 -0700 | [diff] [blame] | 153 | this.hasMultipleVisiblePages = (flags & FLAG_MULTI_PAGE) != 0; |
Sunny Goyal | 4c7f215 | 2017-10-17 17:17:16 -0700 | [diff] [blame] | 154 | this.workspaceAccessibilityFlag = (flags & FLAG_DISABLE_ACCESSIBILITY) != 0 |
| 155 | ? IMPORTANT_FOR_ACCESSIBILITY_NO_HIDE_DESCENDANTS |
| 156 | : IMPORTANT_FOR_ACCESSIBILITY_AUTO; |
Sunny Goyal | bc683e9 | 2017-12-06 10:25:07 -0800 | [diff] [blame] | 157 | this.disableRestore = (flags & FLAG_DISABLE_RESTORE) != 0; |
Tony Wickham | 5337067 | 2017-12-05 10:10:55 -0800 | [diff] [blame] | 158 | this.workspaceIconsCanBeDragged = (flags & FLAG_WORKSPACE_ICONS_CAN_BE_DRAGGED) != 0; |
Sunny Goyal | bc683e9 | 2017-12-06 10:25:07 -0800 | [diff] [blame] | 159 | this.disablePageClipping = (flags & FLAG_DISABLE_PAGE_CLIPPING) != 0; |
Sunny Goyal | 6c6c2f4 | 2018-03-02 14:57:46 -0800 | [diff] [blame] | 160 | this.disableInteraction = (flags & FLAG_DISABLE_INTERACTION) != 0; |
| 161 | this.overviewUi = (flags & FLAG_OVERVIEW_UI) != 0; |
Tony Wickham | 76cf236 | 2018-03-20 14:13:16 -0700 | [diff] [blame] | 162 | this.hideBackButton = (flags & FLAG_HIDE_BACK_BUTTON) != 0; |
Sunny Goyal | cd7c0aa | 2017-10-19 12:36:27 -0700 | [diff] [blame] | 163 | |
| 164 | this.ordinal = id; |
| 165 | sAllStates[id] = this; |
| 166 | } |
| 167 | |
| 168 | public static LauncherState[] values() { |
| 169 | return Arrays.copyOf(sAllStates, sAllStates.length); |
Sunny Goyal | 4c7f215 | 2017-10-17 17:17:16 -0700 | [diff] [blame] | 170 | } |
Sunny Goyal | c99cb17 | 2017-10-19 16:15:09 -0700 | [diff] [blame] | 171 | |
| 172 | public float[] getWorkspaceScaleAndTranslation(Launcher launcher) { |
Sunny Goyal | 9328a51 | 2017-12-21 12:40:38 -0800 | [diff] [blame] | 173 | return new float[] {1, 0, 0}; |
Sunny Goyal | c99cb17 | 2017-10-19 16:15:09 -0700 | [diff] [blame] | 174 | } |
| 175 | |
Tony | e9054e3 | 2018-03-15 12:48:51 +0000 | [diff] [blame] | 176 | /** |
Tony | 0c95559 | 2018-04-04 10:23:36 -0700 | [diff] [blame] | 177 | * Returns 2 floats designating how to transition overview: |
| 178 | * scale for the current and adjacent pages |
| 179 | * translationY factor where 0 is top aligned and 0.5 is centered vertically |
Tony | e9054e3 | 2018-03-15 12:48:51 +0000 | [diff] [blame] | 180 | */ |
Tony | 0c95559 | 2018-04-04 10:23:36 -0700 | [diff] [blame] | 181 | public float[] getOverviewScaleAndTranslationYFactor(Launcher launcher) { |
| 182 | return new float[] {1.2f, 0.2f}; |
Tony | 3bb5e8e | 2018-03-14 12:05:00 +0000 | [diff] [blame] | 183 | } |
| 184 | |
Sunny Goyal | 3e3f44c | 2017-10-23 17:14:52 -0700 | [diff] [blame] | 185 | public void onStateEnabled(Launcher launcher) { |
| 186 | dispatchWindowStateChanged(launcher); |
| 187 | } |
Sunny Goyal | c99cb17 | 2017-10-19 16:15:09 -0700 | [diff] [blame] | 188 | |
| 189 | public void onStateDisabled(Launcher launcher) { } |
Sunny Goyal | be93f26 | 2017-10-20 17:05:27 -0700 | [diff] [blame] | 190 | |
| 191 | public View getFinalFocus(Launcher launcher) { |
| 192 | return launcher.getWorkspace(); |
| 193 | } |
Sunny Goyal | 3e3f44c | 2017-10-23 17:14:52 -0700 | [diff] [blame] | 194 | |
Sunny Goyal | 7185dd6 | 2018-03-14 17:51:49 -0700 | [diff] [blame] | 195 | public int getVisibleElements(Launcher launcher) { |
Tony Wickham | bd6f05e | 2018-03-21 08:16:33 -0700 | [diff] [blame] | 196 | if (launcher.getDeviceProfile().isVerticalBarLayout()) { |
Sunny Goyal | 81b4c7b | 2018-03-26 12:10:31 -0700 | [diff] [blame] | 197 | return HOTSEAT_ICONS | DRAG_HANDLE_INDICATOR; |
Tony Wickham | bd6f05e | 2018-03-21 08:16:33 -0700 | [diff] [blame] | 198 | } |
Sunny Goyal | 81b4c7b | 2018-03-26 12:10:31 -0700 | [diff] [blame] | 199 | return HOTSEAT_ICONS | DRAG_HANDLE_INDICATOR | HOTSEAT_SEARCH_BOX; |
Sunny Goyal | 7185dd6 | 2018-03-14 17:51:49 -0700 | [diff] [blame] | 200 | } |
| 201 | |
Sunny Goyal | 228153d | 2018-01-04 15:35:22 -0800 | [diff] [blame] | 202 | /** |
| 203 | * Fraction shift in the vertical translation UI and related properties |
| 204 | * |
| 205 | * @see com.android.launcher3.allapps.AllAppsTransitionController |
| 206 | */ |
| 207 | public float getVerticalProgress(Launcher launcher) { |
| 208 | return 1f; |
| 209 | } |
| 210 | |
Sunny Goyal | 927447e | 2018-05-04 13:19:29 -0700 | [diff] [blame^] | 211 | public float getWorkspaceScrimAlpha(Launcher launcher) { |
| 212 | return 0; |
| 213 | } |
| 214 | |
Sunny Goyal | 3e3f44c | 2017-10-23 17:14:52 -0700 | [diff] [blame] | 215 | public String getDescription(Launcher launcher) { |
| 216 | return launcher.getWorkspace().getCurrentPageDescription(); |
| 217 | } |
| 218 | |
Sunny Goyal | bc683e9 | 2017-12-06 10:25:07 -0800 | [diff] [blame] | 219 | public PageAlphaProvider getWorkspacePageAlphaProvider(Launcher launcher) { |
| 220 | if (this != NORMAL || !launcher.getDeviceProfile().shouldFadeAdjacentWorkspaceScreens()) { |
| 221 | return DEFAULT_ALPHA_PROVIDER; |
| 222 | } |
Sunny Goyal | 228153d | 2018-01-04 15:35:22 -0800 | [diff] [blame] | 223 | final int centerPage = launcher.getWorkspace().getNextPage(); |
Sunny Goyal | 0c72335 | 2017-12-12 12:02:29 -0800 | [diff] [blame] | 224 | return new PageAlphaProvider(ACCEL_2) { |
| 225 | @Override |
| 226 | public float getPageAlpha(int pageIndex) { |
| 227 | return pageIndex != centerPage ? 0 : 1f; |
| 228 | } |
| 229 | }; |
Sunny Goyal | bc683e9 | 2017-12-06 10:25:07 -0800 | [diff] [blame] | 230 | } |
| 231 | |
Sunny Goyal | 49bcf34 | 2018-01-11 13:59:53 -0800 | [diff] [blame] | 232 | public LauncherState getHistoryForState(LauncherState previousState) { |
| 233 | // No history is supported |
| 234 | return NORMAL; |
| 235 | } |
| 236 | |
Sunny Goyal | 75c59ac | 2018-01-15 14:23:11 -0800 | [diff] [blame] | 237 | /** |
| 238 | * Called when the start transition ends and the user settles on this particular state. |
| 239 | */ |
| 240 | public void onStateTransitionEnd(Launcher launcher) { |
| 241 | if (this == NORMAL) { |
| 242 | UiFactory.resetOverview(launcher); |
Sunny Goyal | 623eddd | 2018-03-02 12:24:41 -0800 | [diff] [blame] | 243 | // Clear any rotation locks when going to normal state |
| 244 | launcher.getRotationHelper().setCurrentStateRequest(REQUEST_NONE); |
Sunny Goyal | 75c59ac | 2018-01-15 14:23:11 -0800 | [diff] [blame] | 245 | } |
| 246 | } |
| 247 | |
Sunny Goyal | 3e3f44c | 2017-10-23 17:14:52 -0700 | [diff] [blame] | 248 | protected static void dispatchWindowStateChanged(Launcher launcher) { |
| 249 | launcher.getWindow().getDecorView().sendAccessibilityEvent(TYPE_WINDOW_STATE_CHANGED); |
| 250 | } |
Sunny Goyal | bc683e9 | 2017-12-06 10:25:07 -0800 | [diff] [blame] | 251 | |
Sunny Goyal | 0c72335 | 2017-12-12 12:02:29 -0800 | [diff] [blame] | 252 | public static abstract class PageAlphaProvider { |
Sunny Goyal | bc683e9 | 2017-12-06 10:25:07 -0800 | [diff] [blame] | 253 | |
Sunny Goyal | 0c72335 | 2017-12-12 12:02:29 -0800 | [diff] [blame] | 254 | public final Interpolator interpolator; |
| 255 | |
| 256 | public PageAlphaProvider(Interpolator interpolator) { |
| 257 | this.interpolator = interpolator; |
| 258 | } |
| 259 | |
| 260 | public abstract float getPageAlpha(int pageIndex); |
Sunny Goyal | bc683e9 | 2017-12-06 10:25:07 -0800 | [diff] [blame] | 261 | } |
Sunny Goyal | 4c7f215 | 2017-10-17 17:17:16 -0700 | [diff] [blame] | 262 | } |