Android

Bagaimana perilaku Android bekerja

Pada Android, plugin ini mengirimkan notifikasi panggilan masuk dengan prioritas tinggi dan dapat meningkatkan aktivitas layar penuh ketika pengaturan platform dan pengguna memungkinkannya.

Manifest plugin sudah termasuk:

<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<uses-permission android:name="android.permission.USE_FULL_SCREEN_INTENT" />

Setelah instalasi, cap sync sudah cukup untuk menggabungkan konfigurasi tersebut ke dalam aplikasi host Anda.

Izin waktu eksekusi

Panggil metode-metode ini selama proses onboard atau sebelum Anda bergantung pada presentasi panggilan masuk:

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

await IncomingCallKit.requestPermissions();
await IncomingCallKit.requestFullScreenIntentPermission();

• requestPermissions() minta izin notifikasi pada Android 13 dan seterusnya.
• requestFullScreenIntentPermission() membuka halaman pengaturan Android 14 dan seterusnya untuk intents full-screen ketika diperlukan.

Contoh dasar

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

await IncomingCallKit.showIncomingCall({
  callId: 'call-42',
  callerName: 'Ada Lovelace',
  appName: 'Capgo Phone',
  timeoutMs: 45_000,
  android: {
    channelId: 'calls',
    channelName: 'Incoming Calls',
    showFullScreen: true,
    isHighPriority: true,
    accentColor: '#0F766E',
  },
});

Opsi khusus Android

• channelId: identifikasi untuk saluran peringatan
• channelName: nama saluran yang dapat dilihat pengguna
• showFullScreen: minta aktivitas layar penuh
• isHighPriority: jaga peringatan cukup mengganggu untuk aliran berdering
• accentColor: tampilan notifikasi yang kompatibel dengan warna
• ringtoneUri: tampilkan ke sumber suara dering Android yang diatur sendiri atau URI

Catatan perilaku

• Penggunaan layar penuh yang optimal. Jika perangkat atau pengaturan pengguna menghalanginya, Android masih menampilkan notifikasi panggilan masuk.
• Penanganan waktu tunggu adalah usaha terbaik. Plugin mengikuti timeoutMs dan mengeluarkan callTimedOut, tetapi backend Anda harus menyelesaikan panggilan yang terlewat di sisi mereka.
• Aksi menerima, menolak, dan mengakhiri diteruskan kembali melalui pendengar Capacitor sehingga aplikasi Anda dapat bergabung atau membersihkan sesi panggilan asli.

Model produksi yang disarankan

Gunakan push Android atau SDK Anda untuk transportasi, kemudian biarkan plugin ini menangani satu mil terakhir dari antarmuka berdering native. Pegang tanggung jawab ini di luar plugin:

• Pendaftaran FCM dan manajemen token
• Siklus hidup sesi media
• Status panggilan backend
• Logika bisnis panggilan yang terlewat dan ulang