1 /*
2  * Copyright (C) 2020 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 
17 package com.android.wm.shell.common;
18 
19 import android.app.ActivityManager.RunningTaskInfo;
20 import android.app.ITaskStackListener;
21 import android.content.ComponentName;
22 import android.window.TaskSnapshot;
23 
24 import androidx.annotation.BinderThread;
25 
26 /**
27  * An interface to track task stack changes. Classes should implement this instead of
28  * {@link ITaskStackListener} to reduce IPC calls from system services.
29  */
30 public interface TaskStackListenerCallback {
31 
onRecentTaskListUpdated()32     default void onRecentTaskListUpdated() { }
33 
onRecentTaskListFrozenChanged(boolean frozen)34     default void onRecentTaskListFrozenChanged(boolean frozen) { }
35 
36     @BinderThread
onTaskStackChangedBackground()37     default void onTaskStackChangedBackground() { }
38 
onTaskStackChanged()39     default void onTaskStackChanged() { }
40 
onTaskProfileLocked(int taskId, int userId)41     default void onTaskProfileLocked(int taskId, int userId) { }
42 
onTaskDisplayChanged(int taskId, int newDisplayId)43     default void onTaskDisplayChanged(int taskId, int newDisplayId) { }
44 
onTaskCreated(int taskId, ComponentName componentName)45     default void onTaskCreated(int taskId, ComponentName componentName) { }
46 
onTaskRemoved(int taskId)47     default void onTaskRemoved(int taskId) { }
48 
onTaskMovedToFront(int taskId)49     default void onTaskMovedToFront(int taskId) { }
50 
onTaskMovedToFront(RunningTaskInfo taskInfo)51     default void onTaskMovedToFront(RunningTaskInfo taskInfo) {
52         onTaskMovedToFront(taskInfo.taskId);
53     }
54 
onTaskDescriptionChanged(RunningTaskInfo taskInfo)55     default void onTaskDescriptionChanged(RunningTaskInfo taskInfo) { }
56 
onTaskSnapshotChanged(int taskId, TaskSnapshot snapshot)57     default void onTaskSnapshotChanged(int taskId, TaskSnapshot snapshot) { }
58 
onBackPressedOnTaskRoot(RunningTaskInfo taskInfo)59     default void onBackPressedOnTaskRoot(RunningTaskInfo taskInfo) { }
60 
onActivityRestartAttempt(RunningTaskInfo task, boolean homeTaskVisible, boolean clearedTask, boolean wasVisible)61     default void onActivityRestartAttempt(RunningTaskInfo task, boolean homeTaskVisible,
62             boolean clearedTask, boolean wasVisible) { }
63 
onActivityPinned(String packageName, int userId, int taskId, int stackId)64     default void onActivityPinned(String packageName, int userId, int taskId, int stackId) { }
65 
onActivityUnpinned()66     default void onActivityUnpinned() { }
67 
onActivityForcedResizable(String packageName, int taskId, int reason)68     default void onActivityForcedResizable(String packageName, int taskId, int reason) { }
69 
onActivityDismissingDockedStack()70     default void onActivityDismissingDockedStack() { }
71 
onActivityLaunchOnSecondaryDisplayFailed()72     default void onActivityLaunchOnSecondaryDisplayFailed() { }
73 
onActivityLaunchOnSecondaryDisplayFailed(RunningTaskInfo taskInfo)74     default void onActivityLaunchOnSecondaryDisplayFailed(RunningTaskInfo taskInfo) {
75         onActivityLaunchOnSecondaryDisplayFailed();
76     }
77 
onActivityLaunchOnSecondaryDisplayRerouted()78     default void onActivityLaunchOnSecondaryDisplayRerouted() { }
79 
onActivityLaunchOnSecondaryDisplayRerouted(RunningTaskInfo taskInfo)80     default void onActivityLaunchOnSecondaryDisplayRerouted(RunningTaskInfo taskInfo) {
81         onActivityLaunchOnSecondaryDisplayRerouted();
82     }
83 
onActivityRequestedOrientationChanged(int taskId, int requestedOrientation)84     default void onActivityRequestedOrientationChanged(int taskId, int requestedOrientation) { }
85 
onActivityRotation(int displayId)86     default void onActivityRotation(int displayId) { }
87 }
88