Windows.ApplicationModel.Calls Namespace

Controls multiple aspects of how an application on the phone behaves, 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.

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.

PhoneCallManager

Provides the ability to query the call status and launch phone calls.

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.

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.

Structs

CallsPhoneContract
CallsVoipContract
LockScreenCallContract

Enums

CellularDtmfMode

Indicates the type of dual tone multi-frequency (DTMF) used by a cellular phone.

PhoneAudioRoutingEndpoint

The available audio endpoints you can use for dialing a phone call.

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.

PhoneLineNetworkOperatorDisplayTextLocation

The possible locations for displaying network operator information to the user.

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.

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.

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.

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

See also