diff options
| author | 2024-04-02 18:24:26 +0000 | |
|---|---|---|
| committer | 2024-04-02 18:24:26 +0000 | |
| commit | 37acf9d15d26a5feca45d835c34ea41b49d2d86d (patch) | |
| tree | 000deafff5fa0eab6ffad2c331b212ca75f2c376 | |
| parent | 19f942c26e115357704c7b295e4b05c2fd93b92f (diff) | |
Update API docs for ACTION_NEW_OUTGOING_CALL broadcast.
Starting in Android 15, after a 5 year deprecation, this broadcast is no
longer sent as an ordered broadcast, and it no longer gives the receiver
foreground priority and the ability to launch background activities.
These changes were made for performance and security reasons.
Bug: 224550864
Test: Docs only change
Change-Id: I2ad00cc8314c7bba1affda78e93f8ff951bd25f9
| -rw-r--r-- | core/java/android/content/Intent.java | 8 |
1 files changed, 6 insertions, 2 deletions
diff --git a/core/java/android/content/Intent.java b/core/java/android/content/Intent.java index 8bc5e8c1ef34..9e316a2d3560 100644 --- a/core/java/android/content/Intent.java +++ b/core/java/android/content/Intent.java @@ -3771,6 +3771,10 @@ public class Intent implements Parcelable, Cloneable { * <li><em>{@link android.content.Intent#EXTRA_PHONE_NUMBER}</em> - * the phone number originally intended to be dialed.</li> * </ul> + * <p class="note">Starting in Android 15, this broadcast is no longer sent as an ordered + * broadcast. The <code>resultData</code> no longer has any effect and will not determine the + * actual routing of the call. Further, receivers of this broadcast do not get foreground + * priority and cannot launch background activities.</p> * <p>Once the broadcast is finished, the resultData is used as the actual * number to call. If <code>null</code>, no call will be placed.</p> * <p>It is perfectly acceptable for multiple receivers to process the @@ -3811,8 +3815,8 @@ public class Intent implements Parcelable, Cloneable { * {@link android.telecom.CallRedirectionService} API. Apps that perform call screening * should use the {@link android.telecom.CallScreeningService} API. Apps which need to be * notified of basic call state should use - * {@link android.telephony.PhoneStateListener#onCallStateChanged(int, String)} to determine - * when a new outgoing call is placed. + * {@link android.telephony.TelephonyCallback.CallStateListener} to determine when a new + * outgoing call is placed. */ @Deprecated @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) |