Android

Bagaimana perilaku Android bekerja

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

Plugin manifest 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 gabungkan 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 notifikasi 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 khusus Android

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

Catatan perilaku

• Pengaturan layar penuh yang paling baik. Jika perangkat atau pengaturan pengguna menghalanginya, Android masih menampilkan notifikasi panggilan masuk.
• Penanganan waktu tunggu yang paling baik. Plugin ini mengikuti dan mengeluarkan timeoutMs dan callTimedOuttetapi backend Anda harus menyelesaikan 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

Pakai push Android atau SDK Anda untuk transportasi, lalu biarkan plugin ini menghandle satu mil terakhir UI berbunyi native. Pegang tanggung jawab ini di luar plugin:

• Pendaftaran FCM dan pengelolaan token
• Siklus hidup sesi media
• Status panggilan backend
• Logika bisnis ulangi dan panggilan hilang

Teruskan dari Android

Jika Anda menggunakan Android untuk merencanakan media dan perilaku antarmuka native, hubungkannya dengan Menggunakan @capgo/capacitor-incoming-call-kit untuk kemampuan native di Menggunakan @capgo/capacitor-incoming-call-kit, Menggunakan @capgo/capacitor-live-activities untuk kemampuan native di Menggunakan @capgo/capacitor-live-activities, @capgo/capacitor-live-activities untuk detail implementasi di @capgo/capacitor-live-activities, Menggunakan @capgo/capacitor-video-player untuk kemampuan native di Menggunakan @capgo/capacitor-video-player, dan @capgo/capacitor-video-player untuk detail implementasi di @capgo/capacitor-video-player.