VoipCallCoordinator.RequestNewIncomingCall 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
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자입니다.
수신 호출 UI에 표시할 호출자와 연결된 이미지 파일의 URI입니다. 파일 형식은 PNG 또는 JPG여야 합니다. 최대 파일 크기는 1MB입니다.
- serviceName
-
String
Platform::String
winrt::hstring
VoIP 서비스 또는 애플리케이션의 이름입니다. 최대 길이는 128자입니다.
들어오는 호출 UI에 표시할 VoIP 서비스 또는 애플리케이션의 로고 또는 아이콘인 이미지 파일의 URI입니다. 파일 형식은 PNG 또는 JPG여야 합니다. 최대 파일 크기는 128KB입니다.
- callDetails
-
String
Platform::String
winrt::hstring
호출을 대신하는 사용자를 나타내는 문자열입니다. 최대 길이는 128자입니다.
- media
- VoipPhoneCallMedia
새 수신 통화의 미디어 유형(오디오 및 비디오 또는 오디오만 해당)입니다. 오디오 전달|사용자에게 발신 비디오로 통화에 응답할 수 있는 옵션이 있어야 하는 경우 비디오입니다. 이렇게 하면 통화가 도착할 때 앱에서 사용할 수 있는 카메라가 사용자의 디바이스에 있다고 가정합니다. 그렇지 않거나 사용자가 오디오만 사용해야 하는 경우 오디오를 전달 합니다.
시간(초)은 호출을 거부하기 전에 사용자가 통화에 응답하거나 무시할 때까지 기다려야 합니다. 허용되는 범위는 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
들어오는 호출 UI에 표시할 호출자의 연락처 이름입니다. 최대 길이는 128자입니다.
- contactNumber
-
String
Platform::String
winrt::hstring
수신 전화 UI에 표시할 호출자의 전화 번호입니다. 최대 길이는 128자입니다.
수신 호출 UI에 표시할 호출자와 연결된 이미지 파일의 URI입니다. 파일 형식은 PNG 또는 JPG여야 합니다. 최대 파일 크기는 1MB입니다.
- serviceName
-
String
Platform::String
winrt::hstring
VoIP 서비스 또는 애플리케이션의 이름입니다. 최대 길이는 128자입니다.
들어오는 호출 UI에 표시할 VoIP 서비스 또는 애플리케이션의 로고 또는 아이콘인 이미지 파일의 URI입니다. 파일 형식은 PNG 또는 JPG여야 합니다. 최대 파일 크기는 128KB입니다.
- callDetails
-
String
Platform::String
winrt::hstring
호출을 대신하는 사용자를 나타내는 문자열입니다. 최대 길이는 128자입니다.
- media
- VoipPhoneCallMedia
새 수신 통화의 미디어 유형(오디오 및 비디오 또는 오디오만 해당)입니다. 오디오 전달|사용자에게 발신 비디오로 통화에 응답할 수 있는 옵션이 있어야 하는 경우 비디오입니다. 이렇게 하면 통화가 도착할 때 앱에서 사용할 수 있는 카메라가 사용자의 디바이스에 있다고 가정합니다. 그렇지 않거나 사용자가 오디오만 사용해야 하는 경우 오디오를 전달 합니다.
시간(초)은 호출을 거부하기 전에 사용자가 통화에 응답하거나 무시할 때까지 기다려야 합니다. 허용되는 범위는 5~120초입니다. 기본값은 30초입니다.
- contactRemoteId
-
String
Platform::String
winrt::hstring
호출자의 연락처 원격 ID입니다. 최대 길이는 256자입니다.
반환
새 수신 호출을 나타내는 개체입니다.
- 특성
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10, version 1803 (10.0.17134.0에서 도입되었습니다.)
|
| API contract |
Windows.ApplicationModel.Calls.CallsVoipContract (v3.0에서 도입되었습니다.)
|
| 앱 기능 |
voipCall
|
설명
사용자가 조용한 시간을 설정한 경우 이 메서드를 사용합니다. 발신자의 연락처 원격 ID가 조용한 시간 돌파구 목록에 있으면 통화가 연결되고 들어오는 통화 알림이 표시됩니다. 그렇지 않은 경우 호출이 연결되지 않고 알림이 표시되지 않습니다.