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 menyatukan konfigurasi tersebut ke dalam aplikasi host.

Izin waktu eksekusi

Panggil metode-metode ini selama proses pendaftaran 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 permintaan pada Android 13 dan seterusnya.
• requestFullScreenIntentPermission() Membuka halaman pengaturan Android 14 dan seterusnya untuk intents layar penuh 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

• channelIdIdentifikasi untuk saluran notifikasi
• channelNameNama saluran notifikasi yang dapat dilihat oleh pengguna
• showFullScreen: meminta aktivitas layar penuh
• isHighPriority: pastikan notifikasi cukup mengganggu untuk aliran berdering
• accentColor: memberi warna notifikasi permukaan yang kompatibel
• ringtoneUri: menunjuk ke sumber suara dering Android yang diatur sendiri atau URI

Catatan perilaku

• Pengaturan layar penuh yang paling baik usaha. Jika perangkat atau pengaturan pengguna menghalanginya, Android masih menampilkan notifikasi panggilan masuk.
• Pengelolaan waktu tunggu adalah usaha paling baik. Plugin ini mengikuti dan mengeluarkan timeoutMs dan callTimedOut, tetapi backend Anda harus menyesuaikan panggilan yang terlewat di sisi mereka.
• Aksi terima, tolak, dan akhiri 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 jarak terakhir UI berbunyi native. Tahan tanggung jawab ini di luar plugin:

• Pendaftaran FCM dan manajemen token
• Siklus hidup media
• Keadaan panggilan backend
• Logika bisnis retry dan panggilan hilang

Lanjutkan dari Android

Jika Anda menggunakan Android untuk merencanakan media dan perilaku antarmuka native, hubungkannya dengan Menggunakan @capgo/capacitor-kit panggilan masuk untuk kemampuan asli di Menggunakan @capgo/capacitor-incoming-call-kit, Menggunakan @capgo/capacitor-live-activities untuk kemampuan asli 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 asli di Menggunakan @capgo/capacitor-video-player, dan @capgo/capacitor-video-player untuk detail implementasi di @capgo/capacitor-video-player.