1 /*
2  * Copyright (C) 2021 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.shared;
18 
19 import android.view.SurfaceControl;
20 import android.window.RemoteTransition;
21 import android.window.TransitionFilter;
22 
23 import com.android.wm.shell.shared.IHomeTransitionListener;
24 
25 /**
26  * Interface that is exposed to remote callers to manipulate the transitions feature.
27  */
28 interface IShellTransitions {
29 
30     /**
31      * Registers a remote transition handler for all operations excluding takeovers (see
32      * registerRemoteForTakeover()).
33      */
registerRemote(in TransitionFilter filter, in RemoteTransition remoteTransition)34     oneway void registerRemote(in TransitionFilter filter,
35             in RemoteTransition remoteTransition) = 1;
36 
37     /**
38      * Unregisters a remote transition handler for all operations.
39      */
40     oneway void unregisterRemote(in RemoteTransition remoteTransition) = 2;
41 
42     /**
43      * Retrieves the apply-token used by transactions in Shell
44      */
getShellApplyToken()45     IBinder getShellApplyToken() = 3;
46 
47     /**
48      * Set listener that will receive callbacks about transitions involving home activity.
49      */
50     oneway void setHomeTransitionListener(in IHomeTransitionListener listener) = 4;
51 
52     /**
53      * Returns a container surface for the home root task.
54      */
getHomeTaskOverlayContainer()55     SurfaceControl getHomeTaskOverlayContainer() = 5;
56 
57     /**
58      * Registers a remote transition for takeover operations only.
59      */
registerRemoteForTakeover(in TransitionFilter filter, in RemoteTransition remoteTransition)60     oneway void registerRemoteForTakeover(in TransitionFilter filter,
61             in RemoteTransition remoteTransition) = 6;
62 }
63