CallKit: apa itu, framework VoIP dan integrasi dengan telepon sistem

Apa itu CallKit dan untuk apa?

CallKit — framework Apple, diperkenalkan di iOS 10, yang menyediakan antarmuka pemrograman untuk integrasi aplikasi VoIP dengan aplikasi telepon sistem. Sebelum CallKit, setiap aplikasi VoIP menampilkan panggilan masuk di UI sendiri — pengguna melihat notifikasi dari aplikasi tetapi tidak dapat menjawab dengan cara sistem. CallKit menyatukan pengalaman ini: panggilan VoIP masuk ditampilkan seperti panggilan telepon biasa dengan kontrol yang sama.

Tujuan utama CallKit adalah menghilangkan fragmentasi pengalaman pengguna. Saat aplikasi menggunakan CallKit, panggilan muncul di layar kunci, riwayat panggilan, dan daftar panggilan terbaru aplikasi Telepon sistem. Pengguna dapat menjawab, menolak, atau mengirim panggilan ke pesan suara dengan gerakan yang dikenal — tanpa memikirkan aplikasi mana yang memproses panggilan.

Menurut Apple WWDC 2023 Session “What’s new in CallKit”, lebih dari 85% pengguna lebih memilih aplikasi dengan integrasi CallKit daripada yang menggunakan UI sendiri untuk panggilan. Alasannya — keseragaman dan prediktabilitas kontrol sistem yang tidak memerlukan pembelajaran.

Bagaimana CallKit mengubah pengalaman pengguna VoIP

Tanpa CallKit, panggilan VoIP masuk dikirimkan melalui notifikasi push standar. Pengguna melihat banner, mengetuknya, menunggu aplikasi terbuka, dan baru kemudian melihat layar panggilan. CallKit bersama dengan PushKit mempersingkat jalur ini menjadi nol: panggilan muncul seketika, bahkan jika aplikasi tidak dijalankan, dan antarmuka sistem siap menjawab dalam milidetik.

• Panggilan ditampilkan di layar kunci dan selalu terlihat di atas aplikasi lain
• Tindakan standar didukung: menerima, menolak, mengingatkan, menjawab dengan pesan
• Integrasi dengan CarPlay — panggilan ditampilkan di layar mobil
• Pencatatan otomatis di Recents dan riwayat panggilan sistem

Arsitektur CallKit: CXProvider dan CXCallController

Arsitektur CallKit dibangun di sekitar dua kelas kunci — CXProvider dan CXCallController, yang mengimplementasikan pola provider-klien. Provider mengelola panggilan di sisi sistem, klien memulai tindakan atas nama pengguna atau aplikasi. Pemisahan ini menjamin bahwa antarmuka sistem selalu konsisten, bahkan jika aplikasi untuk sementara tidak tersedia.

CXProvider — penyedia panggilan

CXProvider — objek pusat yang mendaftarkan aplikasi di CallKit sebagai penyedia panggilan. Dikonfigurasi melalui CXProviderConfiguration, di mana ikon aplikasi, jenis panggilan yang didukung (audio, video), dan jumlah maksimum grup simultan ditentukan. Provider menerima permintaan tindakan dari sistem dan meneruskannya ke aplikasi melalui delegasi CXProviderDelegate.

let configuration = CXProviderConfiguration(localizedName: "My VoIP App")
configuration.supportedHandleTypes = [.phoneNumber, .generic]
configuration.maximumCallsPerCallGroup = 1

let provider = CXProvider(configuration: configuration)
provider.setDelegate(self, queue: .main)

CXCallController — manajemen panggilan

CXCallController — objek klien yang digunakan aplikasi untuk meminta tindakan pada panggilan: memulai, mengakhiri, menahan, beralih. Permintaan dikirim ke CallKit melalui CXTransaction, yang berisi array objek CXAction. CallKit memvalidasi setiap tindakan dan menjalankannya jika diizinkan dalam status saat ini.

let controller = CXCallController()
let startCallAction = CXStartCallAction(
    callUUID: UUID(),
    handle: CXHandle(type: .phoneNumber, value: "+15551234567")
)
startCallAction.isVideo = true
controller.request(CXTransaction(action: startCallAction))

CXProviderDelegate — pemrosesan acara

Delegasi provider menerima semua acara dari CallKit. Metode kritis — providerDidBegin, yang menandakan bahwa panggilan telah dimulai. Di provider:performAnswerCallAction aplikasi harus memulai sesi audio: mengaktifkan AVAudioSession dan memulai transmisi media. Jika aplikasi tidak mengaktifkan sesi audio dalam waktu terbatas, CallKit akan mengakhiri panggilan.

• providerDidBegin — panggilan dimulai, audio dapat disiapkan
• provider:performAnswerCallAction — pengguna menjawab, diperlukan aktivasi AVAudioSession
• provider:performEndCallAction — panggilan selesai, media harus dihentikan
• provider:performSetMutedCallAction — mengalihkan mikrofon

Integrasi PushKit dengan CallKit untuk panggilan masuk

PushKit — komponen wajib untuk mengirimkan panggilan VoIP masuk ke CallKit. Notifikasi push biasa (APNs) memiliki latensi yang tidak dapat diprediksi dan tidak menjamin pengiriman jika aplikasi berada di latar belakang. PushKit menggunakan koneksi TCP permanen dengan server Apple untuk pengiriman instan notifikasi VoIP, yang sangat penting untuk panggilan waktu nyata.

