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

Android特有的选项

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

行为说明

• 全屏展示是尽力而为的。如果设备或用户设置阻止它，Android仍然会显示来电通知。
• 超时处理是尽力而为的。该插件跟踪和发送 timeoutMs ，但您的后端仍应在其侧重新协调丢失的呼叫。 callTimedOut接受、拒绝和结束动作通过 __CAPGO_KEEP_0__ 监听器发送回给您的应用程序，以便您的应用程序可以加入或清除真实呼叫会话。
• Accept, decline, and end actions are emitted back through Capacitor listeners so your app can join or clean up the real call session.

标题：推荐的生产模型

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:

• 媒体会话生命周期
• 后端呼叫状态
• 重试和丢失呼叫的商业逻辑
• 继续使用 Android

__CAPGO_KEEP_0__

如果您正在使用 Android 来规划原生媒体和界面行为，连接它与 使用 @capgo/capacitor-incoming-call-kit 原生能力在使用 @capgo/capacitor-incoming-call-kit 中 使用 @capgo/capacitor-live-activities 原生能力在使用 @capgo/capacitor-live-activities 中 @capgo/capacitor-live-activities 原生能力在 @capgo/capacitor-live-activities 中 使用 @capgo/capacitor-video-player 原生能力在使用 @capgo/capacitor-video-player 中 @capgo/capacitor-视频播放器 了解 @capgo/capacitor-视频播放器 的实现细节。