| /* |
| * 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.launcher3; |
| |
| import static android.view.View.IMPORTANT_FOR_ACCESSIBILITY_AUTO; |
| import static android.view.View.IMPORTANT_FOR_ACCESSIBILITY_NO_HIDE_DESCENDANTS; |
| import static android.view.View.VISIBLE; |
| import static android.view.accessibility.AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED; |
| |
| import static com.android.launcher3.anim.Interpolators.ACCEL; |
| import static com.android.launcher3.anim.Interpolators.ACCEL_2; |
| import static com.android.launcher3.anim.Interpolators.DEACCEL; |
| import static com.android.launcher3.anim.Interpolators.DEACCEL_1_7; |
| import static com.android.launcher3.anim.Interpolators.clampToProgress; |
| import static com.android.launcher3.config.FeatureFlags.ENABLE_OVERVIEW_ACTIONS; |
| import static com.android.launcher3.states.RotationHelper.REQUEST_NONE; |
| import static com.android.launcher3.states.StateAnimationConfig.ANIM_OVERVIEW_FADE; |
| import static com.android.launcher3.states.StateAnimationConfig.ANIM_OVERVIEW_SCALE; |
| import static com.android.launcher3.states.StateAnimationConfig.ANIM_OVERVIEW_TRANSLATE_X; |
| import static com.android.launcher3.states.StateAnimationConfig.ANIM_WORKSPACE_FADE; |
| import static com.android.launcher3.states.StateAnimationConfig.ANIM_WORKSPACE_SCALE; |
| import static com.android.launcher3.testing.TestProtocol.ALL_APPS_STATE_ORDINAL; |
| import static com.android.launcher3.testing.TestProtocol.BACKGROUND_APP_STATE_ORDINAL; |
| import static com.android.launcher3.testing.TestProtocol.HINT_STATE_ORDINAL; |
| import static com.android.launcher3.testing.TestProtocol.NORMAL_STATE_ORDINAL; |
| import static com.android.launcher3.testing.TestProtocol.OVERVIEW_PEEK_STATE_ORDINAL; |
| import static com.android.launcher3.testing.TestProtocol.OVERVIEW_STATE_ORDINAL; |
| import static com.android.launcher3.testing.TestProtocol.QUICK_SWITCH_STATE_ORDINAL; |
| import static com.android.launcher3.testing.TestProtocol.SPRING_LOADED_STATE_ORDINAL; |
| |
| import android.content.Context; |
| import android.view.View; |
| import android.view.animation.Interpolator; |
| |
| import com.android.launcher3.allapps.AllAppsContainerView; |
| import com.android.launcher3.states.HintState; |
| import com.android.launcher3.states.SpringLoadedState; |
| import com.android.launcher3.states.StateAnimationConfig; |
| import com.android.launcher3.uioverrides.states.AllAppsState; |
| import com.android.launcher3.uioverrides.states.OverviewState; |
| import com.android.launcher3.userevent.nano.LauncherLogProto.ContainerType; |
| |
| import java.util.Arrays; |
| |
| |
| /** |
| * Base state for various states used for the Launcher |
| */ |
| public abstract class LauncherState { |
| |
| |
| /** |
| * Set of elements indicating various workspace elements which change visibility across states |
| * Note that workspace is not included here as in that case, we animate individual pages |
| */ |
| public static final int NONE = 0; |
| public static final int HOTSEAT_ICONS = 1 << 0; |
| public static final int HOTSEAT_SEARCH_BOX = 1 << 1; |
| public static final int ALL_APPS_HEADER = 1 << 2; |
| public static final int ALL_APPS_HEADER_EXTRA = 1 << 3; // e.g. app predictions |
| public static final int ALL_APPS_CONTENT = 1 << 4; |
| public static final int VERTICAL_SWIPE_INDICATOR = 1 << 5; |
| public static final int RECENTS_CLEAR_ALL_BUTTON = 1 << 6; |
| |
| /** Mask of all the items that are contained in the apps view. */ |
| public static final int APPS_VIEW_ITEM_MASK = |
| HOTSEAT_SEARCH_BOX | ALL_APPS_HEADER | ALL_APPS_HEADER_EXTRA | ALL_APPS_CONTENT; |
| |
| protected static final int FLAG_MULTI_PAGE = 1 << 0; |
| protected static final int FLAG_DISABLE_ACCESSIBILITY = 1 << 1; |
| protected static final int FLAG_DISABLE_RESTORE = 1 << 2; |
| protected static final int FLAG_WORKSPACE_ICONS_CAN_BE_DRAGGED = 1 << 3; |
| protected static final int FLAG_DISABLE_PAGE_CLIPPING = 1 << 4; |
| protected static final int FLAG_PAGE_BACKGROUNDS = 1 << 5; |
| protected static final int FLAG_DISABLE_INTERACTION = 1 << 6; |
| protected static final int FLAG_OVERVIEW_UI = 1 << 7; |
| protected static final int FLAG_HIDE_BACK_BUTTON = 1 << 8; |
| protected static final int FLAG_HAS_SYS_UI_SCRIM = 1 << 9; |
| |
| protected static final PageAlphaProvider DEFAULT_ALPHA_PROVIDER = |
| new PageAlphaProvider(ACCEL_2) { |
| @Override |
| public float getPageAlpha(int pageIndex) { |
| return 1; |
| } |
| }; |
| |
| private static final LauncherState[] sAllStates = new LauncherState[8]; |
| |
| /** |
| * TODO: Create a separate class for NORMAL state. |
| */ |
| public static final LauncherState NORMAL = new LauncherState(NORMAL_STATE_ORDINAL, |
| ContainerType.WORKSPACE, |
| FLAG_DISABLE_RESTORE | FLAG_WORKSPACE_ICONS_CAN_BE_DRAGGED | FLAG_HIDE_BACK_BUTTON | |
| FLAG_HAS_SYS_UI_SCRIM) { |
| @Override |
| public int getTransitionDuration(Launcher launcher) { |
| // Arbitrary duration, when going to NORMAL we use the state we're coming from instead. |
| return 0; |
| } |
| }; |
| |
| /** |
| * Various Launcher states arranged in the increasing order of UI layers |
| */ |
| public static final LauncherState SPRING_LOADED = new SpringLoadedState( |
| SPRING_LOADED_STATE_ORDINAL); |
| public static final LauncherState ALL_APPS = new AllAppsState(ALL_APPS_STATE_ORDINAL); |
| public static final LauncherState HINT_STATE = new HintState(HINT_STATE_ORDINAL); |
| |
| public static final LauncherState OVERVIEW = new OverviewState(OVERVIEW_STATE_ORDINAL); |
| public static final LauncherState OVERVIEW_PEEK = |
| OverviewState.newPeekState(OVERVIEW_PEEK_STATE_ORDINAL); |
| public static final LauncherState QUICK_SWITCH = |
| OverviewState.newSwitchState(QUICK_SWITCH_STATE_ORDINAL); |
| public static final LauncherState BACKGROUND_APP = |
| OverviewState.newBackgroundState(BACKGROUND_APP_STATE_ORDINAL); |
| |
| public final int ordinal; |
| |
| /** |
| * Used for containerType in {@link com.android.launcher3.logging.UserEventDispatcher} |
| */ |
| public final int containerType; |
| |
| /** |
| * True if the state can be persisted across activity restarts. |
| */ |
| public final boolean disableRestore; |
| |
| /** |
| * True if workspace has multiple pages visible. |
| */ |
| public final boolean hasMultipleVisiblePages; |
| |
| /** |
| * Accessibility flag for workspace and its pages. |
| * @see android.view.View#setImportantForAccessibility(int) |
| */ |
| public final int workspaceAccessibilityFlag; |
| |
| /** |
| * Properties related to state transition animation |
| * |
| * @see WorkspaceStateTransitionAnimation |
| */ |
| public final boolean hasWorkspacePageBackground; |
| |
| /** |
| * True if the state allows workspace icons to be dragged. |
| */ |
| public final boolean workspaceIconsCanBeDragged; |
| |
| /** |
| * True if the workspace pages should not be clipped relative to the workspace bounds |
| * for this state. |
| */ |
| public final boolean disablePageClipping; |
| |
| /** |
| * True if launcher can not be directly interacted in this state; |
| */ |
| public final boolean disableInteraction; |
| |
| /** |
| * True if the state has overview panel visible. |
| */ |
| public final boolean overviewUi; |
| |
| /** |
| * True if the back button should be hidden when in this state (assuming no floating views are |
| * open, launcher has window focus, etc). |
| */ |
| public final boolean hideBackButton; |
| |
| public final boolean hasSysUiScrim; |
| |
| public LauncherState(int id, int containerType, int flags) { |
| this.containerType = containerType; |
| |
| this.hasWorkspacePageBackground = (flags & FLAG_PAGE_BACKGROUNDS) != 0; |
| this.hasMultipleVisiblePages = (flags & FLAG_MULTI_PAGE) != 0; |
| this.workspaceAccessibilityFlag = (flags & FLAG_DISABLE_ACCESSIBILITY) != 0 |
| ? IMPORTANT_FOR_ACCESSIBILITY_NO_HIDE_DESCENDANTS |
| : IMPORTANT_FOR_ACCESSIBILITY_AUTO; |
| this.disableRestore = (flags & FLAG_DISABLE_RESTORE) != 0; |
| this.workspaceIconsCanBeDragged = (flags & FLAG_WORKSPACE_ICONS_CAN_BE_DRAGGED) != 0; |
| this.disablePageClipping = (flags & FLAG_DISABLE_PAGE_CLIPPING) != 0; |
| this.disableInteraction = (flags & FLAG_DISABLE_INTERACTION) != 0; |
| this.overviewUi = (flags & FLAG_OVERVIEW_UI) != 0; |
| this.hideBackButton = (flags & FLAG_HIDE_BACK_BUTTON) != 0; |
| this.hasSysUiScrim = (flags & FLAG_HAS_SYS_UI_SCRIM) != 0; |
| |
| this.ordinal = id; |
| sAllStates[id] = this; |
| } |
| |
| public static LauncherState[] values() { |
| return Arrays.copyOf(sAllStates, sAllStates.length); |
| } |
| |
| /** |
| * @return How long the animation to this state should take (or from this state to NORMAL). |
| * @param launcher |
| */ |
| public abstract int getTransitionDuration(Launcher launcher); |
| |
| public ScaleAndTranslation getWorkspaceScaleAndTranslation(Launcher launcher) { |
| return new ScaleAndTranslation(1, 0, 0); |
| } |
| |
| public ScaleAndTranslation getHotseatScaleAndTranslation(Launcher launcher) { |
| // For most states, treat the hotseat as if it were part of the workspace. |
| return getWorkspaceScaleAndTranslation(launcher); |
| } |
| |
| public ScaleAndTranslation getOverviewScaleAndTranslation(Launcher launcher) { |
| return launcher.getOverviewScaleAndTranslationForNormalState(); |
| } |
| |
| public ScaleAndTranslation getQsbScaleAndTranslation(Launcher launcher) { |
| return new ScaleAndTranslation(1, 0, 0); |
| } |
| |
| public float getOverviewFullscreenProgress() { |
| return 0; |
| } |
| |
| public void onStateEnabled(Launcher launcher) { |
| dispatchWindowStateChanged(launcher); |
| } |
| |
| public void onStateDisabled(Launcher launcher) { } |
| |
| public int getVisibleElements(Launcher launcher) { |
| if (launcher.getDeviceProfile().isVerticalBarLayout()) { |
| return HOTSEAT_ICONS | VERTICAL_SWIPE_INDICATOR; |
| } |
| return HOTSEAT_ICONS | HOTSEAT_SEARCH_BOX | VERTICAL_SWIPE_INDICATOR; |
| } |
| |
| /** |
| * Fraction shift in the vertical translation UI and related properties |
| * |
| * @see com.android.launcher3.allapps.AllAppsTransitionController |
| */ |
| public float getVerticalProgress(Launcher launcher) { |
| return 1f; |
| } |
| |
| public float getWorkspaceScrimAlpha(Launcher launcher) { |
| return 0; |
| } |
| |
| public float getOverviewScrimAlpha(Launcher launcher) { |
| return 0; |
| } |
| |
| /** |
| * The amount of blur to apply to the background of either the app or Launcher surface in this |
| * state. |
| */ |
| public int getBackgroundBlurRadius(Context context) { |
| return 0; |
| } |
| |
| public String getDescription(Launcher launcher) { |
| return launcher.getWorkspace().getCurrentPageDescription(); |
| } |
| |
| public PageAlphaProvider getWorkspacePageAlphaProvider(Launcher launcher) { |
| if (this != NORMAL || !launcher.getDeviceProfile().shouldFadeAdjacentWorkspaceScreens()) { |
| return DEFAULT_ALPHA_PROVIDER; |
| } |
| final int centerPage = launcher.getWorkspace().getNextPage(); |
| return new PageAlphaProvider(ACCEL_2) { |
| @Override |
| public float getPageAlpha(int pageIndex) { |
| return pageIndex != centerPage ? 0 : 1f; |
| } |
| }; |
| } |
| |
| public LauncherState getHistoryForState(LauncherState previousState) { |
| // No history is supported |
| return NORMAL; |
| } |
| |
| /** |
| * Called when the start transition ends and the user settles on this particular state. |
| */ |
| public void onStateTransitionEnd(Launcher launcher) { |
| if (this == NORMAL) { |
| // Clear any rotation locks when going to normal state |
| launcher.getRotationHelper().setCurrentStateRequest(REQUEST_NONE); |
| } |
| } |
| |
| public void onBackPressed(Launcher launcher) { |
| if (this != NORMAL) { |
| LauncherStateManager lsm = launcher.getStateManager(); |
| LauncherState lastState = lsm.getLastState(); |
| lsm.goToState(lastState); |
| } |
| } |
| |
| /** |
| * Prepares for a non-user controlled animation from fromState to this state. Preparations |
| * include: |
| * - Setting interpolators for various animations included in the state transition. |
| * - Setting some start values (e.g. scale) for views that are hidden but about to be shown. |
| */ |
| public void prepareForAtomicAnimation(Launcher launcher, LauncherState fromState, |
| StateAnimationConfig config) { |
| if (this == NORMAL && fromState == OVERVIEW) { |
| config.setInterpolator(ANIM_WORKSPACE_SCALE, DEACCEL); |
| config.setInterpolator(ANIM_WORKSPACE_FADE, ACCEL); |
| config.setInterpolator(ANIM_OVERVIEW_SCALE, clampToProgress(ACCEL, 0, 0.9f)); |
| config.setInterpolator(ANIM_OVERVIEW_TRANSLATE_X, ACCEL); |
| config.setInterpolator(ANIM_OVERVIEW_FADE, DEACCEL_1_7); |
| Workspace workspace = launcher.getWorkspace(); |
| |
| // Start from a higher workspace scale, but only if we're invisible so we don't jump. |
| boolean isWorkspaceVisible = workspace.getVisibility() == VISIBLE; |
| if (isWorkspaceVisible) { |
| CellLayout currentChild = (CellLayout) workspace.getChildAt( |
| workspace.getCurrentPage()); |
| isWorkspaceVisible = currentChild.getVisibility() == VISIBLE |
| && currentChild.getShortcutsAndWidgets().getAlpha() > 0; |
| } |
| if (!isWorkspaceVisible) { |
| workspace.setScaleX(0.92f); |
| workspace.setScaleY(0.92f); |
| } |
| Hotseat hotseat = launcher.getHotseat(); |
| boolean isHotseatVisible = hotseat.getVisibility() == VISIBLE && hotseat.getAlpha() > 0; |
| if (!isHotseatVisible) { |
| hotseat.setScaleX(0.92f); |
| hotseat.setScaleY(0.92f); |
| if (ENABLE_OVERVIEW_ACTIONS.get()) { |
| AllAppsContainerView qsbContainer = launcher.getAppsView(); |
| View qsb = qsbContainer.getSearchView(); |
| boolean qsbVisible = qsb.getVisibility() == VISIBLE && qsb.getAlpha() > 0; |
| if (!qsbVisible) { |
| qsbContainer.setScaleX(0.92f); |
| qsbContainer.setScaleY(0.92f); |
| } |
| } |
| } |
| } else if (this == NORMAL && fromState == OVERVIEW_PEEK) { |
| // Keep fully visible until the very end (when overview is offscreen) to make invisible. |
| config.setInterpolator(ANIM_OVERVIEW_FADE, t -> t < 1 ? 0 : 1); |
| } |
| } |
| |
| protected static void dispatchWindowStateChanged(Launcher launcher) { |
| launcher.getWindow().getDecorView().sendAccessibilityEvent(TYPE_WINDOW_STATE_CHANGED); |
| } |
| |
| public static abstract class PageAlphaProvider { |
| |
| public final Interpolator interpolator; |
| |
| public PageAlphaProvider(Interpolator interpolator) { |
| this.interpolator = interpolator; |
| } |
| |
| public abstract float getPageAlpha(int pageIndex); |
| } |
| |
| public static class ScaleAndTranslation { |
| public float scale; |
| public float translationX; |
| public float translationY; |
| |
| public ScaleAndTranslation(float scale, float translationX, float translationY) { |
| this.scale = scale; |
| this.translationX = translationX; |
| this.translationY = translationY; |
| } |
| } |
| } |