CallControl.SetContactUri(Uri, IExecutor, IOutcomeReceiver) 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.

Sets the VoIP contact URI for an ongoing call.

[Android.Runtime.Register("setContactUri", "(Landroid/net/Uri;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "", ApiSince=37)]
public void SetContactUri(Android.Net.Uri? uri, Java.Util.Concurrent.IExecutor executor, Android.OS.IOutcomeReceiver callback);

[<Android.Runtime.Register("setContactUri", "(Landroid/net/Uri;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "", ApiSince=37)>]
member this.SetContactUri : Android.Net.Uri * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit

Parameters

uri: Uri

The content URI of the contact or group in the VoIP application's contact directory or a valid CP2 contact. This URI must be stable and resolvable by the system or null if unused.

executor: IExecutor

The Executor on which the OutcomeReceiver callback will be called on.

callback: IOutcomeReceiver

that will be completed on the Telecom side that details success or failure of the requested operation.

                          <code data-dev-comment-type="c">OutcomeReceiver#onResult</code> will be called if Telecom has successfully
                          switched the video state.

                          <code data-dev-comment-type="c">OutcomeReceiver#onError</code> will be called if Telecom has failed to set
                          the new video state.  A <code data-dev-comment-type="c">CallException</code> will be passed
                          that details why the operation failed.

Attributes: RegisterAttribute

Remarks

Sets the VoIP contact URI for an ongoing call.

This method should be invoked by a VoIP application. when a call transitions to or from being a group call. For instance, if a one-on-one call adds more participants and becomes a conference. This should be used in par with CallControl.setGroupCallState.

Providing this state allows the Android system to correctly represent the call in the system's user interface, such as the native call log. As part of the integrated call logs feature, which provides a unified history for both carrier and VoIP calls, accurately associating the calls with a valid lookup URI is essential for a consistent user experience.

The uri parameter is crucial for linking the call to a specific group entity within the VoIP contact directory or a CP2 contact. This helps in associating the call log entry with the correct contact information, such as the group's name and avatar.

Android reference for android.telecom.CallControl.setContactUri.

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