Language

Call.ExtraCrsMediaType Field

Definition

Extra key to indicate the type of media a Customized Ringing Signal (CRS) call contains.

[Android.Runtime.Register("EXTRA_CRS_MEDIA_TYPE", ApiSince=37)]
public const string ExtraCrsMediaType;
[<Android.Runtime.Register("EXTRA_CRS_MEDIA_TYPE", ApiSince=37)>]
val mutable ExtraCrsMediaType : string

Field Value

Attributes

Remarks

Extra key to indicate the type of media a Customized Ringing Signal (CRS) call contains. The CRS is an operator-specific feature that allows a subscriber to customize the media played to the called party during the establishment of an incoming call. When the MT call is received, the device will present the CRS media instead of its standard ringtone. This CRS media can consist of audio, video, or any combination thereof.

To maintain compatibility with third-party dialer applications that are not CRS-aware, the public video state of the call (see Details.getVideoState()) will remain VideoProfile.STATE_AUDIO_ONLY even if the CRS call contains video.

A CRS-aware dialer should check for the presence of this extra. If the value includes the CRS_MEDIA_TYPE_VIDEO bit, the dialer is responsible for displaying the video to the user. The dialer can accomplish this by: Obtaining the InCallService.VideoCall instance from this call via getVideoCall(); Creating a Surface for video rendering; Passing the surface to the framework using InCallService.VideoCall.setDisplaySurface(Surface) The underlying IMS stack then handles the video streaming and rendering on the provided Surface.

The value associated with this key should be an integer bitmask of the following values:; Call.CRS_MEDIA_TYPE_AUDIO; Call.CRS_MEDIA_TYPE_VIDEO Connection.setExtras(Bundle) or Connection.putExtras(Bundle) should be used to notify Telecom that this extra has been set.

Android reference for android.telecom.Call.EXTRA_CRS_MEDIA_TYPE.

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