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

Commit 57954552 authored by Treehugger Robot's avatar Treehugger Robot Committed by Gerrit Code Review
Browse files

Merge "API docs clarification for placing calls."

parents 66fadd90 272fd214
Loading
Loading
Loading
Loading
+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
+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