Android

How Android behavior bekerja

Pada Android, plugin mengirimkan notifikasi panggilan masuk dengan prioritas tinggi dan dapat meningkatkan aktivitas layar penuh ketika pengaturan platform dan 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 itu sudah cukup untuk menggabungkan konfigurasi ke 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',
  },
});

Opsi khusus Android

• channelId: identifikasi untuk saluran peringatan
• channelName : nama saluran peringatan yang dapat dilihat pengguna
• showFullScreen : meminta aktivitas penuh layar
• isHighPriority : menjaga peringatan cukup mengganggu untuk aliran berdering
• accentColor : menyesuaikan warna notifikasi dengan permukaan yang kompatibel
• ringtoneUri : menunjuk ke sumber atau URI ringtone Android yang disesuaikan

Catatan perilaku

• Pengaturan layar penuh berfungsi dengan baik. Jika perangkat atau pengaturan pengguna menghalanginya, Android masih menampilkan notifikasi panggilan masuk.
• Pengaturan waktu habis berfungsi dengan baik. Plugin ini mengikuti dan mengirimkan __CAPGO_KEEP_0__ , tetapi backend Anda harus menyelesaikan panggilan yang terlewat di sisi mereka. timeoutMs Aksi menerima, menolak, dan mengakhiri dikirim kembali melalui pendengar __CAPGO_KEEP_0__ sehingga aplikasi Anda dapat bergabung atau membersihkan sesi panggilan nyata. callTimedOutModel produksi yang disarankan
• Accept, decline, and end actions are emitted back through Capacitor listeners so your app can join or clean up the real call session.

Gunakan push Android atau __CAPGO_KEEP_0__ panggilan Anda untuk transportasi, kemudian biarkan plugin ini menghandle satu mil terakhir antarmuka pengeringan native. Pegang tanggung jawab ini di luar plugin:

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:

• Pengaturan layar penuh berfungsi dengan baik. Jika perangkat atau pengaturan pengguna menghalanginya, Android masih menampilkan notifikasi panggilan masuk.
• Pengaturan waktu habis berfungsi dengan baik. Plugin ini mengikuti dan mengirimkan __CAPGO_KEEP_0__ , tetapi backend Anda harus menyelesaikan panggilan yang terlewat di sisi mereka.
• Status panggilan backend
• Logika bisnis panggilan ulang dan terlewat

Lanjutkan dari Android

Jika Anda menggunakan Android untuk merencanakan perilaku media dan antarmuka native, hubungkannya dengan Menggunakan @capgo/capacitor-kit-panggilan-masuk untuk kemampuan native di Menggunakan @capgo/capacitor-kit-panggilan-masuk, Menggunakan @capgo/capacitor-aktivitas-hidup untuk kemampuan native di Menggunakan @capgo/capacitor-aktivitas-hidup, @capgo/capacitor-aktivitas-hidup 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.