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