/* * 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.AnimatorSetBuilder.ANIM_OVERVIEW_FADE; import static com.android.launcher3.anim.AnimatorSetBuilder.ANIM_OVERVIEW_SCALE; import static com.android.launcher3.anim.AnimatorSetBuilder.ANIM_OVERVIEW_TRANSLATE_X; import static com.android.launcher3.anim.AnimatorSetBuilder.ANIM_WORKSPACE_FADE; import static com.android.launcher3.anim.AnimatorSetBuilder.ANIM_WORKSPACE_SCALE; import static com.android.launcher3.anim.Interpolators.ACCEL; 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.testing.TestProtocol.ALL_APPS_STATE_ORDINAL; import static com.android.launcher3.testing.TestProtocol.BACKGROUND_APP_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 static com.android.launcher3.anim.Interpolators.ACCEL_2; import static com.android.launcher3.states.RotationHelper.REQUEST_NONE; import android.view.animation.Interpolator; import com.android.launcher3.anim.AnimatorSetBuilder; import com.android.launcher3.states.SpringLoadedState; import com.android.launcher3.uioverrides.UiFactory; 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 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; 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[7]; /** * TODO: Create a separate class for NORMAL state. */ public static final LauncherState NORMAL = new LauncherState(NORMAL_STATE_ORDINAL, ContainerType.WORKSPACE, 0, FLAG_DISABLE_RESTORE | FLAG_WORKSPACE_ICONS_CAN_BE_DRAGGED | FLAG_HIDE_BACK_BUTTON | FLAG_HAS_SYS_UI_SCRIM); /** * 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 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; public final int transitionDuration; /** * 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 transitionDuration, int flags) { this.containerType = containerType; this.transitionDuration = transitionDuration; 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); } 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 UiFactory.getOverviewScaleAndTranslationForNormalState(launcher); } 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; } 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, AnimatorSetBuilder builder) { if (this == NORMAL && fromState == OVERVIEW) { builder.setInterpolator(ANIM_WORKSPACE_SCALE, DEACCEL); builder.setInterpolator(ANIM_WORKSPACE_FADE, ACCEL); builder.setInterpolator(ANIM_OVERVIEW_SCALE, clampToProgress(ACCEL, 0, 0.9f)); builder.setInterpolator(ANIM_OVERVIEW_TRANSLATE_X, ACCEL); builder.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); } } else if (this == NORMAL && fromState == OVERVIEW_PEEK) { // Keep fully visible until the very end (when overview is offscreen) to make invisible. builder.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; } } }