Merge "Add the LCE system API" (26ba4d0d) · Commits · e / os / android_frameworks_base

core/api/system-current.txt

+19 −1

Original line number	Diff line number	Diff line
		@@ -9507,6 +9507,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();
		@@ -9983,6 +9996,8 @@ package android.telephony {
		field public static final int EVENT_DISPLAY_INFO_CHANGED = 21; // 0x15
		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
		@@ -10013,6 +10028,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);
		}
		@@ -10080,7 +10099,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 −1

Original line number	Diff line number	Diff line
		@@ -21,7 +21,6 @@ import android.annotation.NonNull;
		import android.annotation.RequiresPermission;
		import android.annotation.SystemApi;
		import android.annotation.TestApi;
		import android.compat.annotation.ChangeId;
		import android.compat.annotation.UnsupportedAppUsage;
		import android.os.Binder;
		import android.os.Build;
		@@ -1265,6 +1264,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 +1580,11 @@ public class PhoneStateListener {
		public void onAllowedNetworkTypesChanged(Map allowedNetworkTypesList) {
		// default implementation empty
		}

		public void onLinkCapacityEstimateChanged(
		List<LinkCapacityEstimate> linkCapacityEstimateList) {
		// default implementation empty
		}
		}

		private void log(String s) {

core/java/android/telephony/TelephonyCallback.java

+60 −2

Original line number	Diff line number	Diff line
		@@ -24,7 +24,6 @@ import android.annotation.Nullable;
		import android.annotation.RequiresPermission;
		import android.annotation.SystemApi;
		import android.compat.annotation.ChangeId;
		import android.compat.annotation.UnsupportedAppUsage;
		import android.os.Binder;
		import android.os.Build;
		import android.telephony.emergency.EmergencyNumber;
		@@ -555,6 +554,33 @@ public class TelephonyCallback {
		@RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE)
		public static final int EVENT_ALLOWED_NETWORK_TYPE_LIST_CHANGED = 35;

		/**
		* Event for changes to the legacy call state changed listener implemented by
		* {@link PhoneStateListener#onCallStateChanged(int, String)}. This listener variant is similar
		* to the new {@link CallStateListener#onCallStateChanged(int)} with the important distinction
		* that it CAN provide the phone number associated with a call.
		*
		* @hide
		*/
		@SystemApi
		@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
		*/
		@@ -593,7 +619,9 @@ public class TelephonyCallback {
		EVENT_BARRING_INFO_CHANGED,
		EVENT_PHYSICAL_CHANNEL_CONFIG_CHANGED,
		EVENT_DATA_ENABLED_CHANGED,
		EVENT_ALLOWED_NETWORK_TYPE_LIST_CHANGED
		EVENT_ALLOWED_NETWORK_TYPE_LIST_CHANGED,
		EVENT_LEGACY_CALL_STATE_CHANGED,
		EVENT_LINK_CAPACITY_ESTIMATE_CHANGED
		})
		@Retention(RetentionPolicy.SOURCE)
		public @interface TelephonyEvent {
		@@ -1360,6 +1388,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
		@@ -1703,5 +1750,16 @@ public class TelephonyCallback {
		() -> mExecutor.execute(
		() -> listener.onAllowedNetworkTypesChanged(allowedNetworkTypesList)));
		}

		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
		@@ -840,9 +840,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) {
		@@ -973,6 +987,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;
		@@ -72,4 +73,5 @@ oneway interface IPhoneStateListener {
		void onPhysicalChannelConfigChanged(in List<PhysicalChannelConfig> configs);
		void onDataEnabledChanged(boolean enabled, int reason);
		void onAllowedNetworkTypesChanged(in Map allowedNetworkTypeList);
		void onLinkCapacityEstimateChanged(in List<LinkCapacityEstimate> linkCapacityEstimateList);
		}