VoipCallCoordinator.RequestNewIncomingCall 方法

定义

命名空间:

Windows.ApplicationModel.Calls

重载

RequestNewIncomingCall(String, String, String, Uri, String, Uri, String, Uri, VoipPhoneCallMedia, TimeSpan)	向系统发出新的传入呼叫请求。
RequestNewIncomingCall(String, String, String, Uri, String, Uri, String, Uri, VoipPhoneCallMedia, TimeSpan, String)	向系统发出新的传入呼叫请求。

RequestNewIncomingCall(String, String, String, Uri, String, Uri, String, Uri, VoipPhoneCallMedia, TimeSpan)

向系统发出新的传入呼叫请求。

public:
 virtual VoipPhoneCall ^ RequestNewIncomingCall(Platform::String ^ context, Platform::String ^ contactName, Platform::String ^ contactNumber, Uri ^ contactImage, Platform::String ^ serviceName, Uri ^ brandingImage, Platform::String ^ callDetails, Uri ^ ringtone, VoipPhoneCallMedia media, TimeSpan ringTimeout) = RequestNewIncomingCall;

VoipPhoneCall RequestNewIncomingCall(winrt::hstring const& context, winrt::hstring const& contactName, winrt::hstring const& contactNumber, Uri const& contactImage, winrt::hstring const& serviceName, Uri const& brandingImage, winrt::hstring const& callDetails, Uri const& ringtone, VoipPhoneCallMedia const& media, TimeSpan const& ringTimeout);

public VoipPhoneCall RequestNewIncomingCall(string context, string contactName, string contactNumber, System.Uri contactImage, string serviceName, System.Uri brandingImage, string callDetails, System.Uri ringtone, VoipPhoneCallMedia media, System.TimeSpan ringTimeout);

function requestNewIncomingCall(context, contactName, contactNumber, contactImage, serviceName, brandingImage, callDetails, ringtone, media, ringTimeout)

Public Function RequestNewIncomingCall (context As String, contactName As String, contactNumber As String, contactImage As Uri, serviceName As String, brandingImage As Uri, callDetails As String, ringtone As Uri, media As VoipPhoneCallMedia, ringTimeout As TimeSpan) As VoipPhoneCall

参数

context

String

Platform::String

winrt::hstring

作为深层链接传递给关联的前台应用的字符串。 最大长度为 128 个字符。 此参数必须为非 null。

contactName

String

Platform::String

winrt::hstring

要显示在传入呼叫 UI 上的呼叫者的联系人姓名。 最大长度为 128 个字符。

contactNumber

String

Platform::String

winrt::hstring

要显示在传入呼叫 UI 上的呼叫者的电话号码。 最大长度为 128 个字符。

contactImage

Uri Uri

与要显示在传入呼叫 UI 上的调用方关联的图像文件的 URI。 文件类型必须是 PNG 或 JPG。 最大文件大小为 1MB。

serviceName

String

Platform::String

winrt::hstring

VoIP 服务或应用程序的名称。 最大长度为 128 个字符。

brandingImage

Uri Uri

图像文件的 URI，该文件是要在传入呼叫 UI 上显示的 VoIP 服务或应用程序的徽标或图标。 文件类型必须是 PNG 或 JPG。 最大文件大小为 128KB。

callDetails

String

Platform::String

winrt::hstring

一个字符串，指示呼叫代表谁。 最大长度为 128 个字符。

ringtone

Uri Uri

包含此呼叫的铃声的音频文件的 URI。 文件类型必须为 WMA 或 MP3。 最大文件大小为 1MB。

media

VoipPhoneCallMedia

新的传入呼叫的媒体类型 (音频和视频或仅音频) 。 传递 音频 |视频 ：用户应选择使用传出视频接听呼叫。 这假定用户的设备有一个摄像头可供应用在呼叫到达时使用。 如果不是这种情况，或者用户只应使用音频，请传递 音频。

ringTimeout

TimeSpan TimeSpan

在拒绝呼叫之前，系统应等待用户接听或忽略呼叫的时间（以秒为单位）。 允许的范围是 5 到 120 秒。 默认值为 30 秒。

返回

VoipPhoneCall

表示新的传入呼叫的 对象。

Windows 要求

应用功能	phoneCallHistory phoneCallHistorySystem voipCall

RequestNewIncomingCall(String, String, String, Uri, String, Uri, String, Uri, VoipPhoneCallMedia, TimeSpan, String)

向系统发出新的传入呼叫请求。

