Share via


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

AcceptedVoipPhoneCallOptions
AppInitiatedVoipPhoneCallOptions
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.

IncomingVoipPhoneCallOptions
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.

OutgoingVoipPhoneCallOptions
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.

VoipCallControlDeviceKind
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