VoipCallCoordinator.RequestIncomingUpgradeToVideoCall | requestIncomingUpgradeToVideoCall method

Applies to Windows Phone only

Notifies the system of a new incoming video call that will replace an existing cellular call.

Syntax


voipCallCoordinator.requestIncomingUpgradeToVideoCall(context, contactName, contactNumber, contactImage, serviceName, brandingImage, callDetails, ringtone, ringTimeout);

Parameters

context

Type: String [JavaScript] | System.String [.NET] | Platform::String [C++]

A string that is passed to the associated foreground app as a deep link. This might be a contact name or other data that can be used to populate the app's UI more quickly. The maximum length is 128 characters. This parameter must be non-null and must refer to a task defined in the app's manifest file.

contactName

Type: String [JavaScript] | System.String [.NET] | Platform::String [C++]

The contact name of the caller to be displayed on the incoming call UI. The maximum length is 128 characters.

contactNumber

Type: String [JavaScript] | System.String [.NET] | Platform::String [C++]

The phone number of the caller to be displayed on the incoming call UI. The maximum length is 128 characters.

contactImage

Type: Windows.Foundation.Uri [JavaScript] | System.Uri [.NET] | Windows::Foundation::Uri [C++]

The Uri of an image file associated with the caller to be displayed on the incoming call UI. The file type must be PNG or JPG. The maximum file size is 1 MB.

serviceName

Type: String [JavaScript] | System.String [.NET] | Platform::String [C++]

The name of the VoIP service or application. The maximum length is 128 characters.

brandingImage

Type: Windows.Foundation.Uri [JavaScript] | System.Uri [.NET] | Windows::Foundation::Uri [C++]

The Uri of an image file that is a logo or icon of the VoIP service or application to be displayed on the incoming call UI. The file type must be PNG or JPG. The maximum file size is 128 KB.

callDetails

Type: String [JavaScript] | System.String [.NET] | Platform::String [C++]

A string indicating who the call is on behalf of. The maximum length is 128 characters.

ringtone

Type: Windows.Foundation.Uri [JavaScript] | System.Uri [.NET] | Windows::Foundation::Uri [C++]

The Uri of an audio file containing the ringtone for this call. The file type must be WMA or MP3. The maximum file size is 1 MB.

ringTimeout

Type: Number [JavaScript] | System.TimeSpan [.NET] | Windows::Foundation::TimeSpan [C++]

The time, in seconds, the system should wait for the user to answer or ignore the call before rejecting the call. The allowed range is 5 to 120 seconds. The default value is 30 seconds.

call (out parameter)

Type: VoipPhoneCall

The object representing the new incoming call.

Requirements

Minimum supported client

None supported

Minimum supported server

None supported

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 apps only]

End of phone support

Windows Phone 8.1 [Windows Phone Silverlight 8.1 apps only]

Namespace

Windows.Phone.Networking.Voip
Windows::Phone::Networking::Voip [C++]

Metadata

Windows.winmd

See also

VoipCallCoordinator

 

 

Community Additions

ADD
Show:
© 2014 Microsoft