/* * Copyright (C) 2018 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.quickstep; import android.annotation.TargetApi; import android.os.Build; import android.view.InputEvent; import android.view.KeyEvent; import android.view.MotionEvent; @TargetApi(Build.VERSION_CODES.O) public interface InputConsumer { int TYPE_NO_OP = 1 << 0; int TYPE_OVERVIEW = 1 << 1; int TYPE_OTHER_ACTIVITY = 1 << 2; int TYPE_ASSISTANT = 1 << 3; int TYPE_DEVICE_LOCKED = 1 << 4; int TYPE_ACCESSIBILITY = 1 << 5; int TYPE_SCREEN_PINNED = 1 << 6; int TYPE_OVERVIEW_WITHOUT_FOCUS = 1 << 7; int TYPE_RESET_GESTURE = 1 << 8; int TYPE_PROGRESS_DELEGATE = 1 << 9; int TYPE_SYSUI_OVERLAY = 1 << 10; int TYPE_ONE_HANDED = 1 << 11; int TYPE_TASKBAR_STASH = 1 << 12; int TYPE_STATUS_BAR = 1 << 13; int TYPE_CURSOR_HOVER = 1 << 14; int TYPE_NAV_HANDLE_LONG_PRESS = 1 << 15; String[] NAMES = new String[] { "TYPE_NO_OP", // 0 "TYPE_OVERVIEW", // 1 "TYPE_OTHER_ACTIVITY", // 2 "TYPE_ASSISTANT", // 3 "TYPE_DEVICE_LOCKED", // 4 "TYPE_ACCESSIBILITY", // 5 "TYPE_SCREEN_PINNED", // 6 "TYPE_OVERVIEW_WITHOUT_FOCUS", // 7 "TYPE_RESET_GESTURE", // 8 "TYPE_PROGRESS_DELEGATE", // 9 "TYPE_SYSUI_OVERLAY", // 10 "TYPE_ONE_HANDED", // 11 "TYPE_TASKBAR_STASH", // 12 "TYPE_STATUS_BAR", // 13 "TYPE_CURSOR_HOVER", // 14 "TYPE_NAV_HANDLE_LONG_PRESS", // 15 }; InputConsumer NO_OP = () -> TYPE_NO_OP; int getType(); /** * Returns true if the user has crossed the threshold for it to be an explicit action. */ default boolean allowInterceptByParent() { return true; } /** * Returns true if the lifecycle of this input consumer is detached from the normal gesture * down/up flow. If so, it is the responsibility of the input consumer to call back to * {@link TouchInteractionService#onConsumerInactive(InputConsumer)} after the consumer is * finished. */ default boolean isConsumerDetachedFromGesture() { return false; } /** * Handle and specific setup necessary based on the orientation of the device */ default void notifyOrientationSetup() {} /** * Returns the active input consumer is in the hierarchy of this input consumer. */ default InputConsumer getActiveConsumerInHierarchy() { return this; } /** * Called by the event queue when the consumer is about to be switched to a new consumer. * Consumers should update the state accordingly here before the state is passed to the new * consumer. */ default void onConsumerAboutToBeSwitched() { } default void onMotionEvent(MotionEvent ev) { } default void onHoverEvent(MotionEvent ev) { } default void onKeyEvent(KeyEvent ev) { } default void onInputEvent(InputEvent ev) { if (ev instanceof MotionEvent) { onMotionEvent((MotionEvent) ev); } else { onKeyEvent((KeyEvent) ev); } } default String getName() { StringBuilder name = new StringBuilder(); for (int i = 0; i < NAMES.length; i++) { if ((getType() & (1 << i)) != 0) { if (name.length() > 0) { name.append(":"); } name.append(NAMES[i]); } } return name.toString(); } /** * Returns an input consumer of the given class type, or null if none is found. */ default T getInputConsumerOfClass(Class c) { if (getClass().equals(c)) { return c.cast(this); } return null; } }