public:
 virtual VoipPhoneCall ^ RequestNewIncomingCall(Platform::String ^ context, Platform::String ^ contactName, Platform::String ^ contactNumber, Uri ^ contactImage, Platform::String ^ serviceName, Uri ^ brandingImage, Platform::String ^ callDetails, Uri ^ ringtone, VoipPhoneCallMedia media, TimeSpan ringTimeout, Platform::String ^ contactRemoteId) = RequestNewIncomingCall;

/// [Windows.Foundation.Metadata.Overload("RequestNewIncomingCallWithContactRemoteId")]
VoipPhoneCall RequestNewIncomingCall(winrt::hstring const& context, winrt::hstring const& contactName, winrt::hstring const& contactNumber, Uri const& contactImage, winrt::hstring const& serviceName, Uri const& brandingImage, winrt::hstring const& callDetails, Uri const& ringtone, VoipPhoneCallMedia const& media, TimeSpan const& ringTimeout, winrt::hstring const& contactRemoteId);

[Windows.Foundation.Metadata.Overload("RequestNewIncomingCallWithContactRemoteId")]
public VoipPhoneCall RequestNewIncomingCall(string context, string contactName, string contactNumber, System.Uri contactImage, string serviceName, System.Uri brandingImage, string callDetails, System.Uri ringtone, VoipPhoneCallMedia media, System.TimeSpan ringTimeout, string contactRemoteId);

function requestNewIncomingCall(context, contactName, contactNumber, contactImage, serviceName, brandingImage, callDetails, ringtone, media, ringTimeout, contactRemoteId)

Public Function RequestNewIncomingCall (context As String, contactName As String, contactNumber As String, contactImage As Uri, serviceName As String, brandingImage As Uri, callDetails As String, ringtone As Uri, media As VoipPhoneCallMedia, ringTimeout As TimeSpan, contactRemoteId As String) As VoipPhoneCall

参数

context

String

Platform::String

winrt::hstring

作为深层链接传递给关联的前台应用的字符串。 最大长度为 128 个字符。 此参数必须为非 null。

contactName

String

Platform::String

winrt::hstring

要显示在传入呼叫 UI 上的呼叫者的联系人姓名。 最大长度为 128 个字符。

contactNumber

String

Platform::String

winrt::hstring

要显示在传入呼叫 UI 上的呼叫者的电话号码。 最大长度为 128 个字符。

contactImage

Uri Uri

与要显示在传入呼叫 UI 上的调用方关联的图像文件的 URI。 文件类型必须是 PNG 或 JPG。 最大文件大小为 1MB。

serviceName

String

Platform::String

winrt::hstring

VoIP 服务或应用程序的名称。 最大长度为 128 个字符。

brandingImage

Uri Uri

图像文件的 URI，该文件是要在传入呼叫 UI 上显示的 VoIP 服务或应用程序的徽标或图标。 文件类型必须是 PNG 或 JPG。 最大文件大小为 128KB。

callDetails

String

Platform::String

winrt::hstring

一个字符串，指示呼叫代表谁。 最大长度为 128 个字符。

ringtone

Uri Uri

包含此呼叫的铃声的音频文件的 URI。 文件类型必须为 WMA 或 MP3。 最大文件大小为 1MB。

media

VoipPhoneCallMedia

新的传入呼叫的媒体类型 (音频和视频或仅音频) 。 传递 音频 |视频 ：用户应选择使用传出视频接听呼叫。 这假定用户的设备有一个摄像头可供应用在呼叫到达时使用。 如果不是这种情况，或者用户只应使用音频，请传递 音频。

ringTimeout

TimeSpan TimeSpan

在拒绝呼叫之前，系统应等待用户接听或忽略呼叫的时间（以秒为单位）。 允许的范围是 5 到 120 秒。 默认值为 30 秒。

contactRemoteId

String

Platform::String

winrt::hstring

呼叫者的联系人远程 ID。 最大长度为 256 个字符。

返回

VoipPhoneCall

表示新的传入呼叫的 对象。

属性

OverloadAttribute

Windows 要求

设备系列	Windows 10, version 1803 (在 10.0.17134.0 中引入)
API contract	Windows.ApplicationModel.Calls.CallsVoipContract (在 v3.0 中引入)
应用功能	voipCall

注解

当用户打开免打扰时间时，请使用此方法。 如果呼叫者的联系人远程 ID 位于免打扰小时突破列表中，则会连接呼叫，并显示传入呼叫通知。 否则，呼叫将不会连接，并且不会显示通知。