ACTION_NEW_OUTGOING_CALL constant

  1. @deprecated
String const ACTION_NEW_OUTGOING_CALL

Broadcast Action: An outgoing call is about to be placed.

The Intent will have the following extra value:

  • {@link android.content.Intent#EXTRA_PHONE_NUMBER} - the phone number originally intended to be dialed.

Once the broadcast is finished, the resultData is used as the actual number to call. If null, no call will be placed.

It is perfectly acceptable for multiple receivers to process the outgoing call in turn: for example, a parental control application might verify that the user is authorized to place the call at that time, then a number-rewriting application might add an area code if one was not specified.

For consistency, any receiver whose purpose is to prohibit phone calls should have a priority of 0, to ensure it will see the const phone number to be dialed. Any receiver whose purpose is to rewrite phone numbers to be called should have a positive priority. Negative priorities are reserved for the system for this broadcast; using them may cause problems.

Any BroadcastReceiver receiving this Intent must not abort the broadcast.

Emergency calls cannot be intercepted using this mechanism, and other calls cannot be modified to call emergency numbers using this mechanism.

Some apps (such as VoIP apps) may want to redirect the outgoing call to use their own service instead. Those apps should first prevent the call from being placed by setting resultData to null and then start their own app to make the call.

You must hold the {@link android.Manifest.permission#PROCESS_OUTGOING_CALLS} permission to receive this Intent.

This is a protected intent that can only be sent by the system.

If the user has chosen a {@link android.telecom.CallRedirectionService} to handle redirection of outgoing calls, this intent will NOT be sent as an ordered broadcast. This means that attempts to re-write the outgoing call by other apps using this intent will be ignored.

@deprecated Apps that redirect outgoing calls should use the {@link android.telecom.CallRedirectionService} API. Apps that perform call screening should use the {@link android.telecom.CallScreeningService} API. Apps which need to be notified of basic call state should use {@link android.telephony.PhoneStateListener#onCallStateChanged(int, String)} to determine when a new outgoing call is placed.

Implementation

@deprecated
static const String ACTION_NEW_OUTGOING_CALL =
    "android.intent.action.NEW_OUTGOING_CALL";