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

Commit 043c9dee authored by Treehugger Robot's avatar Treehugger Robot Committed by Automerger Merge Worker
Browse files

Merge "API docs clarification for placing calls." am: 57954552 

Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1853624

Change-Id: If54588ceebba9282a374ad55242a26a53dbb224d
parents 618d74c5 57954552

core/java/android/content/Intent.java

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

     * {@link #ACTION_DIAL}, however.

     *

     * <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.

     *

     * <p>Note: if you app targets {@link android.os.Build.VERSION_CODES#M M}

     * and above and declares as using the {@link android.Manifest.permission#CALL_PHONE}

     * permission which is not granted, then attempting to use this action will

telecomm/java/android/telecom/InCallService.java

+8 −1
Original line number Diff line number Diff line
@@ -69,7 +69,14 @@ import java.util.List; 
 * them know that the app has crashed and that their call was continued using the pre-loaded dialer

 * app.

 * <p>

 * Further, the pre-loaded dialer will ALWAYS be used when the user places an emergency call.

 * The pre-loaded dialer will ALWAYS be used when the user places an emergency call, even if your

 * app fills the {@link android.app.role.RoleManager#ROLE_DIALER} role.  To ensure an optimal

 * experience when placing an emergency call, the default dialer should ALWAYS use

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

 * emergency calls).  This ensures that the platform is able to verify that the request came from

 * the default dialer.  If a non-preloaded dialer app uses {@link Intent#ACTION_CALL} to place an

 * emergency call, it will be raised to the preloaded dialer app using {@link Intent#ACTION_DIAL}

 * for confirmation; this is a suboptimal user experience.

 * <p>

 * Below is an example manifest registration for an {@code InCallService}. The meta-data

 * {@link TelecomManager#METADATA_IN_CALL_SERVICE_UI} indicates that this particular