Android

Androidの動作のしくみ

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

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

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

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

ランタイムパーミッション

onboarding またはincoming-call presentation に頼る前に、次のメソッドを呼びます。

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: __CAPGO_KEEP_0__
• channelName: __CAPGO_KEEP_1__
• showFullScreen: __CAPGO_KEEP_2__
• isHighPriority: __CAPGO_KEEP_3__
• accentColor: __CAPGO_KEEP_4__
• ringtoneUri: __CAPGO_KEEP_5__

通知チャンネル識別子

• フルスクリーンアクティビティを要求
• リング音のフローで通知を断続的に表示する timeoutMs 通知の色合いを調整 callTimedOutカスタムのAndroidリング音リソースまたはURIを指定
• 受信アクション、拒否、アクションの終了は、Capacitor リスナーよりも実際のコールセッションに参加したり、クリーンアップしたりするために戻されます。

推奨の生産モデル

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

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