Android

Androidの動作方法

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

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

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

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

実行時許可

インコmingコールのプレゼンテーションに依存する前に、またはオンボーディング中に、次のメソッドを呼びます。

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、および終了アクションは、Capacitor リスナーの通じてバックエンドで実行されるため、実際の呼び出しが開始される前にアプリが参加またはクリーンアップできます。

推奨の生産モデル

Android のプッシュ通知または呼び出し SDK を使用してトランスポートし、このプラグインがネイティブのリングUIを処理する最後のマイルを任せます。これらの責任はプラグイン外に保ちます。

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