Android

Bagaimana perilaku Android bekerja

Pada Android, plugin ini memposting notifikasi panggilan masuk dengan prioritas tinggi dan dapat meningkatkan 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 itu 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() mengajukan izin 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 spesifik Android

• channelIdidentifier untuk saluran notifikasi
• channelNamenama saluran notifikasi yang dapat dilihat pengguna
• showFullScreenminta aktivitas penuh layar
• isHighPrioritytetapkan notifikasi cukup mengganggu untuk aliran berdering
• accentColortintkan permukaan notifikasi yang kompatibel
• ringtoneUri: poin ke arah suara notifikasi panggilan yang diatur sendiri Android

Catatan perilaku

• Pengaturan layar penuh adalah yang paling baik. Jika perangkat atau pengaturan pengguna menghalanginya, Android masih menampilkan notifikasi panggilan masuk.
• Pengaturan waktu habis adalah yang paling baik. Plugin ini mengikuti timeoutMs dan mengirimkan callTimedOuttetapi backend Anda masih harus menyelesaikan panggilan yang terlewat di sisi mereka.
• Aksi menerima, menolak, dan mengakhiri dikirim kembali melalui pendengar Capacitor sehingga aplikasi Anda dapat bergabung atau membersihkan sesi panggilan nyata.

Model produksi yang disarankan

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

• Pendaftaran FCM dan pengelolaan token
• Lifecycle Media Session
• Status Panggilan Backend
• Logika Ulang dan Tidak Terjawab

Teruskan dari Android

Jika Anda menggunakan Android untuk merencanakan perilaku media dan interface 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-aktivitas-hidup-nyata untuk detail implementasi di @capgo/capacitor-aktivitas-hidup-nyata, Menggunakan @capgo/capacitor-player-video untuk kemampuan asli di Menggunakan @capgo/capacitor-player-video, dan @capgo/capacitor-player-video untuk detail implementasi di @capgo/capacitor-player-video.