VoipCallCoordinator.RequestNewIncomingCall Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
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 символов.
Универсальный код ресурса (URI) файла изображения, связанного с вызывающим объектом, который будет отображаться в пользовательском интерфейсе входящего вызова. Файл должен иметь тип PNG или JPG. Максимальный размер файла — 1 МБ.
- serviceName
-
String
Platform::String
winrt::hstring
Имя службы или приложения VoIP. Максимальная длина: 128 символов.
Универсальный код ресурса (URI) файла изображения, который представляет собой логотип или значок службы или приложения VoIP, отображаемый в пользовательском интерфейсе входящего вызова. Файл должен иметь тип PNG или JPG. Максимальный размер файла — 128 КБ.
- callDetails
-
String
Platform::String
winrt::hstring
Строка, указывающая, от имени кого выполняется вызов. Максимальная длина: 128 символов.
Универсальный код ресурса (URI) звукового файла, содержащего мелодию звонка для этого вызова. Файл должен иметь тип WMA или MP3. Максимальный размер файла — 1 МБ.
- media
- VoipPhoneCallMedia
Типы мультимедиа нового входящего вызова (только аудио и видео или аудио). Передача звука|Видео , если у пользователя должна быть возможность отвечать на звонок с помощью исходящего видео. При этом предполагается, что на устройстве пользователя есть камера, доступная для использования приложением во время вызова. Если это не так или пользователь должен использовать только звук, передайте audio.
Время (в секундах) система должна ожидать ответа пользователя или игнорировать звонок, прежде чем отклонять звонок. Допустимый диапазон составляет от 5 до 120 секунд. Значение по умолчанию — 30 секунд.
Возвращаемое значение
Объект , представляющий новый входящий вызов.
Требования к 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 символов.
Универсальный код ресурса (URI) файла изображения, связанного с вызывающим объектом, который будет отображаться в пользовательском интерфейсе входящего вызова. Файл должен иметь тип PNG или JPG. Максимальный размер файла — 1 МБ.
- serviceName
-
String
Platform::String
winrt::hstring
Имя службы или приложения VoIP. Максимальная длина: 128 символов.
Универсальный код ресурса (URI) файла изображения, который представляет собой логотип или значок службы или приложения VoIP, отображаемый в пользовательском интерфейсе входящего вызова. Файл должен иметь тип PNG или JPG. Максимальный размер файла — 128 КБ.
- callDetails
-
String
Platform::String
winrt::hstring
Строка, указывающая, от имени кого выполняется вызов. Максимальная длина: 128 символов.
Универсальный код ресурса (URI) звукового файла, содержащего мелодию звонка для этого вызова. Файл должен иметь тип WMA или MP3. Максимальный размер файла — 1 МБ.
- media
- VoipPhoneCallMedia
Типы мультимедиа нового входящего вызова (только аудио и видео или аудио). Передача звука|Видео , если у пользователя должна быть возможность отвечать на звонок с помощью исходящего видео. При этом предполагается, что на устройстве пользователя есть камера, доступная для использования приложением во время вызова. Если это не так или пользователь должен использовать только звук, передайте audio.
Время (в секундах) система должна ожидать ответа пользователя или игнорировать звонок, прежде чем отклонять звонок. Допустимый диапазон составляет от 5 до 120 секунд. Значение по умолчанию — 30 секунд.
- contactRemoteId
-
String
Platform::String
winrt::hstring
Удаленный идентификатор контакта вызывающего абонента. Максимальная длина составляет 256 символов.
Возвращаемое значение
Объект , представляющий новый входящий вызов.
- Атрибуты
Требования к Windows
Семейство устройств |
Windows 10, version 1803 (появилось в 10.0.17134.0)
|
API contract |
Windows.ApplicationModel.Calls.CallsVoipContract (появилось в v3.0)
|
Возможности приложения |
voipCall
|
Комментарии
Используйте этот метод, если пользователь включил режим "Не беспокоить". Если удаленный идентификатор контакта звонящего находится в списке прорыва в "тихий час", звонок будет подключен, и отобразится уведомление о входящем вызове. В противном случае вызов не будет подключен, и уведомление не будет отображаться.