Android

Bagaimana perilaku Android bekerja

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

The 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 mengandalkan presentasi panggilan masuk:

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

await IncomingCallKit.requestPermissions();
await IncomingCallKit.requestFullScreenIntentPermission();

• requestPermissions() Minta izin notifikasi pada Android 13 dan seterusnya.
• requestFullScreenIntentPermission() Membuka halaman pengaturan Android 14 dan seterusnya untuk intents 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: pengenal untuk saluran peringatan
• channelName: nama saluran peringatan yang dapat dilihat pengguna
• showFullScreen: minta aktivitas layar penuh
• isHighPriority: jaga peringatan cukup mengganggu untuk aliran berdering
• accentColor: tampilan konsisten dengan permukaan peringatan
• ringtoneUri: tampilkan di sumber daya ringtone Android yang disesuaikan atau URI

Catatan perilaku

• Pengaturan layar penuh adalah usaha terbaik. Jika perangkat atau pengaturan pengguna menghalanginya, Android masih menampilkan peringatan panggilan masuk.
• Pengaturan waktu habis dilakukan dengan baik. Plugin ini mengikuti dan mengeluarkan timeoutMs tetapi backend Anda harus menyesuaikan panggilan yang terlewat di sisi mereka. callTimedOutDiterima, menolak, dan mengakhiri aksi dikirim kembali melalui pemangku jawab __CAPGO_KEEP_0__ sehingga aplikasi Anda dapat bergabung atau membersihkan sesi panggilan nyata.
• Accept, decline, and end actions are emitted back through Capacitor listeners so your app can join or clean up the real call session.

Bab berjudul “Model produksi yang direkomendasikan”

Use Android push or your calling SDK for transport, then let this plugin handle the last mile of native ringing UI. Keep these responsibilities outside the plugin:

• Lingkaran hidup sesi media
• Keadaan panggilan backend
• Logika bisnis ulang coba dan panggilan terlewat
• Teruskan dari Android

__CAPGO_KEEP_0__

Jika Anda menggunakan Android untuk merencanakan media asli dan perilaku antarmuka, hubungkannya dengan Menggunakan @capgo/capacitor-kit-panggilan-masuk untuk kemampuan asli dalam Menggunakan @capgo/capacitor-kit-panggilan-masuk, Menggunakan @capgo/capacitor-aktivitas-hidup untuk kemampuan asli dalam Menggunakan @capgo/capacitor-aktivitas-hidup, @capgo/capacitor-aktivitas-hidup untuk detail implementasi dalam @capgo/capacitor-aktivitas-hidup, Menggunakan @capgo/capacitor-pemain-video untuk kemampuan asli dalam Menggunakan @capgo/capacitor-pemain-video, dan @capgo/capacitor-player Video untuk detail implementasi di @capgo/capacitor-player Video.