1 /* 2 * Copyright (C) 2024 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.annotation.NonNull; 20 import android.window.RemoteTransition; 21 import android.window.TransitionFilter; 22 23 import com.android.wm.shell.shared.annotations.ExternalThread; 24 25 import java.util.concurrent.Executor; 26 27 /** 28 * Interface to manage remote transitions. 29 */ 30 @ExternalThread 31 public interface ShellTransitions { 32 /** 33 * Registers a remote transition for all operations excluding takeovers (see 34 * {@link ShellTransitions#registerRemoteForTakeover(TransitionFilter, RemoteTransition)}). 35 */ registerRemote(@onNull TransitionFilter filter, @NonNull RemoteTransition remoteTransition)36 default void registerRemote(@NonNull TransitionFilter filter, 37 @NonNull RemoteTransition remoteTransition) {} 38 39 /** 40 * Registers a remote transition for takeover operations only. 41 */ registerRemoteForTakeover(@onNull TransitionFilter filter, @NonNull RemoteTransition remoteTransition)42 default void registerRemoteForTakeover(@NonNull TransitionFilter filter, 43 @NonNull RemoteTransition remoteTransition) {} 44 45 /** 46 * Unregisters a remote transition for all operations. 47 */ unregisterRemote(@onNull RemoteTransition remoteTransition)48 default void unregisterRemote(@NonNull RemoteTransition remoteTransition) {} 49 50 /** 51 * Sets listener that will receive callbacks about transitions involving focus switch. 52 */ setFocusTransitionListener(@onNull FocusTransitionListener listener, Executor executor)53 default void setFocusTransitionListener(@NonNull FocusTransitionListener listener, 54 Executor executor) {} 55 56 /** 57 * Unsets listener that will receive callbacks about transitions involving focus switch. 58 */ unsetFocusTransitionListener(@onNull FocusTransitionListener listener)59 default void unsetFocusTransitionListener(@NonNull FocusTransitionListener listener) {} 60 } 61