VoipPhoneCall 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
代表 VoIP 通話。
public ref class VoipPhoneCall sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Calls.CallsVoipContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class VoipPhoneCall final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Calls.CallsVoipContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class VoipPhoneCallPublic NotInheritable Class VoipPhoneCall- 繼承
- 屬性
Windows 需求
| 裝置系列 |
Windows Mobile Extension SDK (已於 10.0.10240.0 引進)
Windows 10 (已於 10.0.10586.0 引進) |
| API contract |
Windows.ApplicationModel.Calls.CallsVoipContract (已於 v1.0 引進)
|
| 應用程式功能 |
phoneCallHistory
phoneCallHistorySystem
voipCall
|
備註
呼叫 VoipCallCoordinator.RequestNewAppInitiatedCall 方法，以建立新的 VoipPhoneCall 物件。 然後，您可以使用 VoipPhoneCall 物件來設定新的應用程式內通話通知，以及處理 VoipPhoneCall 引發的事件。
如果使用者接受呼叫，您的應用程式應該呼叫 NotifyCallAccepted。 如果呼叫遭到拒絕或未回應，請呼叫 NotifyCallEnded。 或者，系統本身可以引發 AnswerRequested 或 RejectRequested 事件，而您的 VoIP 應用程式可以處理這些事件，以判斷使用者是否已透過 HID 裝置接受或拒絕來電。
版本歷程記錄
| Windows 版本 | SDK 版本 | 已新增值 |
|---|---|---|
| 1709 | 16299 | TryShowAppUI |
| 1803 | 17134 | NotifyCallAccepted |
屬性
| CallMedia |
取得呼叫所使用的媒體類型。 |
| ContactName |
取得或設定與 VoIP 通話相關聯的聯繫人名稱。 |
| IsUsingAssociatedDevicesList |
代表 VoIP 通話。 |
| StartTime |
取得或設定與 VoIP 呼叫相關聯的開始時間。 |
方法
| AddAssociatedCallControlDevice(String) |
代表 VoIP 通話。 |
| GetAssociatedCallControlDevices() |
代表 VoIP 通話。 |
| NotifyCallAccepted(VoipPhoneCallMedia) |
通知系統已接受 VoIP 通話。 |
| NotifyCallActive() |
通知系統 VoIP 呼叫作用中。 |
| NotifyCallActive(IIterable<String>) |
代表 VoIP 通話。 |
| NotifyCallEnded() |
通知系統呼叫已結束。 |
| NotifyCallHeld() |
通知系統，呼叫目前為保留狀態。 |
| NotifyCallReady() |
將通話從行動數據升級為視訊時，通知系統應用程式已完成設定視訊通話的音訊和視訊串流，讓系統可以結束現有的行動電話通話。 |
| RemoveAssociatedCallControlDevice(String) |
代表 VoIP 通話。 |
| SetAssociatedCallControlDevices(IIterable<String>) |
代表 VoIP 通話。 |
| TryShowAppUI() |
在接受通話之後，將 VOIP 應用程式的使用者介面帶入前景。 |
事件
| AnswerRequested |
當使用者接聽來電時引發。 |
| EndRequested |
引發以警示 VoIP 應用程式應結束通話。 |
| HoldRequested |
引發 以向 VoIP 應用程式發出警示，指出應保留通話。 |
| RejectRequested |
呼叫遭到拒絕時引發。 |
| ResumeRequested |
引發 ，表示先前持有的 VoIP 呼叫應該作用中。 |