Class

CXCallUpdate

An encapsulation of new and changed information about a call.

Declaration

@interface CXCallUpdate : NSObject

Overview

CXCallUpdate objects are used by the system to communicate changes to calls over time. Not every property on a CXCallUpdate object must be set each time, as each object includes only new and changed information. For example, when a call is started, only some properties may be known and included in the first CXCallUpdate object sent to the system, such as localizedCallerName. Later in the same call, other properties may change; for example, a call may be upgraded from audio only to audio and video, which would be reflected by a new CXCallUpdate object with its hasVideo property set to YES.

When an incoming call is received, you construct a CXCallUpdate object specifying a localizedCallerName and pass that to the reportNewIncomingCallWithUUID:update:completion: method to notify the telephony provider.

When an active call is updated, you construct a CXCallUpdate object specifying any updated information and pass that to the reportCallWithUUID:updated: method. For example, if a user changes their contact information during a call, you could notify the telephony provider of this change using a new CXCallUpdate object with the new value set to its remoteHandle property.

Topics

Accessing Call Update Attributes

localizedCallerName

The localized name of the caller.

remoteHandle

The handle for the remote party (for an incoming call, this is the caller; for an outgoing call, this is the callee).

hasVideo

A Boolean value that indicates whether the call includes video in addition to audio.

supportsGrouping

A Boolean value that indicates whether the call can be grouped with other calls.

supportsUngrouping

A Boolean value that indicates whether the call can be ungrouped from other calls.

supportsHolding

A Boolean value that indicates whether the call can be placed on hold or removed from hold.

supportsDTMF

A Boolean value that indicates whether the call can send DTMF (dual tone multifrequency) tones via hard pause digits or in-call keypad entries.

Relationships

Inherits From

Conforms To

See Also

Incoming Calls

Responding to VoIP Notifications from PushKit

Receive incoming Voice-over-IP (VoIP) push notifications and use them to display the system call interface to the user.

CXAnswerCallAction

An encapsulation of the act of answering an incoming call.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software