1 /* 2 * Copyright (C) 2023 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.NonNull; 20 import android.annotation.SystemApi; 21 22 import java.util.concurrent.Executor; 23 import java.util.function.Consumer; 24 25 /** 26 * A callback class for listening to satellite datagrams. 27 * {@link SatelliteDatagramCallback} is registered to telephony when an app which invokes 28 * {@link SatelliteManager#registerForIncomingDatagram(Executor, SatelliteDatagramCallback)}, 29 * and {@link #onSatelliteDatagramReceived(long, SatelliteDatagram, int, Consumer)} will be invoked 30 * when a new datagram is received from satellite. 31 * 32 * @hide 33 */ 34 @SystemApi 35 public interface SatelliteDatagramCallback { 36 /** 37 * Called when there is an incoming datagram to be received. 38 * 39 * @param datagramId An id that uniquely identifies incoming datagram. 40 * @param datagram Datagram to be received over satellite. 41 * @param pendingCount Number of datagrams yet to be received by the app. 42 * @param callback This callback will be used by datagram receiver app to inform Telephony 43 * that they received the datagram. If the callback is not received within 44 * five minutes, Telephony will resend the datagram. 45 */ onSatelliteDatagramReceived(long datagramId, @NonNull SatelliteDatagram datagram, int pendingCount, @NonNull Consumer<Void> callback)46 void onSatelliteDatagramReceived(long datagramId, @NonNull SatelliteDatagram datagram, 47 int pendingCount, @NonNull Consumer<Void> callback); 48 } 49