VoipCallCoordinator.RequestNewIncomingCall Methode

Definition

Namespace:

Windows.ApplicationModel.Calls

Überlädt

RequestNewIncomingCall(String, String, String, Uri, String, Uri, String, Uri, VoipPhoneCallMedia, TimeSpan)	Sendet eine Anforderung an das System für einen neuen eingehenden Anruf.
RequestNewIncomingCall(String, String, String, Uri, String, Uri, String, Uri, VoipPhoneCallMedia, TimeSpan, String)	Sendet eine Anforderung an das System für einen neuen eingehenden Anruf.

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

Sendet eine Anforderung an das System für einen neuen eingehenden Anruf.

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

Parameter

context

String

Platform::String

winrt::hstring

Eine Zeichenfolge, die als Deep Link an die zugeordnete Vordergrund-App übergeben wird. Die maximale Länge beträgt 128 Zeichen. Dieser Parameter muss ungleich NULL sein.

contactName

String

Platform::String

winrt::hstring

Der Kontaktname des Aufrufers, der auf der Benutzeroberfläche des eingehenden Anrufs angezeigt werden soll. Die maximale Länge beträgt 128 Zeichen.

contactNumber

String

Platform::String

winrt::hstring

Die Telefonnummer des Anrufers, der auf der Benutzeroberfläche für eingehende Anrufe angezeigt werden soll. Die maximale Länge beträgt 128 Zeichen.

contactImage

Uri Uri

Der URI einer Imagedatei, die dem Aufrufer zugeordnet ist, der auf der Benutzeroberfläche für eingehende Aufrufe angezeigt werden soll. Der Dateityp muss PNG oder JPG sein. Die maximale Dateigröße beträgt 1 MB.

serviceName

String

Platform::String

winrt::hstring

Der Name des VoIP-Diensts oder der VoIP-Anwendung. Die maximale Länge beträgt 128 Zeichen.

brandingImage

Uri Uri

Der URI einer Bilddatei, die ein Logo oder Symbol des VoIP-Diensts oder der VoIP-Anwendung ist, das auf der Benutzeroberfläche für eingehende Aufrufe angezeigt werden soll. Der Dateityp muss PNG oder JPG sein. Die maximale Dateigröße beträgt 128 KB.

callDetails

String

Platform::String

winrt::hstring

Eine Zeichenfolge, die angibt, für wen der Aufruf verwendet wird. Die maximale Länge beträgt 128 Zeichen.

ringtone

Uri Uri

Der URI einer Audiodatei, die den Klingelton für diesen Aufruf enthält. Der Dateityp muss WMA oder MP3 sein. Die maximale Dateigröße beträgt 1 MB.

media

VoipPhoneCallMedia

Die Medientypen des neuen eingehenden Anrufs (entweder Audio und Video oder nur Audio). Audio übergeben|Video, wenn der Benutzer die Möglichkeit haben soll, den Anruf mit ausgehendem Video zu beantworten. Dabei wird vorausgesetzt, dass das Gerät des Benutzers über eine Kamera verfügt, die die App zum Zeitpunkt des Anrufs verwenden kann. Wenn dies nicht der Fall ist oder der Benutzer nur Audio verwenden sollte, übergeben Sie Audio.

ringTimeout

TimeSpan TimeSpan

Die Zeit in Sekunden, die das System warten sollte, bis der Benutzer den Anruf beantwortet oder ignoriert, bevor der Anruf abgelehnt wird. Der zulässige Bereich beträgt 5 bis 120 Sekunden. Der Standardwert ist 30 Sekunden.

Gibt zurück

VoipPhoneCall

Das Objekt, das den neuen eingehenden Aufruf darstellt.

Windows-Anforderungen

App-Funktionen

phoneCallHistory phoneCallHistorySystem voipCall

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

Sendet eine Anforderung an das System für einen neuen eingehenden Anruf.

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

Parameter

context

String

Platform::String

winrt::hstring

Eine Zeichenfolge, die als Deep Link an die zugeordnete Vordergrund-App übergeben wird. Die maximale Länge beträgt 128 Zeichen. Dieser Parameter muss ungleich NULL sein.

contactName

String

Platform::String

winrt::hstring

Der Kontaktname des Aufrufers, der auf der Benutzeroberfläche des eingehenden Anrufs angezeigt werden soll. Die maximale Länge beträgt 128 Zeichen.

contactNumber

String

Platform::String

winrt::hstring

Die Telefonnummer des Anrufers, der auf der Benutzeroberfläche für eingehende Anrufe angezeigt werden soll. Die maximale Länge beträgt 128 Zeichen.

contactImage

Uri Uri

Der URI einer Imagedatei, die dem Aufrufer zugeordnet ist, der auf der Benutzeroberfläche für eingehende Aufrufe angezeigt werden soll. Der Dateityp muss PNG oder JPG sein. Die maximale Dateigröße beträgt 1 MB.

serviceName

String

Platform::String

winrt::hstring

Der Name des VoIP-Diensts oder der VoIP-Anwendung. Die maximale Länge beträgt 128 Zeichen.

brandingImage

Uri Uri

Der URI einer Bilddatei, die ein Logo oder Symbol des VoIP-Diensts oder der VoIP-Anwendung ist, das auf der Benutzeroberfläche für eingehende Aufrufe angezeigt werden soll. Der Dateityp muss PNG oder JPG sein. Die maximale Dateigröße beträgt 128 KB.

callDetails

String

Platform::String

winrt::hstring

Eine Zeichenfolge, die angibt, für wen der Aufruf verwendet wird. Die maximale Länge beträgt 128 Zeichen.

ringtone

Uri Uri

Der URI einer Audiodatei, die den Klingelton für diesen Aufruf enthält. Der Dateityp muss WMA oder MP3 sein. Die maximale Dateigröße beträgt 1 MB.

media

VoipPhoneCallMedia

Die Medientypen des neuen eingehenden Anrufs (entweder Audio und Video oder nur Audio). Audio übergeben|Video, wenn der Benutzer die Möglichkeit haben soll, den Anruf mit ausgehendem Video zu beantworten. Dabei wird vorausgesetzt, dass das Gerät des Benutzers über eine Kamera verfügt, die die App zum Zeitpunkt des Anrufs verwenden kann. Wenn dies nicht der Fall ist oder der Benutzer nur Audio verwenden sollte, übergeben Sie Audio.

ringTimeout

TimeSpan TimeSpan

Die Zeit in Sekunden, die das System warten sollte, bis der Benutzer den Anruf beantwortet oder ignoriert, bevor der Anruf abgelehnt wird. Der zulässige Bereich beträgt 5 bis 120 Sekunden. Der Standardwert ist 30 Sekunden.

contactRemoteId

String

Platform::String

winrt::hstring

Die Kontakt-Remote-ID des Aufrufers. Die maximale Länge beträgt 256 Zeichen.

Gibt zurück

VoipPhoneCall

Das Objekt, das den neuen eingehenden Aufruf darstellt.

Attribute

OverloadAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10, version 1803 (eingeführt in 10.0.17134.0)
API contract	Windows.ApplicationModel.Calls.CallsVoipContract (eingeführt in v3.0)
App-Funktionen	voipCall

Hinweise

Verwenden Sie diese Methode, wenn der Benutzer ruhige Stunden aktiviert hat. Wenn die Kontakt-Remote-ID des Anrufers in der Liste "Still Hour Breakthrough" aufgeführt ist, wird der Anruf verbunden, und es wird eine Benachrichtigung über eingehende Anrufe angezeigt. Andernfalls wird der Anruf nicht verbunden, und es wird keine Benachrichtigung angezeigt.