Android

Bagaimana perilaku Android bekerja

Pada Android, plugin mengirimkan pemberitahuan panggilan masuk 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 mencukupi untuk menyatukan konfigurasi ke aplikasi host Anda.

Otorisasi 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() mengajukan izin permintaan notifikasi pada Android 13 dan seterusnya.
• requestFullScreenIntentPermission() membuka halaman pengaturan Android 14 dan seterusnya untuk intent penuh layar 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',
  },
});

Pilihan Khusus Android

• channelId: identifikasi untuk saluran notifikasi
• channelName: nama saluran yang dapat dilihat pengguna
• showFullScreen: minta aktivitas layar penuh
• isHighPriority: jaga notifikasi cukup mengganggu untuk aliran berdering
• accentColor: tampilan notifikasi yang kompatibel dengan warna
• ringtoneUri: titik ke sebuah sumber atau URI ringtone Android yang disesuaikan

Catatan perilaku

• Pengaturan layar penuh adalah usaha terbaik. Jika perangkat atau pengaturan pengguna menghalanginya, Android masih menampilkan notifikasi panggilan masuk.
• Pengaturan waktu habis adalah usaha terbaik. Plugin ini mengikuti dan mengeluarkan timeoutMs dan callTimedOuttetapi backend Anda masih harus menyesuaikan panggilan yang terlewat di sisi mereka.
• Aksi menerima, menolak, dan mengakhiri dipancarkan kembali melalui Capacitor pemangku jawab sehingga aplikasi Anda dapat bergabung atau membersihkan sesi panggilan nyata.

Model produksi yang direkomendasikan

Gunakan push Android atau SDK panggilan Anda untuk transportasi, kemudian biarkan plugin ini mengelola satu mil terakhir UI berbunyi native. Pegang tanggung jawab ini di luar plugin:

• Pendaftaran FCM dan manajemen token
• Lifecylce sesi media
• Status panggilan backend
• Logika bisnis ulang panggilan dan panggilan hilang