Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit df3e93af authored by Kai Shi's avatar Kai Shi
Browse files

Add the LCE system API 

Add the link capacity estimate system API.
Remove the system API of getCarrierBandwidth() and CarrierBandwidth as
they are replaced by the new LCE system API in PhoneStateListener.

Bug: 180434672
Bug: 176814680
Test: manual test of the new LCE system API in LinkBandwidthEstimator
Test: atest -c PhoneStateListenerTest
Change-Id: Id613dc152e524045a89295e5dd03171b22377e16
parent 1fcb030d

core/api/system-current.txt

+18 −1
Original line number Diff line number Diff line
@@ -10941,6 +10941,19 @@ package android.telephony { 
    field @NonNull public static final android.os.Parcelable.Creator<android.telephony.ImsiEncryptionInfo> CREATOR;

  }













  public final class LinkCapacityEstimate implements android.os.Parcelable {













    ctor public LinkCapacityEstimate(int, int, int);













    method public int describeContents();













    method public int getDownlinkCapacityKbps();













    method public int getType();













    method public int getUplinkCapacityKbps();













    field @NonNull public static final android.os.Parcelable.Creator<android.telephony.LinkCapacityEstimate> CREATOR;













    field public static final int INVALID = -1; // 0xffffffff













    field public static final int LCE_TYPE_COMBINED = 2; // 0x2













    field public static final int LCE_TYPE_PRIMARY = 0; // 0x0













    field public static final int LCE_TYPE_SECONDARY = 1; // 0x1













  }



























  public final class LteVopsSupportInfo implements android.os.Parcelable {















    ctor public LteVopsSupportInfo(int, int);















    method public int describeContents();










@@ -11453,6 +11466,7 @@ package android.telephony {













    field @RequiresPermission(android.Manifest.permission.READ_PHONE_STATE) public static final int EVENT_EMERGENCY_NUMBER_LIST_CHANGED = 25; // 0x19















    field @RequiresPermission(android.Manifest.permission.READ_PRECISE_PHONE_STATE) public static final int EVENT_IMS_CALL_DISCONNECT_CAUSE_CHANGED = 28; // 0x1c















    field @RequiresPermission(android.Manifest.permission.READ_CALL_LOG) public static final int EVENT_LEGACY_CALL_STATE_CHANGED = 36; // 0x24













    field @RequiresPermission(android.Manifest.permission.READ_PRECISE_PHONE_STATE) public static final int EVENT_LINK_CAPACITY_ESTIMATE_CHANGED = 37; // 0x25















    field @RequiresPermission(android.Manifest.permission.READ_PHONE_STATE) public static final int EVENT_MESSAGE_WAITING_INDICATOR_CHANGED = 3; // 0x3















    field @RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE) public static final int EVENT_OEM_HOOK_RAW = 15; // 0xf















    field @RequiresPermission(android.Manifest.permission.READ_ACTIVE_EMERGENCY_SESSION) public static final int EVENT_OUTGOING_EMERGENCY_CALL = 29; // 0x1d










@@ -11483,6 +11497,10 @@ package android.telephony {













    method @RequiresPermission(android.Manifest.permission.READ_PRECISE_PHONE_STATE) public void onDataEnabledChanged(boolean, int);















  }



























  public static interface TelephonyCallback.LinkCapacityEstimateChangedListener {













    method @RequiresPermission(android.Manifest.permission.READ_PRECISE_PHONE_STATE) public void onLinkCapacityEstimateChanged(@NonNull java.util.List<android.telephony.LinkCapacityEstimate>);













  }



























  public static interface TelephonyCallback.OutgoingEmergencyCallListener {















    method @RequiresPermission(android.Manifest.permission.READ_ACTIVE_EMERGENCY_SESSION) public void onOutgoingEmergencyCall(@NonNull android.telephony.emergency.EmergencyNumber, int);















  }










@@ -11554,7 +11572,6 @@ package android.telephony {













    method @Nullable @RequiresPermission(android.Manifest.permission.INTERACT_ACROSS_USERS) public android.content.ComponentName getAndUpdateDefaultRespondViaMessageApplication();















    method @RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE) public void getCallForwarding(int, @NonNull java.util.concurrent.Executor, @NonNull android.telephony.TelephonyManager.CallForwardingInfoCallback);















    method @RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE) public void getCallWaitingStatus(@NonNull java.util.concurrent.Executor, @NonNull java.util.function.Consumer<java.lang.Integer>);













    method @NonNull @RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE) public android.telephony.CarrierBandwidth getCarrierBandwidth();















    method @Nullable @RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE) public android.telephony.ImsiEncryptionInfo getCarrierInfoForImsiEncryption(int);















    method public java.util.List<java.lang.String> getCarrierPackageNamesForIntent(android.content.Intent);















    method public java.util.List<java.lang.String> getCarrierPackageNamesForIntentAndPhone(android.content.Intent, int);

























core/java/android/telephony/PhoneStateListener.java



+7
−0




























Original line number
Diff line number
Diff line








