TelecomManager

Activity action: Shows a dialog asking the user whether or not they want to replace the current default Dialer with the one specified in EXTRA_CHANGE_DEFAULT_DIALER_PACKAGE_NAME. Usage example:

 Intent intent = new Intent(TelecomManager.ACTION_CHANGE_DEFAULT_DIALER);
 intent.putExtra(TelecomManager.EXTRA_CHANGE_DEFAULT_DIALER_PACKAGE_NAME,
         getActivity().getPackageName());
 startActivity(intent);
 

The Intent action used to show the settings page used to configure PhoneAccount preferences.

An Intent action sent by the telecom framework to start a configuration dialog for a registered PhoneAccount. There is no default dialog and each app that registers a PhoneAccount should provide one if desired.

A user can access the list of enabled PhoneAccounts through the Phone app's settings menu. For each entry, the settings app will add a click action. When triggered, the click-action will start this intent along with the extra EXTRA_PHONE_ACCOUNT_HANDLE to indicate the PhoneAccount to configure. If the PhoneAccount package does not register an Activity for this intent, then it will not be sent.

Broadcast intent action indicating that the current default dialer has changed. The string extra EXTRA_CHANGE_DEFAULT_DIALER_PACKAGE_NAME will contain the name of the package that the default dialer was changed to.

Activity action: Starts the UI for handing an incoming call. This intent starts the in-call UI by notifying the Telecom system that an incoming call exists for a specific call service (see ConnectionService). Telecom reads the Intent extras to find and bind to the appropriate ConnectionService which Telecom will ultimately use to control and get information about the call.

Input: get*Extra field EXTRA_PHONE_ACCOUNT_HANDLE contains the component name of the ConnectionService that Telecom should bind to. Telecom will then ask the connection service for more information about the call prior to showing any UI.

The Intent action used to show the call accessibility settings page.

The Intent action used to show the call settings page.

The Intent action used to show the respond via SMS settings page.

The dual tone multi-frequency signaling character sent to indicate the dialing system should pause for a predefined period.

The dual-tone multi-frequency signaling character sent to indicate the dialing system should wait for user confirmation before proceeding.

The number which the party on the other side of the line will see (and use to return the call).

ConnectionServices which interact with RemoteConnections should only populate this if the getLine1Number() value, as that is the user's expected caller ID.

Optional extra for ACTION_PHONE_STATE_CHANGED containing the disconnect code.

Optional extra for ACTION_PHONE_STATE_CHANGED containing the disconnect message.

Optional extra for ACTION_CALL containing a string call subject which will be associated with an outgoing call. Should only be specified if the PhoneAccount supports the capability CAPABILITY_CALL_SUBJECT.

Extra value used to provide the package name for ACTION_CHANGE_DEFAULT_DIALER.

The extra used by a ConnectionService to provide the handle of the caller that has initiated a new incoming call.

Optional extra for ACTION_INCOMING_CALL containing a Bundle which contains metadata about the call. This Bundle will be returned to the ConnectionService.

Optional extra for ACTION_CALL and ACTION_DIAL Intent containing a Bundle which contains metadata about the call. This Bundle will be saved into Call.Details and passed to the ConnectionService when placing the call.

The extra used with an ACTION_CALL and ACTION_DIAL Intent to specify a PhoneAccountHandle to use when making the call.

Retrieve with getParcelableExtra(String).

Optional extra for ACTION_CALL containing a boolean that determines whether the speakerphone should be automatically turned on for an outgoing call.

Optional extra for ACTION_CALL containing an integer that determines the desired video state for an outgoing call. Valid options: STATE_AUDIO_ONLY, STATE_BIDIRECTIONAL, STATE_RX_ENABLED, STATE_TX_ENABLED.

An optional ACTION_CALL intent extra corresponding to the original address to dial for the call. This is used when an alternative gateway address is provided to recall the original address. The value is a Uri. (See GATEWAY_PROVIDER_PACKAGE for details)

An optional ACTION_CALL intent extra denoting the package name of the app specifying an alternative gateway for the call. The value is a string. (The following comment corresponds to the all GATEWAY_* extras) An app which sends the ACTION_CALL intent can specify an alternative address to dial which is different from the one specified and displayed to the user. This alternative address is referred to as the gateway address.

