1 /*
2  * Copyright (C) 2008 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 package com.android.phone;
18 
19 import android.app.Activity;
20 import android.app.ActivityManagerNative;
21 import android.app.AlertDialog;
22 import android.app.AppOpsManager;
23 import android.app.Dialog;
24 import android.content.BroadcastReceiver;
25 import android.content.Context;
26 import android.content.DialogInterface;
27 import android.content.Intent;
28 import android.content.res.Configuration;
29 import android.content.res.Resources;
30 import android.net.Uri;
31 import android.os.Bundle;
32 import android.os.Handler;
33 import android.os.Message;
34 import android.os.RemoteException;
35 import android.os.SystemProperties;
36 import android.os.UserHandle;
37 import android.telecom.PhoneAccount;
38 import android.telephony.PhoneNumberUtils;
39 import android.text.TextUtils;
40 import android.util.Log;
41 import android.view.View;
42 import android.widget.ProgressBar;
43 
44 import com.android.internal.telephony.Phone;
45 import com.android.internal.telephony.PhoneConstants;
46 import com.android.internal.telephony.TelephonyCapabilities;
47 
48 /**
49  * OutgoingCallBroadcaster receives CALL and CALL_PRIVILEGED Intents, and broadcasts the
50  * ACTION_NEW_OUTGOING_CALL intent. ACTION_NEW_OUTGOING_CALL is an ordered broadcast intent which
51  * contains the phone number being dialed. Applications can use this intent to (1) see which numbers
52  * are being dialed, (2) redirect a call (change the number being dialed), or (3) prevent a call
53  * from being placed.
54  *
55  * After the other applications have had a chance to see the
56  * ACTION_NEW_OUTGOING_CALL intent, it finally reaches the
57  * {@link OutgoingCallReceiver}, which passes the (possibly modified)
58  * intent on to the {@link SipCallOptionHandler}, which will
59  * ultimately start the call using the CallController.placeCall() API.
60  *
61  * Calls where no number is present (like for a CDMA "empty flash" or a nonexistent voicemail
62  * number) are exempt from being broadcast.
63  * Calls to emergency numbers are still broadcast for informative purposes. The call is placed
64  * prior to sending ACTION_NEW_OUTGOING_CALL and cannot be redirected nor prevented.
65  */
66 public class OutgoingCallBroadcaster extends Activity
67         implements DialogInterface.OnClickListener, DialogInterface.OnCancelListener {
68 
69     private static final String TAG = "OutgoingCallBroadcaster";
70     private static final boolean DBG =
71             (PhoneGlobals.DBG_LEVEL >= 1) && (SystemProperties.getInt("ro.debuggable", 0) == 1);
72     // Do not check in with VDBG = true, since that may write PII to the system log.
73     private static final boolean VDBG = false;
74 
75     /** Required permission for any app that wants to consume ACTION_NEW_OUTGOING_CALL. */
76     private static final String PERMISSION = android.Manifest.permission.PROCESS_OUTGOING_CALLS;
77 
78     public static final String ACTION_SIP_SELECT_PHONE = "com.android.phone.SIP_SELECT_PHONE";
79     public static final String EXTRA_ALREADY_CALLED = "android.phone.extra.ALREADY_CALLED";
80     public static final String EXTRA_ORIGINAL_URI = "android.phone.extra.ORIGINAL_URI";
81     public static final String EXTRA_NEW_CALL_INTENT = "android.phone.extra.NEW_CALL_INTENT";
82     public static final String EXTRA_SIP_PHONE_URI = "android.phone.extra.SIP_PHONE_URI";
83     public static final String EXTRA_ACTUAL_NUMBER_TO_DIAL =
84             "android.phone.extra.ACTUAL_NUMBER_TO_DIAL";
85     public static final String EXTRA_THIRD_PARTY_CALL_COMPONENT =
86             "android.phone.extra.THIRD_PARTY_CALL_COMPONENT";
87 
88     /**
89      * Identifier for intent extra for sending an empty Flash message for
90      * CDMA networks. This message is used by the network to simulate a
91      * press/depress of the "hookswitch" of a landline phone. Aka "empty flash".
92      *
93      * TODO: Receiving an intent extra to tell the phone to send this flash is a
94      * temporary measure. To be replaced with an external ITelephony call in the future.
95      * TODO: Keep in sync with the string defined in TwelveKeyDialer.java in Contacts app
96      * until this is replaced with the ITelephony API.
97      */
98     public static final String EXTRA_SEND_EMPTY_FLASH =
99             "com.android.phone.extra.SEND_EMPTY_FLASH";
100 
101     // Dialog IDs
102     private static final int DIALOG_NOT_VOICE_CAPABLE = 1;
103 
104     /** Note message codes < 100 are reserved for the PhoneApp. */
105     private static final int EVENT_OUTGOING_CALL_TIMEOUT = 101;
106     private static final int EVENT_DELAYED_FINISH = 102;
107 
108     private static final int OUTGOING_CALL_TIMEOUT_THRESHOLD = 2000; // msec
109     private static final int DELAYED_FINISH_TIME = 2000; // msec
110 
111     /**
112      * ProgressBar object with "spinner" style, which will be shown if we take more than
113      * {@link #EVENT_OUTGOING_CALL_TIMEOUT} msec to handle the incoming Intent.
114      */
115     private ProgressBar mWaitingSpinner;
116     private final Handler mHandler = new Handler() {
117         @Override
118         public void handleMessage(Message msg) {
119             if (msg.what == EVENT_OUTGOING_CALL_TIMEOUT) {
120                 Log.i(TAG, "Outgoing call takes too long. Showing the spinner.");
121                 mWaitingSpinner.setVisibility(View.VISIBLE);
122             } else if (msg.what == EVENT_DELAYED_FINISH) {
123                 finish();
124             } else {
125                 Log.wtf(TAG, "Unknown message id: " + msg.what);
126             }
127         }
128     };
129 
130     /**
131      * Starts the delayed finish() of OutgoingCallBroadcaster in order to give the UI
132      * some time to start up.
133      */
startDelayedFinish()134     private void startDelayedFinish() {
135         mHandler.sendEmptyMessageDelayed(EVENT_DELAYED_FINISH, DELAYED_FINISH_TIME);
136     }
137 
138     /**
139      * OutgoingCallReceiver finishes NEW_OUTGOING_CALL broadcasts, starting
140      * the InCallScreen if the broadcast has not been canceled, possibly with
141      * a modified phone number and optional provider info (uri + package name + remote views.)
142      */
143     public class OutgoingCallReceiver extends BroadcastReceiver {
144         private static final String TAG = "OutgoingCallReceiver";
145 
146         @Override
onReceive(Context context, Intent intent)147         public void onReceive(Context context, Intent intent) {
148             mHandler.removeMessages(EVENT_OUTGOING_CALL_TIMEOUT);
149             final boolean isAttemptingCall = doReceive(context, intent);
150             if (DBG) Log.v(TAG, "OutgoingCallReceiver is going to finish the Activity itself.");
151 
152             // We cannot finish the activity immediately here because it would cause the temporary
153             // black screen of OutgoingBroadcaster to go away and we need it to stay up until the
154             // UI (in a different process) has time to come up.
155             // However, if we know we are not attemping a call, we need to finish the activity
156             // immediately so that subsequent CALL intents will retrigger a new
157             // OutgoingCallReceiver. see b/10857203
158             if (isAttemptingCall) {
159                 startDelayedFinish();
160             } else {
161                 finish();
162             }
163         }
164 
165 
166         /**
167          * Handes receipt of ordered new_outgoing_call intent. Verifies that the return from the
168          * ordered intent is valid.
169          * @return true if the call is being attempted; false if we are canceling the call.
170          */
doReceive(Context context, Intent intent)171         public boolean doReceive(Context context, Intent intent) {
172             if (DBG) Log.v(TAG, "doReceive: " + intent);
173 
174             boolean alreadyCalled;
175             String number;
176             String originalUri;
177 
178             alreadyCalled = intent.getBooleanExtra(
179                     OutgoingCallBroadcaster.EXTRA_ALREADY_CALLED, false);
180             if (alreadyCalled) {
181                 if (DBG) Log.v(TAG, "CALL already placed -- returning.");
182                 return false;
183             }
184 
185             // Once the NEW_OUTGOING_CALL broadcast is finished, the resultData
186             // is used as the actual number to call. (If null, no call will be
187             // placed.)
188 
189             number = getResultData();
190             if (VDBG) Log.v(TAG, "- got number from resultData: '" + number + "'");
191 
192             final PhoneGlobals app = PhoneGlobals.getInstance();
193             final Phone phone = PhoneGlobals.getPhone();
194 
195             // OTASP-specific checks.
196             // TODO: This should probably all happen in
197             // OutgoingCallBroadcaster.onCreate(), since there's no reason to
198             // even bother with the NEW_OUTGOING_CALL broadcast if we're going
199             // to disallow the outgoing call anyway...
200             if (TelephonyCapabilities.supportsOtasp(phone)) {
201                 boolean activateState = (app.cdmaOtaScreenState.otaScreenState
202                         == OtaUtils.CdmaOtaScreenState.OtaScreenState.OTA_STATUS_ACTIVATION);
203                 boolean dialogState = (app.cdmaOtaScreenState.otaScreenState
204                         == OtaUtils.CdmaOtaScreenState.OtaScreenState
205                         .OTA_STATUS_SUCCESS_FAILURE_DLG);
206                 boolean isOtaCallActive = false;
207 
208                 // TODO: Need cleaner way to check if OTA is active.
209                 // Also, this check seems to be broken in one obscure case: if
210                 // you interrupt an OTASP call by pressing Back then Skip,
211                 // otaScreenState somehow gets left in either PROGRESS or
212                 // LISTENING.
213                 if ((app.cdmaOtaScreenState.otaScreenState
214                         == OtaUtils.CdmaOtaScreenState.OtaScreenState.OTA_STATUS_PROGRESS)
215                         || (app.cdmaOtaScreenState.otaScreenState
216                         == OtaUtils.CdmaOtaScreenState.OtaScreenState.OTA_STATUS_LISTENING)) {
217                     isOtaCallActive = true;
218                 }
219 
220                 if (activateState || dialogState) {
221                     // The OTASP sequence is active, but either (1) the call
222                     // hasn't started yet, or (2) the call has ended and we're
223                     // showing the success/failure screen.  In either of these
224                     // cases it's OK to make a new outgoing call, but we need
225                     // to take down any OTASP-related UI first.
226                     if (dialogState) app.dismissOtaDialogs();
227                     app.clearOtaState();
228                 } else if (isOtaCallActive) {
229                     // The actual OTASP call is active.  Don't allow new
230                     // outgoing calls at all from this state.
231                     Log.w(TAG, "OTASP call is active: disallowing a new outgoing call.");
232                     return false;
233                 }
234             }
235 
236             if (number == null) {
237                 if (DBG) Log.v(TAG, "CALL cancelled (null number), returning...");
238                 return false;
239             } else if (TelephonyCapabilities.supportsOtasp(phone)
240                     && (phone.getState() != PhoneConstants.State.IDLE)
241                     && (phone.isOtaSpNumber(number))) {
242                 if (DBG) Log.v(TAG, "Call is active, a 2nd OTA call cancelled -- returning.");
243                 return false;
244             } else if (PhoneNumberUtils.isPotentialLocalEmergencyNumber(context, number)) {
245                 // Just like 3rd-party apps aren't allowed to place emergency
246                 // calls via the ACTION_CALL intent, we also don't allow 3rd
247                 // party apps to use the NEW_OUTGOING_CALL broadcast to rewrite
248                 // an outgoing call into an emergency number.
249                 Log.w(TAG, "Cannot modify outgoing call to emergency number " + number + ".");
250                 return false;
251             }
252 
253             originalUri = intent.getStringExtra(
254                     OutgoingCallBroadcaster.EXTRA_ORIGINAL_URI);
255             if (originalUri == null) {
256                 Log.e(TAG, "Intent is missing EXTRA_ORIGINAL_URI -- returning.");
257                 return false;
258             }
259 
260             Uri uri = Uri.parse(originalUri);
261 
262             // We already called convertKeypadLettersToDigits() and
263             // stripSeparators() way back in onCreate(), before we sent out the
264             // NEW_OUTGOING_CALL broadcast.  But we need to do it again here
265             // too, since the number might have been modified/rewritten during
266             // the broadcast (and may now contain letters or separators again.)
267             number = PhoneNumberUtils.convertKeypadLettersToDigits(number);
268             number = PhoneNumberUtils.stripSeparators(number);
269 
270             if (DBG) Log.v(TAG, "doReceive: proceeding with call...");
271             if (VDBG) Log.v(TAG, "- uri: " + uri);
272             if (VDBG) Log.v(TAG, "- actual number to dial: '" + number + "'");
273 
274             startSipCallOptionHandler(context, intent, uri, number);
275 
276             return true;
277         }
278     }
279 
280     /**
281      * Launch the SipCallOptionHandler, which is the next step(*) in the
282      * outgoing-call sequence after the outgoing call broadcast is
283      * complete.
284      *
285      * (*) We now know exactly what phone number we need to dial, so the next
286      *     step is for the SipCallOptionHandler to decide which Phone type (SIP
287      *     or PSTN) should be used.  (Depending on the user's preferences, this
288      *     decision may also involve popping up a dialog to ask the user to
289      *     choose what type of call this should be.)
290      *
291      * @param context used for the startActivity() call
292      *
293      * @param intent the intent from the previous step of the outgoing-call
294      *   sequence.  Normally this will be the NEW_OUTGOING_CALL broadcast intent
295      *   that came in to the OutgoingCallReceiver, although it can also be the
296      *   original ACTION_CALL intent that started the whole sequence (in cases
297      *   where we don't do the NEW_OUTGOING_CALL broadcast at all, like for
298      *   emergency numbers or SIP addresses).
299      *
300      * @param uri the data URI from the original CALL intent, presumably either
301      *   a tel: or sip: URI.  For tel: URIs, note that the scheme-specific part
302      *   does *not* necessarily have separators and keypad letters stripped (so
303      *   we might see URIs like "tel:(650)%20555-1234" or "tel:1-800-GOOG-411"
304      *   here.)
305      *
306      * @param number the actual number (or SIP address) to dial.  This is
307      *   guaranteed to be either a PSTN phone number with separators stripped
308      *   out and keypad letters converted to digits (like "16505551234"), or a
309      *   raw SIP address (like "user@example.com").
310      */
startSipCallOptionHandler(Context context, Intent intent, Uri uri, String number)311     private void startSipCallOptionHandler(Context context, Intent intent,
312             Uri uri, String number) {
313         // TODO: Remove this code.
314     }
315 
316     /**
317      * This method is the single point of entry for the CALL intent, which is used (by built-in
318      * apps like Contacts / Dialer, as well as 3rd-party apps) to initiate an outgoing voice call.
319      *
320      *
321      */
322     @Override
onCreate(Bundle icicle)323     protected void onCreate(Bundle icicle) {
324         super.onCreate(icicle);
325         setContentView(R.layout.outgoing_call_broadcaster);
326         mWaitingSpinner = (ProgressBar) findViewById(R.id.spinner);
327 
328         Intent intent = getIntent();
329         if (DBG) {
330             final Configuration configuration = getResources().getConfiguration();
331             Log.v(TAG, "onCreate: this = " + this + ", icicle = " + icicle);
332             Log.v(TAG, " - getIntent() = " + intent);
333             Log.v(TAG, " - configuration = " + configuration);
334         }
335 
336         if (icicle != null) {
337             // A non-null icicle means that this activity is being
338             // re-initialized after previously being shut down.
339             //
340             // In practice this happens very rarely (because the lifetime
341             // of this activity is so short!), but it *can* happen if the
342             // framework detects a configuration change at exactly the
343             // right moment; see bug 2202413.
344             //
345             // In this case, do nothing.  Our onCreate() method has already
346             // run once (with icicle==null the first time), which means
347             // that the NEW_OUTGOING_CALL broadcast for this new call has
348             // already been sent.
349             Log.i(TAG, "onCreate: non-null icicle!  "
350                   + "Bailing out, not sending NEW_OUTGOING_CALL broadcast...");
351 
352             // No need to finish() here, since the OutgoingCallReceiver from
353             // our original instance will do that.  (It'll actually call
354             // finish() on our original instance, which apparently works fine
355             // even though the ActivityManager has already shut that instance
356             // down.  And note that if we *do* call finish() here, that just
357             // results in an "ActivityManager: Duplicate finish request"
358             // warning when the OutgoingCallReceiver runs.)
359 
360             return;
361         }
362 
363         processIntent(intent);
364 
365         // isFinishing() return false when 1. broadcast is still ongoing, or 2. dialog is being
366         // shown. Otherwise finish() is called inside processIntent(), is isFinishing() here will
367         // return true.
368         if (DBG) Log.v(TAG, "At the end of onCreate(). isFinishing(): " + isFinishing());
369     }
370 
371     /**
372      * Interprets a given Intent and starts something relevant to the Intent.
373      *
374      * This method will handle three kinds of actions:
375      *
376      * - CALL (action for usual outgoing voice calls)
377      * - CALL_PRIVILEGED (can come from built-in apps like contacts / voice dialer / bluetooth)
378      * - CALL_EMERGENCY (from the EmergencyDialer that's reachable from the lockscreen.)
379      *
380      * The exact behavior depends on the intent's data:
381      *
382      * - The most typical is a tel: URI, which we handle by starting the
383      *   NEW_OUTGOING_CALL broadcast.  That broadcast eventually triggers
384      *   the sequence OutgoingCallReceiver -> SipCallOptionHandler ->
385      *   InCallScreen.
386      *
387      * - Or, with a sip: URI we skip the NEW_OUTGOING_CALL broadcast and
388      *   go directly to SipCallOptionHandler, which then leads to the
389      *   InCallScreen.
390      *
391      * - voicemail: URIs take the same path as regular tel: URIs.
392      *
393      * Other special cases:
394      *
395      * - Outgoing calls are totally disallowed on non-voice-capable
396      *   devices (see handleNonVoiceCapable()).
397      *
398      * - A CALL intent with the EXTRA_SEND_EMPTY_FLASH extra (and
399      *   presumably no data at all) means "send an empty flash" (which
400      *   is only meaningful on CDMA devices while a call is already
401      *   active.)
402      *
403      */
processIntent(Intent intent)404     private void processIntent(Intent intent) {
405         if (DBG) {
406             Log.v(TAG, "processIntent() = " + intent + ", thread: " + Thread.currentThread());
407         }
408         final Configuration configuration = getResources().getConfiguration();
409 
410         // Outgoing phone calls are only allowed on "voice-capable" devices.
411         if (!PhoneGlobals.sVoiceCapable) {
412             Log.i(TAG, "This device is detected as non-voice-capable device.");
413             handleNonVoiceCapable(intent);
414             return;
415         }
416 
417         String action = intent.getAction();
418         String number = PhoneNumberUtils.getNumberFromIntent(intent, this);
419         // Check the number, don't convert for sip uri
420         // TODO put uriNumber under PhoneNumberUtils
421         if (number != null) {
422             if (!PhoneNumberUtils.isUriNumber(number)) {
423                 number = PhoneNumberUtils.convertKeypadLettersToDigits(number);
424                 number = PhoneNumberUtils.stripSeparators(number);
425             }
426         } else {
427             Log.w(TAG, "The number obtained from Intent is null.");
428         }
429 
430         AppOpsManager appOps = (AppOpsManager)getSystemService(Context.APP_OPS_SERVICE);
431         int launchedFromUid;
432         String launchedFromPackage;
433         try {
434             launchedFromUid = ActivityManagerNative.getDefault().getLaunchedFromUid(
435                     getActivityToken());
436             launchedFromPackage = ActivityManagerNative.getDefault().getLaunchedFromPackage(
437                     getActivityToken());
438         } catch (RemoteException e) {
439             launchedFromUid = -1;
440             launchedFromPackage = null;
441         }
442         if (appOps.noteOpNoThrow(AppOpsManager.OP_CALL_PHONE, launchedFromUid, launchedFromPackage)
443                 != AppOpsManager.MODE_ALLOWED) {
444             Log.w(TAG, "Rejecting call from uid " + launchedFromUid + " package "
445                     + launchedFromPackage);
446             finish();
447             return;
448         }
449 
450         // If true, this flag will indicate that the current call is a special kind
451         // of call (most likely an emergency number) that 3rd parties aren't allowed
452         // to intercept or affect in any way.  (In that case, we start the call
453         // immediately rather than going through the NEW_OUTGOING_CALL sequence.)
454         boolean callNow;
455 
456         if (getClass().getName().equals(intent.getComponent().getClassName())) {
457             // If we were launched directly from the OutgoingCallBroadcaster,
458             // not one of its more privileged aliases, then make sure that
459             // only the non-privileged actions are allowed.
460             if (!Intent.ACTION_CALL.equals(intent.getAction())) {
461                 Log.w(TAG, "Attempt to deliver non-CALL action; forcing to CALL");
462                 intent.setAction(Intent.ACTION_CALL);
463             }
464         }
465 
466         // Check whether or not this is an emergency number, in order to
467         // enforce the restriction that only the CALL_PRIVILEGED and
468         // CALL_EMERGENCY intents are allowed to make emergency calls.
469         //
470         // (Note that the ACTION_CALL check below depends on the result of
471         // isPotentialLocalEmergencyNumber() rather than just plain
472         // isLocalEmergencyNumber(), to be 100% certain that we *don't*
473         // allow 3rd party apps to make emergency calls by passing in an
474         // "invalid" number like "9111234" that isn't technically an
475         // emergency number but might still result in an emergency call
476         // with some networks.)
477         final boolean isExactEmergencyNumber =
478                 (number != null) && PhoneNumberUtils.isLocalEmergencyNumber(this, number);
479         final boolean isPotentialEmergencyNumber =
480                 (number != null) && PhoneNumberUtils.isPotentialLocalEmergencyNumber(this, number);
481         if (VDBG) {
482             Log.v(TAG, " - Checking restrictions for number '" + number + "':");
483             Log.v(TAG, "     isExactEmergencyNumber     = " + isExactEmergencyNumber);
484             Log.v(TAG, "     isPotentialEmergencyNumber = " + isPotentialEmergencyNumber);
485         }
486 
487         /* Change CALL_PRIVILEGED into CALL or CALL_EMERGENCY as needed. */
488         // TODO: This code is redundant with some code in InCallScreen: refactor.
489         if (Intent.ACTION_CALL_PRIVILEGED.equals(action)) {
490             // We're handling a CALL_PRIVILEGED intent, so we know this request came
491             // from a trusted source (like the built-in dialer.)  So even a number
492             // that's *potentially* an emergency number can safely be promoted to
493             // CALL_EMERGENCY (since we *should* allow you to dial "91112345" from
494             // the dialer if you really want to.)
495             if (isPotentialEmergencyNumber) {
496                 Log.i(TAG, "ACTION_CALL_PRIVILEGED is used while the number is a potential"
497                         + " emergency number. Use ACTION_CALL_EMERGENCY as an action instead.");
498                 action = Intent.ACTION_CALL_EMERGENCY;
499             } else {
500                 action = Intent.ACTION_CALL;
501             }
502             if (DBG) Log.v(TAG, " - updating action from CALL_PRIVILEGED to " + action);
503             intent.setAction(action);
504         }
505 
506         if (Intent.ACTION_CALL.equals(action)) {
507             if (isPotentialEmergencyNumber) {
508                 Log.w(TAG, "Cannot call potential emergency number '" + number
509                         + "' with CALL Intent " + intent + ".");
510                 Log.i(TAG, "Launching default dialer instead...");
511 
512                 Intent invokeFrameworkDialer = new Intent();
513 
514                 // TwelveKeyDialer is in a tab so we really want
515                 // DialtactsActivity.  Build the intent 'manually' to
516                 // use the java resolver to find the dialer class (as
517                 // opposed to a Context which look up known android
518                 // packages only)
519                 final Resources resources = getResources();
520                 invokeFrameworkDialer.setClassName(
521                         resources.getString(R.string.ui_default_package),
522                         resources.getString(R.string.dialer_default_class));
523                 invokeFrameworkDialer.setAction(Intent.ACTION_DIAL);
524                 invokeFrameworkDialer.setData(intent.getData());
525                 if (DBG) Log.v(TAG, "onCreate(): calling startActivity for Dialer: "
526                                + invokeFrameworkDialer);
527                 startActivity(invokeFrameworkDialer);
528                 finish();
529                 return;
530             }
531             callNow = false;
532         } else if (Intent.ACTION_CALL_EMERGENCY.equals(action)) {
533             // ACTION_CALL_EMERGENCY case: this is either a CALL_PRIVILEGED
534             // intent that we just turned into a CALL_EMERGENCY intent (see
535             // above), or else it really is an CALL_EMERGENCY intent that
536             // came directly from some other app (e.g. the EmergencyDialer
537             // activity built in to the Phone app.)
538             // Make sure it's at least *possible* that this is really an
539             // emergency number.
540             if (!isPotentialEmergencyNumber) {
541                 Log.w(TAG, "Cannot call non-potential-emergency number " + number
542                         + " with EMERGENCY_CALL Intent " + intent + "."
543                         + " Finish the Activity immediately.");
544                 finish();
545                 return;
546             }
547             callNow = true;
548         } else {
549             Log.e(TAG, "Unhandled Intent " + intent + ". Finish the Activity immediately.");
550             finish();
551             return;
552         }
553 
554         // Make sure the screen is turned on.  This is probably the right
555         // thing to do, and more importantly it works around an issue in the
556         // activity manager where we will not launch activities consistently
557         // when the screen is off (since it is trying to keep them paused
558         // and has...  issues).
559         //
560         // Also, this ensures the device stays awake while doing the following
561         // broadcast; technically we should be holding a wake lock here
562         // as well.
563         PhoneGlobals.getInstance().wakeUpScreen();
564 
565         // If number is null, we're probably trying to call a non-existent voicemail number,
566         // send an empty flash or something else is fishy.  Whatever the problem, there's no
567         // number, so there's no point in allowing apps to modify the number.
568         if (TextUtils.isEmpty(number)) {
569             if (intent.getBooleanExtra(EXTRA_SEND_EMPTY_FLASH, false)) {
570                 Log.i(TAG, "onCreate: SEND_EMPTY_FLASH...");
571                 PhoneUtils.sendEmptyFlash(PhoneGlobals.getPhone());
572                 finish();
573                 return;
574             } else {
575                 Log.i(TAG, "onCreate: null or empty number, setting callNow=true...");
576                 callNow = true;
577             }
578         }
579 
580         if (callNow) {
581             // This is a special kind of call (most likely an emergency number)
582             // that 3rd parties aren't allowed to intercept or affect in any way.
583             // So initiate the outgoing call immediately.
584 
585             Log.i(TAG, "onCreate(): callNow case! Calling placeCall(): " + intent);
586 
587             // Initiate the outgoing call, and simultaneously launch the
588             // InCallScreen to display the in-call UI:
589             PhoneGlobals.getInstance().callController.placeCall(intent);
590 
591             // Note we do *not* "return" here, but instead continue and
592             // send the ACTION_NEW_OUTGOING_CALL broadcast like for any
593             // other outgoing call.  (But when the broadcast finally
594             // reaches the OutgoingCallReceiver, we'll know not to
595             // initiate the call again because of the presence of the
596             // EXTRA_ALREADY_CALLED extra.)
597         }
598 
599         // For now, SIP calls will be processed directly without a
600         // NEW_OUTGOING_CALL broadcast.
601         //
602         // TODO: In the future, though, 3rd party apps *should* be allowed to
603         // intercept outgoing calls to SIP addresses as well.  To do this, we should
604         // (1) update the NEW_OUTGOING_CALL intent documentation to explain this
605         // case, and (2) pass the outgoing SIP address by *not* overloading the
606         // EXTRA_PHONE_NUMBER extra, but instead using a new separate extra to hold
607         // the outgoing SIP address.  (Be sure to document whether it's a URI or just
608         // a plain address, whether it could be a tel: URI, etc.)
609         Uri uri = intent.getData();
610         String scheme = uri.getScheme();
611         if (PhoneAccount.SCHEME_SIP.equals(scheme) || PhoneNumberUtils.isUriNumber(number)) {
612             Log.i(TAG, "The requested number was detected as SIP call.");
613             startSipCallOptionHandler(this, intent, uri, number);
614             finish();
615             return;
616 
617             // TODO: if there's ever a way for SIP calls to trigger a
618             // "callNow=true" case (see above), we'll need to handle that
619             // case here too (most likely by just doing nothing at all.)
620         }
621 
622         Intent broadcastIntent = new Intent(Intent.ACTION_NEW_OUTGOING_CALL);
623         if (number != null) {
624             broadcastIntent.putExtra(Intent.EXTRA_PHONE_NUMBER, number);
625         }
626         CallGatewayManager.checkAndCopyPhoneProviderExtras(intent, broadcastIntent);
627         broadcastIntent.putExtra(EXTRA_ALREADY_CALLED, callNow);
628         broadcastIntent.putExtra(EXTRA_ORIGINAL_URI, uri.toString());
629         // Need to raise foreground in-call UI as soon as possible while allowing 3rd party app
630         // to intercept the outgoing call.
631         broadcastIntent.addFlags(Intent.FLAG_RECEIVER_FOREGROUND);
632         if (DBG) Log.v(TAG, " - Broadcasting intent: " + broadcastIntent + ".");
633 
634         // Set a timer so that we can prepare for unexpected delay introduced by the broadcast.
635         // If it takes too much time, the timer will show "waiting" spinner.
636         // This message will be removed when OutgoingCallReceiver#onReceive() is called before the
637         // timeout.
638         mHandler.sendEmptyMessageDelayed(EVENT_OUTGOING_CALL_TIMEOUT,
639                 OUTGOING_CALL_TIMEOUT_THRESHOLD);
640         sendOrderedBroadcastAsUser(broadcastIntent, UserHandle.OWNER,
641                 PERMISSION, new OutgoingCallReceiver(),
642                 null,  // scheduler
643                 Activity.RESULT_OK,  // initialCode
644                 number,  // initialData: initial value for the result data
645                 null);  // initialExtras
646     }
647 
648     @Override
onStop()649     protected void onStop() {
650         // Clean up (and dismiss if necessary) any managed dialogs.
651         //
652         // We don't do this in onPause() since we can be paused/resumed
653         // due to orientation changes (in which case we don't want to
654         // disturb the dialog), but we *do* need it here in onStop() to be
655         // sure we clean up if the user hits HOME while the dialog is up.
656         //
657         // Note it's safe to call removeDialog() even if there's no dialog
658         // associated with that ID.
659         removeDialog(DIALOG_NOT_VOICE_CAPABLE);
660 
661         super.onStop();
662     }
663 
664     /**
665      * Handle the specified CALL or CALL_* intent on a non-voice-capable
666      * device.
667      *
668      * This method may launch a different intent (if there's some useful
669      * alternative action to take), or otherwise display an error dialog,
670      * and in either case will finish() the current activity when done.
671      */
handleNonVoiceCapable(Intent intent)672     private void handleNonVoiceCapable(Intent intent) {
673         if (DBG) Log.v(TAG, "handleNonVoiceCapable: handling " + intent
674                        + " on non-voice-capable device...");
675 
676         // Just show a generic "voice calling not supported" dialog.
677         showDialog(DIALOG_NOT_VOICE_CAPABLE);
678         // ...and we'll eventually finish() when the user dismisses
679         // or cancels the dialog.
680     }
681 
682     @Override
onCreateDialog(int id)683     protected Dialog onCreateDialog(int id) {
684         Dialog dialog;
685         switch(id) {
686             case DIALOG_NOT_VOICE_CAPABLE:
687                 dialog = new AlertDialog.Builder(this)
688                         .setTitle(R.string.not_voice_capable)
689                         .setIconAttribute(android.R.attr.alertDialogIcon)
690                         .setPositiveButton(android.R.string.ok, this)
691                         .setOnCancelListener(this)
692                         .create();
693                 break;
694             default:
695                 Log.w(TAG, "onCreateDialog: unexpected ID " + id);
696                 dialog = null;
697                 break;
698         }
699         return dialog;
700     }
701 
702     /** DialogInterface.OnClickListener implementation */
703     @Override
onClick(DialogInterface dialog, int id)704     public void onClick(DialogInterface dialog, int id) {
705         // DIALOG_NOT_VOICE_CAPABLE is the only dialog we ever use (so far
706         // at least), and its only button is "OK".
707         finish();
708     }
709 
710     /** DialogInterface.OnCancelListener implementation */
711     @Override
onCancel(DialogInterface dialog)712     public void onCancel(DialogInterface dialog) {
713         // DIALOG_NOT_VOICE_CAPABLE is the only dialog we ever use (so far
714         // at least), and canceling it is just like hitting "OK".
715         finish();
716     }
717 
718     /**
719      * Implement onConfigurationChanged() purely for debugging purposes,
720      * to make sure that the android:configChanges element in our manifest
721      * is working properly.
722      */
723     @Override
onConfigurationChanged(Configuration newConfig)724     public void onConfigurationChanged(Configuration newConfig) {
725         super.onConfigurationChanged(newConfig);
726         if (DBG) Log.v(TAG, "onConfigurationChanged: newConfig = " + newConfig);
727     }
728 }
729