メインコンテンツへスキップ
@capgo/capacitor-incoming-call-kit コミュニケーション オープンソース

着信表示キット 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

インストール

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

bunx cap sync プラグインのネイティブcodeをネイティブプロジェクトにコピーします。プラグインをアップグレードするたびに再度実行してください。

インポート

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

API の概要

メソッド 説明
showIncomingCall ネイティブの着信UIを表示します。
endCall 追跡中の特定の通話を終了します。
endAllCalls 追跡中のすべての通話を終了します。
getActiveCalls 現在追跡中の通話一覧を返します。
checkPermissions 通知とフルスクリーンインテントの現在の権限状態を返します。
requestPermissions プラットフォームが対応している場合、通知権限をリクエストします。
requestFullScreenIntentPermission 利用可能な場合、Android 14以降のフルスクリーンインテント設定画面を開きます。

例

showIncomingCall()

ネイティブの着信UIを表示します。

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

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

endCall()

追跡中の特定の通話を終了します。

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 Keys の実装詳細については、

よくある質問

Incoming Call Kit プラグイン FAQ

Capacitor アプリに Incoming Call Kit プラグインをインストールするにはどうすればよいですか?

まず "bun add @capgo/capacitor-incoming-call-kit" (または "npm install @capgo/capacitor-incoming-call-kit") を実行し、次に "bunx cap sync" を実行して、iOS および Android プロジェクトにネイティブの code を反映させます。その後、アプリの code から "@capgo/capacitor-incoming-call-kit" をインポートしてください。

@capgo/capacitor-incoming-call-kit は React、Vue、Angular で動作しますか?

はい。Incoming Call Kit は Capacitor パッケージなので、Ionic、React、Vue、Angular、Svelte、素の JavaScript など、Capacitor 内で動く Web フレームワークならどれでも使えます。

@capgo/capacitor-incoming-call-kit はどの Capacitor バージョンをサポートしていますか?

Capgo プラグインは Capacitor のメジャーバージョンに合わせています。使用している Capacitor のメジャーバージョンに一致するプラグインのメジャーバージョンを使ってください (例: Capacitor 8 ならプラグイン v8)。GitHub の README にある互換性テーブルに、メンテナンス中のバージョンが記載されています。

@capgo/capacitor-incoming-call-kitは無料かつオープンソースですか?

はい。codeのソースコードはGitHub上の https://github.com/Cap-go/capacitor-incoming-call-kit/ で公開されており、npmから無料でインストールできます。バグ報告やプルリクエストもお待ちしています。

Incoming Call Kitを使用しているcodeを、App Storeの審査なしでアップデートできますか?

プラグインのインストールやアップグレードはネイティブの code を変更するため、新しいストアビルドが必要です。その後は、プラグインを呼び出す JavaScript、HTML、CSS の変更を Capgo Live Updates で即座に配信できます。

アプリの審査を待たずに Incoming Call Kit の変更をリリース

プラグインをストア用ビルドに組み込めば、Capgo live updates で JavaScript、HTML、CSS の変更を数分でユーザーに配信できます

Capgo から始める