CallRedirectionService.OnPlaceCall Method

Definition

Namespace:: Android.Telecom

Assembly:: Mono.Android.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Overloads

Name	Description
OnPlaceCall(Uri, PhoneAccountHandle, Boolean)	Telecom calls this method once upon binding to a `CallRedirectionService` to inform it of a new outgoing call which is being placed.
OnPlaceCall(Uri, Uri, PhoneAccountHandle, Boolean)	Telecom calls this method once upon binding to a `CallRedirectionService` to inform it of a new outgoing call which is being placed.

OnPlaceCall(Uri, PhoneAccountHandle, Boolean)

Telecom calls this method once upon binding to a CallRedirectionService to inform it of a new outgoing call which is being placed.

[Android.Runtime.Register("onPlaceCall", "(Landroid/net/Uri;Landroid/telecom/PhoneAccountHandle;Z)V", "GetOnPlaceCall_Landroid_net_Uri_Landroid_telecom_PhoneAccountHandle_ZHandler", ApiSince=29)]
public abstract void OnPlaceCall(Android.Net.Uri handle, Android.Telecom.PhoneAccountHandle initialPhoneAccount, bool allowInteractiveResponse);

[<Android.Runtime.Register("onPlaceCall", "(Landroid/net/Uri;Landroid/telecom/PhoneAccountHandle;Z)V", "GetOnPlaceCall_Landroid_net_Uri_Landroid_telecom_PhoneAccountHandle_ZHandler", ApiSince=29)>]
abstract member OnPlaceCall : Android.Net.Uri * Android.Telecom.PhoneAccountHandle * bool -> unit

Parameters

handle: Uri

the phone number dialed by the user, represented in E.164 format if possible

initialPhoneAccount: PhoneAccountHandle

the PhoneAccountHandle on which the call will be placed.

allowInteractiveResponse: Boolean

a boolean to tell if the implemented CallRedirectionService should allow interactive responses with users. Will be false if, for example the device is in car mode and the user would not be able to interact with their device.

Attributes: RegisterAttribute

Remarks

Telecom calls this method once upon binding to a CallRedirectionService to inform it of a new outgoing call which is being placed. Telecom does not request to redirect emergency calls and does not request to redirect calls with gateway information.

Telecom will cancel the call if Telecom does not receive a response in 5 seconds from the implemented CallRedirectionService set by users.

The implemented CallRedirectionService can call #placeCallUnmodified(), #redirectCall(Uri, PhoneAccountHandle, boolean), and #cancelCall() only from here. Calls to these methods are assumed by the Telecom framework to be the response for the phone call for which #onPlaceCall(Uri, PhoneAccountHandle, boolean) was invoked by Telecom. The Telecom framework will only invoke #onPlaceCall(Uri, PhoneAccountHandle, boolean) once each time it binds to a CallRedirectionService.

Java documentation for android.telecom.CallRedirectionService.onPlaceCall(android.net.Uri, android.telecom.PhoneAccountHandle, boolean).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to

OnPlaceCall(Uri, Uri, PhoneAccountHandle, Boolean)

Telecom calls this method once upon binding to a CallRedirectionService to inform it of a new outgoing call which is being placed.

[Android.Runtime.Register("onPlaceCall", "(Landroid/net/Uri;Landroid/net/Uri;Landroid/telecom/PhoneAccountHandle;Z)V", "GetOnPlaceCall_Landroid_net_Uri_Landroid_net_Uri_Landroid_telecom_PhoneAccountHandle_ZHandler", ApiSince=37)]
public virtual void OnPlaceCall(Android.Net.Uri handle, Android.Net.Uri originalHandle, Android.Telecom.PhoneAccountHandle initialPhoneAccount, bool allowInteractiveResponse);

[<Android.Runtime.Register("onPlaceCall", "(Landroid/net/Uri;Landroid/net/Uri;Landroid/telecom/PhoneAccountHandle;Z)V", "GetOnPlaceCall_Landroid_net_Uri_Landroid_net_Uri_Landroid_telecom_PhoneAccountHandle_ZHandler", ApiSince=37)>]
abstract member OnPlaceCall : Android.Net.Uri * Android.Net.Uri * Android.Telecom.PhoneAccountHandle * bool -> unit
override this.OnPlaceCall : Android.Net.Uri * Android.Net.Uri * Android.Telecom.PhoneAccountHandle * bool -> unit

Parameters

handle: Uri

the phone number dialed by the user, represented in E.164 format

originalHandle: Uri

the phone number dialed by the user in the original format it was dialed (i.e. not E.164 format). This is helpful for numbers in some regions where formatting to E.164 can cause the loss of suffix digits that the service needs to know about.

initialPhoneAccount: PhoneAccountHandle

the PhoneAccountHandle on which the call will be placed.

allowInteractiveResponse: Boolean

Attributes: RegisterAttribute

Remarks

Telecom calls this method once upon binding to a CallRedirectionService to inform it of a new outgoing call which is being placed. Telecom does not request to redirect emergency calls and does not request to redirect calls with gateway information.

Telecom will cancel the call if Telecom does not receive a response in 5 seconds from the implemented CallRedirectionService set by users.

The implemented CallRedirectionService can call placeCallUnmodified(), redirectCall(Uri,PhoneAccountHandle,boolean), and cancelCall() only from here. Calls to these methods are assumed by the Telecom framework to be the response for the phone call for which onPlaceCall(Uri,PhoneAccountHandle,boolean) was invoked by Telecom. The Telecom framework will only invoke onPlaceCall(Uri,Uri,PhoneAccountHandle,boolean) once each time it binds to a CallRedirectionService.

This method is same as onPlaceCall(Uri,PhoneAccountHandle,boolean) above, but includes the original dial string.

Android reference for android.telecom.CallRedirectionService.onPlaceCall.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to