Android

Bagaimana perilaku Android bekerja

Pada Android, plugin mengirimkan pemberitahuan panggilan masuk dengan prioritas tinggi dan dapat meningkatkan aktivitas layar penuh ketika platform dan pengaturan 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 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() mengajukan izin pemberitahuan pada Android 13 dan seterusnya.
• requestFullScreenIntentPermission() Membuka halaman pengaturan Android 14 dan lebih lanjut 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 spesifik Android

• channelId: Identifikasi saluran peringatan
• channelName: Nama saluran peringatan yang dapat dilihat pengguna
• showFullScreen: Minta aktivitas penuh layar
• isHighPriority: Pastikan peringatan cukup mengganggu untuk aliran berdering
• accentColor: Tintkan permukaan peringatan yang kompatibel
• ringtoneUri: Poin ke sumber daya atau URI ringtone Android kustom

Catatan perilaku

• Pengaturan layar penuh yang paling baik adalah upaya. Jika perangkat atau pengaturan pengguna menghalanginya, Android masih menampilkan notifikasi panggilan masuk.
• Pengaturan waktu habis adalah upaya. Plugin ini mengikuti dan mengeluarkan timeoutMs dan callTimedOut, tetapi backend Anda harus menyesuaikan panggilan yang terlewat di sisi mereka.
• Aksi menerima, menolak, dan mengakhiri dikeluarkan kembali melalui pendengar Capacitor 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 menghandle satu mil terakhir antarmuka pengeringan native. Pegang tanggung jawab ini di luar plugin:

• Pendaftaran FCM dan manajemen token
• Lifecylce sesi media
• __CAPGO_KEEP_0__
• __CAPGO_KEEP_1__