1 /* 2 * Copyright (C) 2014 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.server.telecom; 18 19 import android.app.Activity; 20 import android.content.BroadcastReceiver; 21 import android.content.Context; 22 import android.content.Intent; 23 import android.content.res.Resources; 24 import android.net.Uri; 25 import android.os.UserHandle; 26 import android.telecom.GatewayInfo; 27 import android.telecom.PhoneAccount; 28 import android.telecom.TelecomManager; 29 import android.telecom.VideoProfile; 30 import android.telephony.DisconnectCause; 31 import android.telephony.PhoneNumberUtils; 32 import android.text.TextUtils; 33 34 // TODO: Needed for move to system service: import com.android.internal.R; 35 36 /** 37 * OutgoingCallIntentBroadcaster receives CALL and CALL_PRIVILEGED Intents, and broadcasts the 38 * ACTION_NEW_OUTGOING_CALL intent. ACTION_NEW_OUTGOING_CALL is an ordered broadcast intent which 39 * contains the phone number being dialed. Applications can use this intent to (1) see which numbers 40 * are being dialed, (2) redirect a call (change the number being dialed), or (3) prevent a call 41 * from being placed. 42 * 43 * After the other applications have had a chance to see the ACTION_NEW_OUTGOING_CALL intent, it 44 * finally reaches the {@link NewOutgoingCallBroadcastIntentReceiver}. 45 * 46 * Calls where no number is present (like for a CDMA "empty flash" or a nonexistent voicemail 47 * number) are exempt from being broadcast. 48 * 49 * Calls to emergency numbers are still broadcast for informative purposes. The call is placed 50 * prior to sending ACTION_NEW_OUTGOING_CALL and cannot be redirected nor prevented. 51 */ 52 class NewOutgoingCallIntentBroadcaster { 53 /** Required permission for any app that wants to consume ACTION_NEW_OUTGOING_CALL. */ 54 private static final String PERMISSION = android.Manifest.permission.PROCESS_OUTGOING_CALLS; 55 56 private static final String EXTRA_ACTUAL_NUMBER_TO_DIAL = 57 "android.telecom.extra.ACTUAL_NUMBER_TO_DIAL"; 58 59 /** 60 * Legacy string constants used to retrieve gateway provider extras from intents. These still 61 * need to be copied from the source call intent to the destination intent in order to 62 * support third party gateway providers that are still using old string constants in 63 * Telephony. 64 */ 65 public static final String EXTRA_GATEWAY_PROVIDER_PACKAGE = 66 "com.android.phone.extra.GATEWAY_PROVIDER_PACKAGE"; 67 public static final String EXTRA_GATEWAY_URI = "com.android.phone.extra.GATEWAY_URI"; 68 public static final String EXTRA_GATEWAY_ORIGINAL_URI = 69 "com.android.phone.extra.GATEWAY_ORIGINAL_URI"; 70 71 private final CallsManager mCallsManager; 72 private final Call mCall; 73 private final Intent mIntent; 74 private final Context mContext; 75 76 /* 77 * Whether or not the outgoing call intent originated from the default phone application. If 78 * so, it will be allowed to make emergency calls, even with the ACTION_CALL intent. 79 */ 80 private final boolean mIsDefaultOrSystemPhoneApp; 81 82 NewOutgoingCallIntentBroadcaster(Context context, CallsManager callsManager, Call call, 83 Intent intent, boolean isDefaultPhoneApp) { 84 mContext = context; 85 mCallsManager = callsManager; 86 mCall = call; 87 mIntent = intent; 88 mIsDefaultOrSystemPhoneApp = isDefaultPhoneApp; 89 } 90 91 /** 92 * Processes the result of the outgoing call broadcast intent, and performs callbacks to 93 * the OutgoingCallIntentBroadcasterListener as necessary. 94 */ 95 private class NewOutgoingCallBroadcastIntentReceiver extends BroadcastReceiver { 96 97 @Override 98 public void onReceive(Context context, Intent intent) { 99 Log.v(this, "onReceive: %s", intent); 100 101 // Once the NEW_OUTGOING_CALL broadcast is finished, the resultData is used as the 102 // actual number to call. (If null, no call will be placed.) 103 String resultNumber = getResultData(); 104 Log.v(this, "- got number from resultData: %s", Log.pii(resultNumber)); 105 106 boolean endEarly = false; 107 if (resultNumber == null) { 108 Log.v(this, "Call cancelled (null number), returning..."); 109 endEarly = true; 110 } else if (PhoneNumberUtils.isPotentialLocalEmergencyNumber(mContext, resultNumber)) { 111 Log.w(this, "Cannot modify outgoing call to emergency number %s.", resultNumber); 112 endEarly = true; 113 } 114 115 if (endEarly) { 116 if (mCall != null) { 117 mCall.disconnect(); 118 } 119 return; 120 } 121 122 Uri resultHandleUri = Uri.fromParts(PhoneNumberUtils.isUriNumber(resultNumber) ? 123 PhoneAccount.SCHEME_SIP : PhoneAccount.SCHEME_TEL, resultNumber, null); 124 125 Uri originalUri = mIntent.getData(); 126 127 if (originalUri.getSchemeSpecificPart().equals(resultNumber)) { 128 Log.v(this, "Call number unmodified after new outgoing call intent broadcast."); 129 } else { 130 Log.v(this, "Retrieved modified handle after outgoing call intent broadcast: " 131 + "Original: %s, Modified: %s", 132 Log.pii(originalUri), 133 Log.pii(resultHandleUri)); 134 } 135 136 GatewayInfo gatewayInfo = getGateWayInfoFromIntent(intent, resultHandleUri); 137 mCallsManager.placeOutgoingCall(mCall, resultHandleUri, gatewayInfo, 138 mIntent.getBooleanExtra(TelecomManager.EXTRA_START_CALL_WITH_SPEAKERPHONE, 139 false), 140 mIntent.getIntExtra(TelecomManager.EXTRA_START_CALL_WITH_VIDEO_STATE, 141 VideoProfile.VideoState.AUDIO_ONLY)); 142 } 143 } 144 145 /** 146 * Processes the supplied intent and starts the outgoing call broadcast process relevant to the 147 * intent. 148 * 149 * This method will handle three kinds of actions: 150 * 151 * - CALL (intent launched by all third party dialers) 152 * - CALL_PRIVILEGED (intent launched by system apps e.g. system Dialer, voice Dialer) 153 * - CALL_EMERGENCY (intent launched by lock screen emergency dialer) 154 * 155 * @return {@link CallActivity#OUTGOING_CALL_SUCCEEDED} if the call succeeded, and an 156 * appropriate {@link DisconnectCause} if the call did not, describing why it failed. 157 */ 158 int processIntent() { 159 Log.v(this, "Processing call intent in OutgoingCallIntentBroadcaster."); 160 161 Intent intent = mIntent; 162 String action = intent.getAction(); 163 final Uri handle = intent.getData(); 164 165 if (handle == null) { 166 Log.w(this, "Empty handle obtained from the call intent."); 167 return DisconnectCause.INVALID_NUMBER; 168 } 169 170 boolean isVoicemailNumber = PhoneAccount.SCHEME_VOICEMAIL.equals(handle.getScheme()); 171 if (isVoicemailNumber) { 172 if (Intent.ACTION_CALL.equals(action)) { 173 // Voicemail calls will be handled directly by the telephony connection manager 174 Log.i(this, "Placing call immediately instead of waiting for " 175 + " OutgoingCallBroadcastReceiver: %s", intent); 176 177 boolean speakerphoneOn = mIntent.getBooleanExtra( 178 TelecomManager.EXTRA_START_CALL_WITH_SPEAKERPHONE, false); 179 mCallsManager.placeOutgoingCall(mCall, handle, null, speakerphoneOn, 180 VideoProfile.VideoState.AUDIO_ONLY); 181 182 return DisconnectCause.NOT_DISCONNECTED; 183 } else { 184 Log.i(this, "Unhandled intent %s. Ignoring and not placing call.", intent); 185 return DisconnectCause.OUTGOING_CANCELED; 186 } 187 } 188 189 String number = PhoneNumberUtils.getNumberFromIntent(intent, mContext); 190 if (TextUtils.isEmpty(number)) { 191 Log.w(this, "Empty number obtained from the call intent."); 192 return DisconnectCause.NO_PHONE_NUMBER_SUPPLIED; 193 } 194 195 boolean isUriNumber = PhoneNumberUtils.isUriNumber(number); 196 if (!isUriNumber) { 197 number = PhoneNumberUtils.convertKeypadLettersToDigits(number); 198 number = PhoneNumberUtils.stripSeparators(number); 199 } 200 201 final boolean isPotentialEmergencyNumber = isPotentialEmergencyNumber(number); 202 Log.v(this, "isPotentialEmergencyNumber = %s", isPotentialEmergencyNumber); 203 204 rewriteCallIntentAction(intent, isPotentialEmergencyNumber); 205 action = intent.getAction(); 206 // True for certain types of numbers that are not intended to be intercepted or modified 207 // by third parties (e.g. emergency numbers). 208 boolean callImmediately = false; 209 210 if (Intent.ACTION_CALL.equals(action)) { 211 if (isPotentialEmergencyNumber) { 212 if (!mIsDefaultOrSystemPhoneApp) { 213 Log.w(this, "Cannot call potential emergency number %s with CALL Intent %s " 214 + "unless caller is system or default dialer.", number, intent); 215 launchSystemDialer(intent.getData()); 216 return DisconnectCause.OUTGOING_CANCELED; 217 } else { 218 callImmediately = true; 219 } 220 } 221 } else if (Intent.ACTION_CALL_EMERGENCY.equals(action)) { 222 if (!isPotentialEmergencyNumber) { 223 Log.w(this, "Cannot call non-potential-emergency number %s with EMERGENCY_CALL " 224 + "Intent %s.", number, intent); 225 return DisconnectCause.OUTGOING_CANCELED; 226 } 227 callImmediately = true; 228 } else { 229 Log.w(this, "Unhandled Intent %s. Ignoring and not placing call.", intent); 230 return DisconnectCause.INVALID_NUMBER; 231 } 232 233 if (callImmediately) { 234 Log.i(this, "Placing call immediately instead of waiting for " 235 + " OutgoingCallBroadcastReceiver: %s", intent); 236 String scheme = isUriNumber ? PhoneAccount.SCHEME_SIP : PhoneAccount.SCHEME_TEL; 237 boolean speakerphoneOn = mIntent.getBooleanExtra( 238 TelecomManager.EXTRA_START_CALL_WITH_SPEAKERPHONE, false); 239 int videoState = mIntent.getIntExtra( 240 TelecomManager.EXTRA_START_CALL_WITH_VIDEO_STATE, 241 VideoProfile.VideoState.AUDIO_ONLY); 242 mCallsManager.placeOutgoingCall(mCall, Uri.fromParts(scheme, number, null), null, 243 speakerphoneOn, videoState); 244 245 // Don't return but instead continue and send the ACTION_NEW_OUTGOING_CALL broadcast 246 // so that third parties can still inspect (but not intercept) the outgoing call. When 247 // the broadcast finally reaches the OutgoingCallBroadcastReceiver, we'll know not to 248 // initiate the call again because of the presence of the EXTRA_ALREADY_CALLED extra. 249 } 250 251 broadcastIntent(intent, number, !callImmediately); 252 return DisconnectCause.NOT_DISCONNECTED; 253 } 254 255 /** 256 * Sends a new outgoing call ordered broadcast so that third party apps can cancel the 257 * placement of the call or redirect it to a different number. 258 * 259 * @param originalCallIntent The original call intent. 260 * @param number Call number that was stored in the original call intent. 261 * @param receiverRequired Whether or not the result from the ordered broadcast should be 262 * processed using a {@link NewOutgoingCallIntentBroadcaster}. 263 */ 264 private void broadcastIntent( 265 Intent originalCallIntent, 266 String number, 267 boolean receiverRequired) { 268 Intent broadcastIntent = new Intent(Intent.ACTION_NEW_OUTGOING_CALL); 269 if (number != null) { 270 broadcastIntent.putExtra(Intent.EXTRA_PHONE_NUMBER, number); 271 } 272 273 // Force receivers of this broadcast intent to run at foreground priority because we 274 // want to finish processing the broadcast intent as soon as possible. 275 broadcastIntent.addFlags(Intent.FLAG_RECEIVER_FOREGROUND); 276 Log.v(this, "Broadcasting intent: %s.", broadcastIntent); 277 278 checkAndCopyProviderExtras(originalCallIntent, broadcastIntent); 279 280 mContext.sendOrderedBroadcastAsUser( 281 broadcastIntent, 282 UserHandle.CURRENT, 283 PERMISSION, 284 receiverRequired ? new NewOutgoingCallBroadcastIntentReceiver() : null, 285 null, // scheduler 286 Activity.RESULT_OK, // initialCode 287 number, // initialData: initial value for the result data (number to be modified) 288 null); // initialExtras 289 } 290 291 /** 292 * Copy all the expected extras set when a 3rd party gateway provider is to be used, from the 293 * source intent to the destination one. 294 * 295 * @param src Intent which may contain the provider's extras. 296 * @param dst Intent where a copy of the extras will be added if applicable. 297 */ 298 public void checkAndCopyProviderExtras(Intent src, Intent dst) { 299 if (src == null) { 300 return; 301 } 302 if (hasGatewayProviderExtras(src)) { 303 dst.putExtra(EXTRA_GATEWAY_PROVIDER_PACKAGE, 304 src.getStringExtra(EXTRA_GATEWAY_PROVIDER_PACKAGE)); 305 dst.putExtra(EXTRA_GATEWAY_URI, 306 src.getStringExtra(EXTRA_GATEWAY_URI)); 307 Log.d(this, "Found and copied gateway provider extras to broadcast intent."); 308 return; 309 } 310 311 Log.d(this, "No provider extras found in call intent."); 312 } 313 314 /** 315 * Check if valid gateway provider information is stored as extras in the intent 316 * 317 * @param intent to check for 318 * @return true if the intent has all the gateway information extras needed. 319 */ 320 private boolean hasGatewayProviderExtras(Intent intent) { 321 final String name = intent.getStringExtra(EXTRA_GATEWAY_PROVIDER_PACKAGE); 322 final String uriString = intent.getStringExtra(EXTRA_GATEWAY_URI); 323 324 return !TextUtils.isEmpty(name) && !TextUtils.isEmpty(uriString); 325 } 326 327 private static Uri getGatewayUriFromString(String gatewayUriString) { 328 return TextUtils.isEmpty(gatewayUriString) ? null : Uri.parse(gatewayUriString); 329 } 330 331 /** 332 * Extracts gateway provider information from a provided intent.. 333 * 334 * @param intent to extract gateway provider information from. 335 * @param trueHandle The actual call handle that the user is trying to dial 336 * @return GatewayInfo object containing extracted gateway provider information as well as 337 * the actual handle the user is trying to dial. 338 */ 339 public static GatewayInfo getGateWayInfoFromIntent(Intent intent, Uri trueHandle) { 340 if (intent == null) { 341 return null; 342 } 343 344 // Check if gateway extras are present. 345 String gatewayPackageName = intent.getStringExtra(EXTRA_GATEWAY_PROVIDER_PACKAGE); 346 Uri gatewayUri = getGatewayUriFromString(intent.getStringExtra(EXTRA_GATEWAY_URI)); 347 if (!TextUtils.isEmpty(gatewayPackageName) && gatewayUri != null) { 348 return new GatewayInfo(gatewayPackageName, gatewayUri, trueHandle); 349 } 350 351 return null; 352 } 353 354 private void launchSystemDialer(Uri handle) { 355 Intent systemDialerIntent = new Intent(); 356 final Resources resources = mContext.getResources(); 357 systemDialerIntent.setClassName( 358 resources.getString(R.string.ui_default_package), 359 resources.getString(R.string.dialer_default_class)); 360 systemDialerIntent.setAction(Intent.ACTION_DIAL); 361 systemDialerIntent.setData(handle); 362 systemDialerIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK); 363 Log.v(this, "calling startActivity for default dialer: %s", systemDialerIntent); 364 mContext.startActivityAsUser(systemDialerIntent, UserHandle.CURRENT); 365 } 366 367 /** 368 * Check whether or not this is an emergency number, in order to enforce the restriction 369 * that only the CALL_PRIVILEGED and CALL_EMERGENCY intents are allowed to make emergency 370 * calls. 371 * 372 * To prevent malicious 3rd party apps from making emergency calls by passing in an 373 * "invalid" number like "9111234" (that isn't technically an emergency number but might 374 * still result in an emergency call with some networks), we use 375 * isPotentialLocalEmergencyNumber instead of isLocalEmergencyNumber. 376 * 377 * @param number number to inspect in order to determine whether or not an emergency number 378 * is potentially being dialed 379 * @return True if the handle is potentially an emergency number. 380 */ 381 private boolean isPotentialEmergencyNumber(String number) { 382 Log.v(this, "Checking restrictions for number : %s", Log.pii(number)); 383 return (number != null) && PhoneNumberUtils.isPotentialLocalEmergencyNumber(mContext, 384 number); 385 } 386 387 /** 388 * Given a call intent and whether or not the number to dial is an emergency number, rewrite 389 * the call intent action to an appropriate one. 390 * 391 * @param intent Intent to rewrite the action for 392 * @param isPotentialEmergencyNumber Whether or not the number is potentially an emergency 393 * number. 394 */ 395 private void rewriteCallIntentAction(Intent intent, boolean isPotentialEmergencyNumber) { 396 String action = intent.getAction(); 397 398 /* Change CALL_PRIVILEGED into CALL or CALL_EMERGENCY as needed. */ 399 if (Intent.ACTION_CALL_PRIVILEGED.equals(action)) { 400 if (isPotentialEmergencyNumber) { 401 Log.i(this, "ACTION_CALL_PRIVILEGED is used while the number is a potential" 402 + " emergency number. Using ACTION_CALL_EMERGENCY as an action instead."); 403 action = Intent.ACTION_CALL_EMERGENCY; 404 } else { 405 action = Intent.ACTION_CALL; 406 } 407 Log.v(this, " - updating action from CALL_PRIVILEGED to %s", action); 408 intent.setAction(action); 409 } 410 } 411 } 412