CTCall Class Reference

Inherits from
Conforms to
Framework
/System/Library/Frameworks/CoreTelephony.framework/
Availability
Available in iOS 4.0 and later.
Declared in
CTCall.h
Related sample code

Overview

Use a cellular call’s CTCall object to obtain an identifier for the call and to determine the call’s state.

Tasks

Obtaining Information About a Cellular Call

Properties

callID

A unique identifier for the cellular call. (read-only)

@property (nonatomic, readonly, retain) NSString *callID
Discussion

Use this value to differentiate multiple active cellular calls.

Availability
  • Available in iOS 4.0 and later.
Declared In
CTCall.h

callState

The state of the cellular call. (read-only)

@property (nonatomic, readonly, retain) NSString *callState
Discussion

A cellular call’s initial state is either CTCallStateDialing or CTCallStateIncoming. When the call is fully established for all parties involved, the state transitions to CTCallStateConnected. When the call is terminated, the state transitions to CTCallStateDisconnected.

Availability
  • Available in iOS 4.0 and later.
Declared In
CTCall.h

Constants

Cellular Call States

States of cellular calls; one of dialing, incoming, connected, or disconnected.

extern NSString const *CTCallStateDialing;
extern NSString const *CTCallStateIncoming;
extern NSString const *CTCallStateConnected;
extern NSString const *CTCallStateDisconnected;
Constants
CTCallStateDialing

The call state, before connection is established, when the user initiates the call.

Available in iOS 4.0 and later.

Declared in CTCall.h.

CTCallStateIncoming

The call state, before connection is established, when a call is incoming but not yet answered by the user.

Available in iOS 4.0 and later.

Declared in CTCall.h.

CTCallStateConnected

The call state when the call is fully established for all parties involved.

Available in iOS 4.0 and later.

Declared in CTCall.h.

CTCallStateDisconnected

The call state upon call termination.

Available in iOS 4.0 and later.

Declared in CTCall.h.