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

Commit 37acf9d1 authored by Tyler Gunn's avatar Tyler Gunn
Browse files

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
parent 19f942c2

core/java/android/content/Intent.java

+6 −2
Original line number Diff line number Diff line
@@ -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)