Windows アプリ

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.


The Windows.ApplicationModel.Calls namespace has these types of members:


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



The Windows.ApplicationModel.Calls namespace has these enumerations.

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.



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

Phone call sample (Windows 10)
Communication blocking and filtering sample (Windows 10)



© 2016 Microsoft