Android

Androidの動作の仕組み

Androidでは、このプラグインは高優先度の着信通知を送信します。また、プラットフォームやユーザーの設定が許可していれば、全画面のアクティビティを表示できます。

プラグインのmanifestには、既に以下が含まれています：

<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バックエンド側でも不在着信の突き合わせを行ってください。
• 応答・拒否・終了のアクションは Capacitor リスナー経由で返されるので、アプリ側で実際の通話セッションへの参加やクリーンアップを行えます。

推奨される本番環境のモデル

通信にはAndroidプッシュまたは通話用の SDK を使い、ネイティブ着信UIの最後の仕上げはこのプラグインに任せてください。次の責務はプラグインの外に置いてください：

• FCMの登録とトークン管理
• メディアセッションのライフサイクル
• バックエンドの通話ステート
• リトライと不在着信のビジネスロジック

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