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

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 の概要」の実装の詳細については、 はじめに Introduction の実装詳細、および 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から無料でインストールできます。バグ報告やプルリクエストをお待ちしています。

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

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

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

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

Capgo から始める