Android

Android 行为的工作原理

在 Android 上，插件会发布一个高优先级的 incoming-call 通知，并在平台和用户设置允许时可以弹出一个全屏活动。

插件清单已经包含：

<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<uses-permission android:name="android.permission.USE_FULL_SCREEN_INTENT" />

安装后， cap sync 仅需将该配置合并到您的主应用中即可。

运行时权限

复制到剪贴板

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

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

• requestPermissions() How Android behavior works
• requestFullScreenIntentPermission() 打开 Android 14 和更高版本的全屏意图设置页面。

基本示例

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',
  },
});

Android 专用选项

• channelId通知渠道标识符
• channelName用户可见的渠道名称
• showFullScreen请求全屏活动
• isHighPriority保持通知足够的打扰以适应铃声流
• accentColor适配通知表面的颜色
• ringtoneUri指向一个自定义 Android 铃声资源或 URI

行为备注

• 全屏展示最佳实践。如果设备或用户设置阻止它，Android仍会显示来电通知。
• 超时处理最佳实践。插件跟踪 timeoutMs 并通过 callTimedOut,但您的后端仍应在其侧重新协调丢失的呼叫。
• 接受、拒绝和结束动作通过Capacitor侦听器发回给您的应用程序，以便您的应用程序可以加入或清理真实呼叫会话。

推荐生产模型

使用Android推送或您的呼叫SDK进行传输，然后让此插件处理本机铃声UI的最后一英里。将这些责任保持在插件外：

• FCM注册和令牌管理
• 媒体会话生命周期
• __CAPGO_KEEP_0__
• __CAPGO_KEEP_1__