__CAPGO_KEEP_0__

来电套件 Capacitor插件

使用 iOS CallKit 和 Android 全屏通知呈现原生来电 UI

安装

bun add @capgo/capacitor-incoming-call-kit bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-incoming-call-kit
  • pnpm add @capgo/capacitor-incoming-call-kit
  • yarn add @capgo/capacitor-incoming-call-kit

指南

如何在 Capacitor 中使用 Incoming Call Kit

使用 @capgo/capacitor-incoming-call-kit

Capacitor API 用于呈现原生 incoming-call 表面。

安装

bun add @capgo/capacitor-incoming-call-kit
bunx cap sync

bunx cap sync 复制插件的原生 code 到您的原生项目中。每次升级插件后都重新运行它。

导入

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

API 简要概述

方法 描述
showIncomingCall 显示原生 incoming call UI。
endCall 结束特定跟踪的呼叫。
endAllCalls 结束所有跟踪的呼叫。
getActiveCalls 返回当前跟踪的呼叫。
checkPermissions 获取当前通知和全屏意图的权限状态。
requestPermissions 在支持该平台的设备上请求通知权限。
requestFullScreenIntentPermission 在可用时打开安卓14+全屏意图设置页面。

示例

showIncomingCall()

显示原生 incoming call UI。

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

const result = await IncomingCallKit.showIncomingCall({
  callId: 'call-id-123',
  callerName: 'caller',
});
console.log(result);

endCall()

显示原生 incoming call UI。

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

const result = await IncomingCallKit.endCall({ callId: 'call-id-123' });
console.log(result);

endAllCalls()

结束特定跟踪的呼叫。

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

const result = await IncomingCallKit.endAllCalls();
console.log(result);

getActiveCalls()

结束所有跟踪的呼叫。

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

const result = await IncomingCallKit.getActiveCalls();
console.log(result);

checkPermissions()

获取当前通知和全屏意图的权限状态。

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

const result = await IncomingCallKit.checkPermissions();
console.log(result);

requestPermissions()

在支持该平台的设备上请求通知权限。

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

const result = await IncomingCallKit.requestPermissions();
console.log(result);

获取当前跟踪的呼叫。 上表列出了7个核心方法。监听器和版本帮助,以及每个方法的完整契约,均在GitHub仓库中文档化。.

监听事件

addListener 返回一个句柄。调用 handle.remove() 当屏幕卸载时,或者 IncomingCallKit.removeAllListeners() 清除所有监听器。

完整参考

继续使用 @capgo/capacitor-incoming-call-kit

如果您正在使用 使用 @capgo/capacitor-incoming-call-kit 来规划仪表板和 API 操作,连接它 @capgo/capacitor-incoming-call-kit 了解@capgo/capacitor-incoming-call-kit的实现细节 开始使用 了解开始使用的实现细节 API概述 了解API概述的实现细节 介绍 了解介绍的实现细节,并 API密钥 了解API密钥的实现细节

常见问题

Capacitor Incoming Call Kit插件常见问题

如何在Capacitor应用中安装Incoming Call Kit插件?

运行"bun add @capgo/capacitor-incoming-call-kit" (或"npm install @capgo/capacitor-incoming-call-kit"),然后运行"bunx cap sync"以使iOS和Android项目捕获到本地code。从"@capgo/capacitor-incoming-call-kit"中导入它,然后在应用code中使用它。

是否@capgo/capacitor-incoming-call-kit与React、Vue和Angular兼容?

是。Incoming Call Kit是一个Capacitor包,因此它与任何运行在Capacitor中的Web框架兼容,包括Ionic、React、Vue、Angular、Svelte和纯JavaScript。

哪个Capacitor版本@capgo/capacitor-incoming-call-kit支持?

Capgo插件遵循Capacitor的主要版本:使用与Capacitor主要版本匹配的插件主要版本(例如,插件v8与Capacitor 8)。在GitHub README中列出的兼容性表格列出了维护的版本。

是否@capgo/capacitor-incoming-call-kit免费且开源?

是。code的源代码在GitHub上公开,https://github.com/Cap-go/capacitor-incoming-call-kit/,并且可以从npm免费安装包。欢迎bug报告和拉取请求。

是否可以在App Store不需要审核更新@code使用Incoming Call Kit?

安装或升级插件会更改本机code,因此需要一个新的商店构建。之后,JavaScript、HTML和CSS更改,调用插件的更改,可以立即与Capgo实时更新一起发布。

无需等待应用程序审查即可将Incoming Call Kit更改推送

一旦插件在您的商店构建中,Capgo 即刻推送您的 JavaScript、HTML 和 CSS 更改到用户中。

开始使用 Capgo