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

Commit 09b496e6 authored by Tyler Gunn's avatar Tyler Gunn
Browse files

Update API docs for broadcasts. 

ACTION_NEW_OUTGOING_CALL is no longer sent as an ordered broadcast, so
update API docs to clarify this.  The full replacement has been available
since Q, so this change is a first step to finally removing the broadcast
entirely.

Test: Docs only change
Bug: 224550864
Change-Id: I552e8f616805768089a692eb8d23477cfd5090e3
parent 5e3ac00f

core/java/android/content/Intent.java

+9 −1
Original line number Diff line number Diff line
@@ -3719,7 +3719,7 @@ public class Intent implements Parcelable, Cloneable { 
     * <p>The Intent will have the following extra value:</p>

     * <ul>

     *   <li><em>{@link android.content.Intent#EXTRA_PHONE_NUMBER}</em> -

     *       the phone number originally intended to be dialed.</li>

     *       the phone number dialed.</li>

     * </ul>

     * <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>
@@ -3748,6 +3748,14 @@ public class Intent implements Parcelable, Cloneable { 
     * {@link android.Manifest.permission#PROCESS_OUTGOING_CALLS}

     * permission to receive this Intent.</p>

     *

     * <p class="note">Starting in {@link Build.VERSION_CODES#VANILLA_ICE_CREAM}, this broadcast is

     * no longer sent as an ordered broadcast, and does not allow activity launches.  This means

     * that receivers may no longer change the phone number for the outgoing call, or cancel the

     * outgoing call.  This functionality is only possible using the

     * {@link android.telecom.CallRedirectionService} API.  Although background receivers are

     * woken up to handle this intent, no guarantee is made as to the timeliness of the broadcast.

     * </p>

     *

     * <p class="note">This is a protected intent that can only be sent

     * by the system.

     *