A boolean meta-data value indicating whether an InCallService implements an in-call user interface. Dialer implementations (see getDefaultDialerPackage()) which would also like to replace the in-call interface should set this meta-data to true in the manifest registration of their InCallService.

Indicates that the address or number of a call is allowed to be displayed for caller ID.

Indicates that the address or number of a call belongs to a pay phone.

Indicates that the address or number of a call is blocked by the other party.

Indicates that the address or number of a call is not specified or known by the carrier.

Registers a new incoming call. A ConnectionService should invoke this method when it has an incoming call. The specified PhoneAccountHandle must have been registered with registerPhoneAccount(PhoneAccount). Once invoked, this method will cause the system to bind to the ConnectionService associated with the PhoneAccountHandle and request additional information about the call (See onCreateIncomingConnection(PhoneAccountHandle, ConnectionRequest)) before starting the incoming call UI.

Removes the missed-call notification if one is present.

Requires that the method-caller be set as the system dialer app.

Returns a list of PhoneAccountHandles which can be used to make and receive phone calls. The returned list includes only those accounts which have been explicitly enabled by the user.

Used to determine the currently selected default dialer package.

Return the PhoneAccount which will be used to place outgoing calls to addresses with the specified uriScheme. This PhoneAccount will always be a member of the list which is returned from invoking getCallCapablePhoneAccounts(). The specific account returned depends on the following priorities:

• If the user-selected default PhoneAccount supports the specified scheme, it will be returned.
• If there exists only one PhoneAccount that supports the specified scheme, it will be returned.

If no PhoneAccount fits the criteria above, this method will return null.

Return the line 1 phone number for given phone account.

Return the PhoneAccount for a specified PhoneAccountHandle. Object includes resources which can be used in a user interface.

Returns the current SIM call manager. Apps must be prepared for this method to return null, indicating that there currently exists no user-chosen default PhoneAccount.

Return the voicemail number for a given phone account.

Processes the specified dial string as an MMI code. MMI codes are any sequence of characters entered into the dialpad that contain a "*" or "#". Some of these sequences launch special behavior through handled by Telephony. This method uses the default subscription.

Requires that the method-caller be set as the system dialer app.

Processes the specified dial string as an MMI code. MMI codes are any sequence of characters entered into the dialpad that contain a "*" or "#". Some of these sequences launch special behavior through handled by Telephony.

Requires that the method-caller be set as the system dialer app.

Returns whether there is an ongoing phone call (can be in dialing, ringing, active or holding states).

Requires permission: READ_PHONE_STATE

Return whether a given phone number is the configured voicemail number for a particular phone account.

Places a new outgoing call to the provided address using the system telecom service with the specified extras. This method is equivalent to placing an outgoing call using ACTION_CALL, except that the outgoing call will always be sent via the system telecom service. If method-caller is either the user selected default dialer app or preloaded system dialer app, then emergency calls will also be allowed. Requires permission: CALL_PHONE Usage example:

 Uri uri = Uri.fromParts("tel", "12345", null);
 Bundle extras = new Bundle();
 extras.putBoolean(TelecomManager.EXTRA_START_CALL_WITH_SPEAKERPHONE, true);
 telecomManager.placeCall(uri, extras);
 

• EXTRA_OUTGOING_CALL_EXTRAS
• EXTRA_PHONE_ACCOUNT_HANDLE
• EXTRA_START_CALL_WITH_SPEAKERPHONE
• EXTRA_START_CALL_WITH_VIDEO_STATE

Register a PhoneAccount for use by the system. When registering PhoneAccounts, existing registrations will be overwritten if the PhoneAccountHandle matches that of a PhoneAccount which is already registered. Once registered, the PhoneAccount is listed to the user as an option when placing calls. The user may still need to enable the PhoneAccount within the phone app settings before the account is usable.

A SecurityException will be thrown if an app tries to register a PhoneAccountHandle where the package name specified within getComponentName() does not match the package name of the app.

Brings the in-call screen to the foreground if there is an ongoing call. If there is currently no ongoing call, then this method does nothing.

Requires that the method-caller be set as the system dialer app or have the READ_PHONE_STATE permission.

Silences the ringer if a ringing call exists.

Remove a PhoneAccount registration from the system.