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。 檔案大小上限為 1 MB。

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。 檔案大小上限為 1 MB。

media

VoipPhoneCallMedia

新來電的媒體類型 (只有音訊和視訊或音訊) 。 傳遞 音訊 |如果使用者可以選擇 接聽撥出視訊的通話，請視訊。 這假設使用者的裝置有相機可供應用程式在通話抵達時使用。 如果這不是這種情況，或使用者只應該使用音訊，請傳遞 Audio。

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。 檔案大小上限為 1 MB。

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。 檔案大小上限為 1 MB。

media

VoipPhoneCallMedia

新來電的媒體類型 (只有音訊和視訊或音訊) 。 傳遞 音訊 |如果使用者可以選擇 接聽撥出視訊的通話，請視訊。 這假設使用者的裝置有相機可供應用程式在通話抵達時使用。 如果這不是這種情況，或使用者只應該使用音訊，請傳遞 Audio。

ringTimeout

TimeSpan TimeSpan

系統應該等候使用者接聽或忽略通話，然後再拒絕通話的時間，以秒為單位。 允許的範圍是 5 到 120 秒。 預設值為 30 秒。

contactRemoteId

String

Platform::String

winrt::hstring

呼叫端的聯繫人遠端識別碼。 最大長度是 256 個字元。

傳回

VoipPhoneCall

物件，表示新的傳入呼叫。

屬性

OverloadAttribute

Windows 需求

裝置系列	Windows 10, version 1803 (已於 10.0.17134.0 引進)
API contract	Windows.ApplicationModel.Calls.CallsVoipContract (已於 v3.0 引進)
應用程式功能	voipCall

備註

當使用者開啟無訊息時，請使用此方法。 如果來電者的連絡遠端標識碼位於無聲小時突破清單上，則會連線通話，並顯示來電通知。 如果沒有，則不會連線通話，也不會顯示通知。