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

Commit 8ad07c82 authored by Brad Ebinger's avatar Brad Ebinger
Browse files

Modify docs to clarify rules around placing calls to CF MMI codes 

Clarify in the docs that only the system/default dialer can
directly place call forwarding MMI codes. For other applications,
placing a call using these mmi codes will cause the dialer to
pop up with the MMI code populated so that the user can manually
confirm  before the call is placed.

Bug: 306380262
Test: docs only change
Flag: DOCS_ONLY
Change-Id: Id486304020b12e01785c5d98a1496d3bd9cfac43
parent 58f23a8e

core/java/android/content/Intent.java

+5 −0
Original line number Diff line number Diff line
@@ -1161,6 +1161,11 @@ public class Intent implements Parcelable, Cloneable { 
     * numbers.  Applications can <strong>dial</strong> emergency numbers using

     * {@link #ACTION_DIAL}, however.

     *

     * <p>Note: This Intent can only be used to dial call forwarding MMI codes if the application

     * using this intent is set as the default or system dialer. The system will treat any other

     * application using this Intent for the purpose of dialing call forwarding MMI codes as if the

     * {@link #ACTION_DIAL} Intent was used instead.

     *

     * <p>Note: An app filling the {@link android.app.role.RoleManager#ROLE_DIALER} role should use

     * {@link android.telecom.TelecomManager#placeCall(Uri, Bundle)} to place calls rather than

     * relying on this intent.

telecomm/java/android/telecom/TelecomManager.java

+5 −0
Original line number Diff line number Diff line
@@ -2352,6 +2352,11 @@ public class TelecomManager { 
     * <p>

     * <b>Note</b>: {@link android.app.Notification.CallStyle} notifications should be posted after

     * the call is placed in order for the notification to be non-dismissible.

     * <p><b>Note</b>: Call Forwarding MMI codes can only be dialed by applications that are

     * configured as the user defined default dialer or system dialer role. If a call containing a

     * call forwarding MMI code is placed by an application that is not in one of these roles, the

     * dialer will be launched with a UI showing the MMI code already populated so that the user can

     * confirm the action before the call is placed.

     * @param address The address to make the call to.

     * @param extras Bundle of extras to use with the call.

     */