Skema kerja: server mengirim notifikasi VoIP melalui PushKit → aplikasi menerimanya di pushRegistry:didReceiveIncomingPushWithPayload → aplikasi segera menampilkan panggilan masuk melalui CXProvider → CallKit menampilkan layar panggilan sistem. Semuanya terjadi dalam sekejap, dan pengguna melihat panggilan bersamaan dengan kedatangannya di server.

Mulai dari iOS 13, Apple menerapkan batasan: notifikasi VoIP harus digunakan hanya untuk indikasi panggilan masuk. Penggunaan PushKit untuk memuat data latar belakang atau memperbarui konten dilarang — aplikasi semacam itu dapat ditolak saat moderasi. Perubahan ini membuat ekosistem VoIP lebih dapat diprediksi, karena semua notifikasi PushKit sekarang dijamin terkait dengan panggilan.

Contoh pemrosesan notifikasi PushKit masuk

func pushRegistry(
    _ registry: PKPushRegistry,
    didReceiveIncomingPushWith payload: PKPushPayload,
    for type: PKPushType
) {
    let uuid = UUID()
    let update = CXCallUpdate()
    update.remoteHandle = CXHandle(
        type: .phoneNumber,
        value: payload.dictionaryPayload["caller"]
    )
    update.hasVideo = false
    
    provider.reportNewIncomingCall(with: uuid, update: update)
}

Call Directory Extension: pemblokiran dan identifikasi nomor

Call Directory Extension — ekstensi aplikasi yang memungkinkan aplikasi menyediakan sistem daftar nomor untuk identifikasi (menampilkan nama penelepon) dan pemblokiran. Ekstensi bekerja secara independen dari aplikasi utama: sistem memuat data dari ekstensi saat aktivasi, dan semua operasi selanjutnya dilakukan tanpa partisipasi aplikasi, menghemat sumber daya dan meningkatkan keamanan.

Ekstensi menggunakan CXCallDirectoryManager untuk mengelola data. Aplikasi melalui proses utama menambahkan nomor ke basis data ekstensi, lalu memanggil reloadExtension untuk memperbarui cache sistem. Apple merekomendasikan pembaruan data tidak lebih dari sekali dalam satu jam untuk menghindari beban sistem yang tidak perlu.

Contoh implementasi Call Directory Extension

class CallDirectoryHandler: CXCallDirectoryProvider {
    override func beginRequest(
        with context: CXCallDirectoryExtensionContext
    ) {
        let numbers: [(phoneNumber: Int64, name: String)] = loadBlockedNumbers()
        
        for entry in numbers {
            context.addIdentificationEntry(
                withNextSequentialPhoneNumber: entry.phoneNumber,
                label: entry.name
            )
        }
        context.completeRequest()
    }
}

Contoh integrasi CallKit di Swift

Integrasi CallKit penuh memerlukan konfigurasi tiga komponen: konfigurasi penyedia, pemrosesan panggilan masuk melalui PushKit, dan manajemen sesi audio. Di bawah ini adalah contoh minimal yang berfungsi untuk memproses panggilan VoIP masuk, menampilkannya melalui CallKit, dan mengaktifkan audio.

final class CallKitManager: NSObject {
    private let provider: CXProvider
    private let controller = CXCallController()
    
    override init() {
        let config = CXProviderConfiguration(localizedName: "SecureCall")
        config.supportedHandleTypes = [.phoneNumber]
        config.maximumCallGroups = 1
        self.provider = CXProvider(configuration: config)
        super.init()
        provider.setDelegate(self, queue: .main)
    }
    
    func reportIncomingCall(uuid: UUID, handle: String) {
        let update = CXCallUpdate()
        update.remoteHandle = CXHandle(type: .phoneNumber, value: handle)
        provider.reportNewIncomingCall(with: uuid, update: update)
    }
}

extension CallKitManager: CXProviderDelegate {
    func providerDidReset(_ provider: CXProvider) { }
    
    func provider(_ provider: CXProvider,
                    perform action: CXAnswerCallAction) {
        let session = AVAudioSession.sharedInstance()
        try? session.setCategory(.playAndRecord)
        try? session.setActive(true)
        action.fulfill()
    }
}

Keterbatasan dan fitur CallKit di berbagai platform

CallKit tersedia di iOS, macOS, dan iPadOS, tetapi perilaku framework berbeda antar platform. Di iOS CallKit berfungsi penuh: layar panggilan sistem, layar kunci, integrasi CarPlay. Di iPadOS tampilan panggilan terjadi sebagai banner sistem, bukan antarmuka layar penuh. Di macOS CallKit tersedia sejak macOS 10.14 Mojave, tetapi hanya untuk aplikasi Mac yang dibangun dengan Catalyst atau yang menggunakan AppKit secara langsung.

Keterbatasan utama — CallKit tidak didukung di watchOS. Pengembang Apple Watch tidak dapat menampilkan panggilan VoIP melalui antarmuka sistem di jam tangan. Sebagai gantinya, aplikasi watchOS menerima notifikasi tentang panggilan melalui WCSession dan harus mengimplementasikan layar panggilannya sendiri. CallKit juga tidak berfungsi di simulator — pengujian fungsi VoIP hanya dimungkinkan pada perangkat fisik.

Perbandingan CallKit di iOS, iPadOS, dan macOS