Windows.ApplicationModel.Calls Namespace

Controls multiple aspects of how an application can interact with a phone device, including lock-screen interaction, the phone call history, and various telephony options and information.

Classes

CallAnswerEventArgs	Supports the AnswerRequested event of the VoipPhoneCall class.
CallRejectEventArgs	Supports the RejectRequested event of the VoipPhoneCall class.
CallStateChangeEventArgs	Supports the EndRequested, HoldRequested, and ResumeRequested events of the VoipPhoneCall class.
LockScreenCallEndCallDeferral	The LockScreenCallEndCallDeferral object signals when the app no longer needs to defer the removal of itself from the lock screen.
LockScreenCallEndRequestedEventArgs	Controls the removal of an app from the lock screen.
LockScreenCallUI	Deprecated. Handles communication to and from the lock screen.
MuteChangeEventArgs	Supports the NotifyMuted and NotifyUnmuted events.
PhoneCall	Represents a phone call.
PhoneCallBlocking	Controls the blocking of phone numbers as they are received.
PhoneCallHistoryEntry	A collection of information about a phone call for the call history.
PhoneCallHistoryEntryAddress	Address book information for a contact used by PhoneCallHistoryEntry objects.
PhoneCallHistoryEntryQueryOptions	Options for querying the phone call entries.
PhoneCallHistoryEntryReader	Enables the calling app to read through the phone call history entries.
PhoneCallHistoryManager	Provides APIs for the application to get access to the PhoneCallHistoryStore.
PhoneCallHistoryManagerForUser	Provides APIs for the application to get access to the PhoneCallHistoryStore for a specific user.
PhoneCallHistoryStore	A collection of phone call history entries.
PhoneCallInfo	Represents a phone call, and a set of call properties that remain unchanged throughout the lifetime of the call.
PhoneCallManager	Provides the ability to query the call status and launch phone calls.
PhoneCallsResult	Represents the phone line operation status, and enumerates phone calls on the line.
PhoneCallStore	Represents a collection of information about the phone lines available on a device.
PhoneCallVideoCapabilities	Provides access to the video call capabilities for a PhoneLine instance.
PhoneCallVideoCapabilitiesManager	Enables an application to get the PhoneCallVideoCapabilities for a PhoneLine instance.
PhoneDialOptions	Represents options for dialing a call.
PhoneLine	Represents a phone line.
PhoneLineCellularDetails	Provides detailed interaction with the cellular components of a phone line.
PhoneLineConfiguration	A collection of properties providing information about a phone line.
PhoneLineDialResult	Represents a phone call dial status.
PhoneLineTransportDevice	Represents the hardware device associated with a PhoneLine. Currently only supported for use with bluetooth devices.
PhoneLineWatcher	Represents a class that monitors for new/removed/updated phone lines on the device and notifies listeners about any changes.
PhoneLineWatcherEventArgs	Represents a class that contains the information about which phone line was added, removed, or updated.
PhoneVoicemail	Represents the voice mail data associated with a PhoneLine instance.
VoipCallCoordinator	Allows an application to manage VoIP calls.
VoipPhoneCall	Represents a VoIP phone call.

Enums

CellularDtmfMode	Indicates the type of dual tone multi-frequency (DTMF) used by a cellular phone.
DtmfKey	Defines constants that specify a keypad dual tone multi-frequency (DTMF) key. Allows you to directly send DTMF keys to a phone call.
DtmfToneAudioPlayback	Defines constants that specify whether or not playback of dual tone multi-frequency (DTMF) audio on the local device is desired.
PhoneAudioRoutingEndpoint	The available audio endpoints you can use for dialing a phone call.
PhoneCallAudioDevice	Defines constants that specify a hands-free (HF) phone call audio device.
PhoneCallDirection	Defines constants that specify a phone call direction.
PhoneCallHistoryEntryMedia	The type of media associated with a call.
PhoneCallHistoryEntryOtherAppReadAccess	The level of read access provided to other applications.
PhoneCallHistoryEntryQueryDesiredMedia	A filter used to retrieve call entries based on the contained media.
PhoneCallHistoryEntryRawAddressKind	The type of address used by the PhoneCallHistoryEntryAddress.
PhoneCallHistorySourceIdKind	The type of identifier that the PhoneCallHistoryEntry.SourceId refers to.
PhoneCallHistoryStoreAccessType	The type of store you want to retrieve.
PhoneCallMedia	The types of media available in a phone call.
PhoneCallOperationStatus	Defines constants that specify the operation status (or result) of a hands-free (HF) phone call.
PhoneCallStatus	Defines constants that specify the state of a phone call.
PhoneLineNetworkOperatorDisplayTextLocation	The possible locations for displaying network operator information to the user.
PhoneLineOperationStatus	Defines constants that specify the operation status of a phone line.
PhoneLineTransport	The transport used by a particular phone line.
PhoneLineWatcherStatus	The current status of the PhoneLineWatcher.
PhoneNetworkState	Describes the network registration status of a phone line.
PhoneSimState	The current state of the SIM card for a cellular phone line.
PhoneVoicemailType	The type of voice mail associated with a PhoneLine instance.
TransportDeviceAudioRoutingStatus	Defines constants that specify the audio routing status of an underlying transport device.
VoipPhoneCallMedia	Specifies the media types used by a VoIP call.
VoipPhoneCallRejectReason	Specifies the reason that an incoming call was rejected.
VoipPhoneCallResourceReservationStatus	Indicates the result of attempting to reserve VoIP resources.
VoipPhoneCallState	Specifies the state of a VoIP call.

Examples

An example that demonstrates how to use much of the functionality of the Windows.ApplicationModel.Calls API can be found here.

Remarks

This namespace is divided into three primary categories of classes and enumerations. These categories are the lock screen, the phone call history, and the telephony options and information.

The lock-screen-call contract lets an app, with user consent, perform these tasks:

• Raise a notification toast with up to three additional buttons: Accept with Video, Accept with Audio, Ignore.
• If the notification toast appears on the lock screen and the user chooses to accept the call, the app displays its call UI directly on the lock screen without requiring the user to unlock.

The telephony options and information classes use the CallsPhoneContract. In order to use these classes, you will need to declare the phoneCall capability in your manifest.

Important

If your application uses the phoneCall capability, you must request a waiver if you want to publish your application in China. Contact your premier support representative if you need the waiver.

See also

• Phone call sample
• Communication blocking and filtering sample
• Voice over IP (VoIP) sample