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 android.telephony.satellite; 18 19 import android.annotation.FlaggedApi; 20 21 import com.android.internal.telephony.flags.Flags; 22 23 import java.util.concurrent.Executor; 24 25 /** 26 * A listener interface to monitor satellite state change events. 27 * 28 * <p>Call 29 * {@link SatelliteManager#registerStateChangeListener(Executor, SatelliteStateChangeListener)} 30 * to monitor. Call 31 * {@link SatelliteManager#unregisterStateChangeListener(SatelliteStateChangeListener)} to cancel. 32 * 33 * @see SatelliteManager#registerStateChangeListener(Executor, SatelliteStateChangeListener) 34 * @see SatelliteManager#unregisterStateChangeListener(SatelliteStateChangeListener) 35 */ 36 @FlaggedApi(Flags.FLAG_SATELLITE_STATE_CHANGE_LISTENER) 37 public interface SatelliteStateChangeListener { 38 /** 39 * Called when satellite modem enabled state may have changed. 40 * 41 * <p>Note:there is no guarantee that this callback will only be invoked upon a change of state. 42 * In other word, in some cases, the callback may report with the same enabled states. It is the 43 * caller's responsibility to filter uninterested states. 44 * 45 * <p>Note:satellite enabled state is a device state that is NOT associated with subscription or 46 * SIM slot. 47 * 48 * @param isEnabled {@code true} means satellite modem is enabled. 49 */ onEnabledStateChanged(boolean isEnabled)50 void onEnabledStateChanged(boolean isEnabled); 51 } 52