iOS

Cara kerja perilaku iOS

Di iOS, plugin ini melaporkan panggilan masuk ke CallKit. Ini memberikan tampilan sheet panggilan masuk sistem dan aksi panggilan standar tanpa perlu membuat UI panggilan masuk native sendiri.

requestPermissions() langsung selesai di iOS karena CallKit sendiri tidak memerlukan dialog izin runtime.

Contoh dasar

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

await IncomingCallKit.showIncomingCall({
  callId: 'call-42',
  callerName: 'Ada Lovelace',
  handle: '+1 555 010 020',
  ios: {
    handleType: 'phoneNumber',
    supportsHolding: true,
    supportsDTMF: false,
  },
});

Tipe handle

Gunakan ios.handleType untuk mengatur cara CallKit memformat handle:

• generic untuk pengenal khusus aplikasi
• phoneNumber untuk nomor telepon asli
• emailAddress untuk identitas berbasis email

Panggilan masuk di background

Plugin ini tidak mendaftarkan PushKit atau APNs untuk Anda.

Untuk fitur ringtone saat background atau terminated-state di iOS, aplikasi host Anda tetap memerlukan setup push native Apple yang sesuai dengan strategi transport Anda:

1. Aktifkan Push Notifications jika transport Anda menggunakan pengiriman push Apple.
2. Aktifkan mode background Voice over IP jika aplikasi Anda menggunakan alur VoIP push.
3. Kirimkan event incoming-call ke aplikasi Anda dan panggil plugin ini segera setelah bridge Capacitor tersedia.

Jika event ring Anda hanya ada di JavaScript, Anda akan mendapatkan pengalaman terbaik saat aplikasi sudah berjalan di foreground.

Izin mikrofon dan kamera

CallKit tidak menggantikan media SDK Anda. Jika sesi panggilan asli menggunakan akses mikrofon atau kamera, deskripsi penggunaan tersebut tetap harus ada di aplikasi Anda:

<key>NSMicrophoneUsageDescription</key>
<string>This app uses the microphone for calls.</string>
<key>NSCameraUsageDescription</key>
<string>This app uses the camera for video calls.</string>

Tambahkan hanya key yang dibutuhkan alur panggilan Anda.

Pertahankan tanggung jawab ini di layer aplikasi Anda

• Registrasi PushKit dan APNs
• Autentikasi dan refresh token
• Bergabung ke room atau sesi VoIP sebenarnya setelah callAccepted
• Mengakhiri atau menyelaraskan status panggilan remote saat plugin mengemit callDeclined, callEnded, atau callTimedOut

Lanjutkan dari iOS

Jika Anda menggunakan iOS untuk merencanakan pekerjaan plugin native, hubungkan dengan Menggunakan @capgo/capacitor-incoming-call-kit untuk kapabilitas native saat menggunakan @capgo/capacitor-incoming-call-kit, Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi pada Capacitor Plugins oleh Capgo Menambahkan atau Memperbarui Plugin untuk detail implementasi di Menambahkan atau Memperbarui Plugin, dan Alternatif Plugin Ionic Enterprise untuk alur kerja produk dalam Alternatif Plugin Ionic Enterprise.