callkitlisted
Install: claude install-skill thienqo/ios-skills
# CallKit
Build VoIP calling experiences that integrate with the native iOS call UI using CallKit and PushKit. Covers incoming and outgoing call flows, PushKit VoIP registration, audio session coordination, and call directory extensions. Targets Swift 6.4 / iOS 26+.
## Contents
- [Capabilities and Key Types](#capabilities-and-key-types)
- [Core Calling Architecture](#core-calling-architecture)
- [Critical VoIP Push Rule](#critical-voip-push-rule)
- [Audio Session Lifecycle](#audio-session-lifecycle)
- [Route by Task](#route-by-task)
- [Common Mistakes](#common-mistakes)
- [Review Checklist](#review-checklist)
- [References](#references)
## Capabilities and Key Types
Enable **Voice over IP** in Signing & Capabilities > Background Modes, and add the **Push Notifications** capability.
| Type | Role |
|---|---|
| `CXProvider` | Reports incoming calls, connections, and external resets to the system; receives `CXAction` requests |
| `CXCallController` | Requests user-initiated call actions (`CXStartCallAction`, `CXEndCallAction`, `CXSetHeldCallAction`) |
| `CXCallUpdate` | Encapsulates call metadata (remote handle, caller name, video capability) |
| `CXProviderDelegate` | Handles telephony events, user interactions (answer, end, hold, mute), and audio session activation |
| `PKPushRegistry` | Registers for and receives PushKit VoIP push notifications |
## Core Calling Architecture
```
[PushKit VoIP Push] ──> [reportNewIncomingCall] ──> [System Call UI]