Android

Androidの動作方法

Android上では、プラグインは高優先度の着信通知を投稿し、プラットフォームとユーザー設定が許可する場合、フルスクリーンアクティビティを上げます。

プラグインマニフェストにはすでに含まれています:

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

インストール後、 cap sync あとはホストアプリにその設定をマージするだけです。

実行時許可

Android 13 以降の場合、Incoming-call の表示に依存する前に、または Onboarding の際に、次のメソッドを呼びます:

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を発行しますが、バックエンド側ではまだミスしたコールを整合する必要があります。
• Accept、decline、endアクションはCapacitorリスナーを通じて再度発行されるため、実際のコールセッションに参加したり、クリーンアップしたりするためにアプリが参加できます。

推奨の生産モデル

Android Pushまたは呼び出しSDKを使用してトランスポートを実行し、最後のマイルのネイティブリングUIをこのプラグインが処理するようにしてください。プラグイン外でこれらの責任を保持してください:

• FCMの登録とトークン管理
• メディアセッションライフサイクル
• バックエンドコールの状態
• リトライとミスしたコールのビジネスロジック

Androidから続けてください

あなたが Android を使用して Using @capgo/capacitor-incoming-call-kit @capgo/capacitor-incoming-call-kit Using @capgo/capacitor-live-activities @capgo/capacitor-incoming-call-kit @capgo/capacitor-live-activities @capgo/capacitor-live-activities Using @capgo/capacitor-video-player @capgo/capacitor-live-activities、のネイティブ機能の使用と @capgo/capacitor-video-player @capgo/capacitor-video-player