Share via


Connection.VideoProvider.OnSendSessionModifyRequest Method

Definition

Issues a request to modify the properties of the current video session.

[Android.Runtime.Register("onSendSessionModifyRequest", "(Landroid/telecom/VideoProfile;Landroid/telecom/VideoProfile;)V", "GetOnSendSessionModifyRequest_Landroid_telecom_VideoProfile_Landroid_telecom_VideoProfile_Handler", ApiSince=23)]
public abstract void OnSendSessionModifyRequest (Android.Telecom.VideoProfile? fromProfile, Android.Telecom.VideoProfile? toProfile);
[<Android.Runtime.Register("onSendSessionModifyRequest", "(Landroid/telecom/VideoProfile;Landroid/telecom/VideoProfile;)V", "GetOnSendSessionModifyRequest_Landroid_telecom_VideoProfile_Landroid_telecom_VideoProfile_Handler", ApiSince=23)>]
abstract member OnSendSessionModifyRequest : Android.Telecom.VideoProfile * Android.Telecom.VideoProfile -> unit

Parameters

fromProfile
VideoProfile

The video profile prior to the request.

toProfile
VideoProfile

The video profile with the requested changes made.

Attributes

Remarks

Issues a request to modify the properties of the current video session.

Example scenarios include: requesting an audio-only call to be upgraded to a bi-directional video call, turning on or off the user's camera, sending a pause signal when the InCallService is no longer the foreground application.

If the VideoProvider determines a request to be invalid, it should call #receiveSessionModifyResponse(int, VideoProfile, VideoProfile) to report the invalid request back to the InCallService.

Where a request requires confirmation from the user of the peer device, the VideoProvider must communicate the request to the peer device and handle the user's response. #receiveSessionModifyResponse(int, VideoProfile, VideoProfile) is used to inform the InCallService of the result of the request.

Sent from the InCallService via InCallService.VideoCall#sendSessionModifyRequest(VideoProfile).

Java documentation for android.telecom.Connection.VideoProvider.onSendSessionModifyRequest(android.telecom.VideoProfile, android.telecom.VideoProfile).

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