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

Имя контакта вызывающего абонента, которое будет отображаться в пользовательском интерфейсе входящего звонка. Максимальная длина: 128 символов.

contactNumber

String

Platform::String

winrt::hstring

Номер телефона звонящего абонента, который будет отображаться в пользовательском интерфейсе входящего звонка. Максимальная длина: 128 символов.

contactImage

Uri Uri

Универсальный код ресурса (URI) файла изображения, связанного с вызывающим объектом, который будет отображаться в пользовательском интерфейсе входящего вызова. Файл должен иметь тип PNG или JPG. Максимальный размер файла — 1 МБ.

serviceName

String

Platform::String

winrt::hstring

Имя службы или приложения VoIP. Максимальная длина: 128 символов.

brandingImage

Uri Uri

Универсальный код ресурса (URI) файла изображения, который представляет собой логотип или значок службы или приложения VoIP, отображаемый в пользовательском интерфейсе входящего вызова. Файл должен иметь тип PNG или JPG. Максимальный размер файла — 128 КБ.

callDetails

String

Platform::String

winrt::hstring

Строка, указывающая, от имени кого выполняется вызов. Максимальная длина: 128 символов.

ringtone

Uri Uri

Универсальный код ресурса (URI) звукового файла, содержащего мелодию звонка для этого вызова. Файл должен иметь тип WMA или MP3. Максимальный размер файла — 1 МБ.

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

Имя контакта вызывающего абонента, которое будет отображаться в пользовательском интерфейсе входящего звонка. Максимальная длина: 128 символов.

contactNumber

String

Platform::String

winrt::hstring

Номер телефона звонящего абонента, который будет отображаться в пользовательском интерфейсе входящего звонка. Максимальная длина: 128 символов.

contactImage

Uri Uri

Универсальный код ресурса (URI) файла изображения, связанного с вызывающим объектом, который будет отображаться в пользовательском интерфейсе входящего вызова. Файл должен иметь тип PNG или JPG. Максимальный размер файла — 1 МБ.

serviceName

String

Platform::String

winrt::hstring

Имя службы или приложения VoIP. Максимальная длина: 128 символов.

brandingImage

Uri Uri

Универсальный код ресурса (URI) файла изображения, который представляет собой логотип или значок службы или приложения VoIP, отображаемый в пользовательском интерфейсе входящего вызова. Файл должен иметь тип PNG или JPG. Максимальный размер файла — 128 КБ.

callDetails

String

Platform::String

winrt::hstring

Строка, указывающая, от имени кого выполняется вызов. Максимальная длина: 128 символов.

ringtone

Uri Uri

Универсальный код ресурса (URI) звукового файла, содержащего мелодию звонка для этого вызова. Файл должен иметь тип WMA или MP3. Максимальный размер файла — 1 МБ.

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

Комментарии

Используйте этот метод, если пользователь включил режим "Не беспокоить". Если удаленный идентификатор контакта звонящего находится в списке прорыва в "тихий час", звонок будет подключен, и отобразится уведомление о входящем вызове. В противном случае вызов не будет подключен, и уведомление не будет отображаться.