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() 在 Android 13 及后续版本中请求通知权限。
• 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',
  },
});

安卓特定选项

• channelId__CAPGO_KEEP_0__
• channelName__CAPGO_KEEP_0__
• showFullScreen请求全屏活动
• isHighPriority保持通知足够打扰以响铃流
• accentColor使通知与兼容的表面着色
• ringtoneUri指向一个自定义Android铃声资源或URI

行为说明

• 超时处理是尽力而为。插件跟踪
• 和发射 timeoutMs Section titled “Behavior notes” callTimedOut, 但您的后端仍应在其侧重新协调未接通呼叫。
• 通过 Capacitor 监听器回传的接受、拒绝和结束动作，使您的应用程序能够加入或清理实际呼叫会话。

推荐生产模型

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

• FCM 注册和令牌管理
• 媒体会话生命周期
• 后端呼叫状态
• 重试和未接通呼叫业务逻辑