安卓

复制一个包含安装步骤和此插件的完整Markdown指南的设置提示。

Android 行为如何工作

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

该插件清单已经包含：

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

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

运行时权限

在用户登录或您依赖 incoming-call 展示之前，请调用这些方法：

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,但您的后端仍应在其侧重新协调丢失的呼叫。
接受、拒绝和结束动作通过 Capacitor 监听器反射回您的应用程序，以便您的应用程序可以加入或清理真实的呼叫会话。

继续从 Android

如果您正在使用 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-video-player 为 @capgo/capacitor-video-player 的实现细节

安卓