@@ -1261,6 +1261,8 @@ public class PhoneStateListener {













        // default implementation empty















    }



























































    /**















     * The callback methods need to be called on the handler thread where















     * this object was created.  If the binder did that for us it'd be nice.










@@ -1579,6 +1581,11 @@ public class PhoneStateListener {













        public void onAllowedNetworkTypesChanged(int reason, long allowedNetworkType) {















            // default implementation empty















        }



























        public void onLinkCapacityEstimateChanged(













                List<LinkCapacityEstimate> linkCapacityEstimateList) {













            // default implementation empty













        }















    }































    private void log(String s) {

































core/java/android/telephony/TelephonyCallback.java



+47
−1




























Original line number
Diff line number
Diff line








@@ -565,6 +565,21 @@ public class TelephonyCallback {













    @RequiresPermission(android.Manifest.permission.READ_CALL_LOG)















    public static final int EVENT_LEGACY_CALL_STATE_CHANGED = 36;











































    /**













     * Event for changes to the link capacity estimate (LCE)













     *













     * <p>Requires permission {@link android.Manifest.permission#READ_PRECISE_PHONE_STATE}













     *













     * @see LinkCapacityEstimateChangedListener#onLinkCapacityEstimateChanged













     *













     * @hide













     */













    @SystemApi













    @RequiresPermission(Manifest.permission.READ_PRECISE_PHONE_STATE)













    public static final int EVENT_LINK_CAPACITY_ESTIMATE_CHANGED = 37;











































    /**















     * @hide















     */










@@ -604,7 +619,8 @@ public class TelephonyCallback {













            EVENT_PHYSICAL_CHANNEL_CONFIG_CHANGED,















            EVENT_DATA_ENABLED_CHANGED,















            EVENT_ALLOWED_NETWORK_TYPE_LIST_CHANGED,













            EVENT_LEGACY_CALL_STATE_CHANGED













            EVENT_LEGACY_CALL_STATE_CHANGED,













            EVENT_LINK_CAPACITY_ESTIMATE_CHANGED















    })















    @Retention(RetentionPolicy.SOURCE)















    public @interface TelephonyEvent {










@@ -1370,6 +1386,25 @@ public class TelephonyCallback {













            @TelephonyManager.DataEnabledReason int reason);















    }





























    /**













     * Interface for link capacity estimate changed listener.













     *













     * @hide













     */













    @SystemApi













    public interface LinkCapacityEstimateChangedListener {













        /**













         * Callback invoked when the link capacity estimate (LCE) changes













         *













         * @param linkCapacityEstimateList a list of {@link LinkCapacityEstimate}













         * The list size is at least 1.













         * In case of a dual connected network, the list size could be 2.













         * Use {@link LinkCapacityEstimate#getType()} to get the type of each element.













         */













        @RequiresPermission(Manifest.permission.READ_PRECISE_PHONE_STATE)













        void onLinkCapacityEstimateChanged(













                @NonNull List<LinkCapacityEstimate> linkCapacityEstimateList);













    }































    /**















     * The callback methods need to be called on the handler thread where










@@ -1718,5 +1753,16 @@ public class TelephonyCallback {













                            () -> listener.onAllowedNetworkTypesChanged(reason,















                                    allowedNetworkType)));















        }



























        public void onLinkCapacityEstimateChanged(













                List<LinkCapacityEstimate> linkCapacityEstimateList) {













            LinkCapacityEstimateChangedListener listener =













                    (LinkCapacityEstimateChangedListener) mTelephonyCallbackWeakRef.get();













            if (listener == null) return;



























            Binder.withCleanCallingIdentity(













                    () -> mExecutor.execute(() -> listener.onLinkCapacityEstimateChanged(













                            linkCapacityEstimateList)));













        }















    }















}
























core/java/android/telephony/TelephonyRegistryManager.java



+19
−1




























Original line number
Diff line number
Diff line








@@ -842,9 +842,23 @@ public class TelephonyRegistryManager {













        }















    }





























    /**













     * Notify that the link capacity estimate has changed.













     * @param slotIndex for the phone object that gets the updated link capacity estimate













     * @param subId for subscription that gets the updated link capacity estimate













     * @param linkCapacityEstimateList a list of {@link  LinkCapacityEstimate}













     */













    public void notifyLinkCapacityEstimateChanged(int slotIndex, int subId,













            List<LinkCapacityEstimate> linkCapacityEstimateList) {













        try {













            sRegistry.notifyLinkCapacityEstimateChanged(slotIndex, subId, linkCapacityEstimateList);













        } catch (RemoteException ex) {













            // system server crash













        }













    }





























    public @NonNull Set<Integer> getEventsFromCallback(















            @NonNull TelephonyCallback telephonyCallback) {





























        Set<Integer> eventList = new ArraySet<>();































        if (telephonyCallback instanceof TelephonyCallback.ServiceStateListener) {










@@ -976,6 +990,10 @@ public class TelephonyRegistryManager {













            eventList.add(TelephonyCallback.EVENT_ALLOWED_NETWORK_TYPE_LIST_CHANGED);















        }





























        if (telephonyCallback instanceof TelephonyCallback.LinkCapacityEstimateChangedListener) {













            eventList.add(TelephonyCallback.EVENT_LINK_CAPACITY_ESTIMATE_CHANGED);













        }





























        return eventList;















    }

















































core/java/com/android/internal/telephony/IPhoneStateListener.aidl



+2
−0




























Original line number
Diff line number
Diff line








@@ -21,6 +21,7 @@ import android.telephony.CallAttributes;













import android.telephony.CellIdentity;















import android.telephony.CellInfo;















import android.telephony.DataConnectionRealTimeInfo;













import android.telephony.LinkCapacityEstimate;















import android.telephony.TelephonyDisplayInfo;















import android.telephony.PhoneCapability;















import android.telephony.PhysicalChannelConfig;










@@ -73,4 +74,5 @@ oneway interface IPhoneStateListener {













    void onPhysicalChannelConfigChanged(in List<PhysicalChannelConfig> configs);















    void onDataEnabledChanged(boolean enabled, int reason);















    void onAllowedNetworkTypesChanged(in int reason, in long allowedNetworkType);













    void onLinkCapacityEstimateChanged(in List<LinkCapacityEstimate> linkCapacityEstimateList);















}