Android

Androidの動作のしくみ

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

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

<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はIncoming Call通知を表示します。
• タイムアウトのハンドリングはベストエフォートです。プラグインは timeoutMs と発行 callTimedOutですが、バックエンド側で未処理の通話を再調整するようにしてください。
• Accept、decline、endアクションはCapacitorリスナーを通じて再度エミットされ、実際の通話セッションに参加またはクリーンアップすることができます。

推奨の生産モデル

Android Pushまたは呼び出しSDKを使用してトランスポートを実行し、最後のマイルのネイティブリングUIをこのプラグインでハンドルしてください。このプラグイン外で責任を負うものは次のとおりです:

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

Androidから続ける

あなたが使用している場合 Android ネイティブメディアとインターフェイスの動作を計画するには、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-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の実装詳細については@capgo/capacitor-live-activitiesを参照してください。 Capgoの@capgo/capacitor-video-playerを使用します。 Capgoの@capgo/capacitor-video-playerを使用して、ネイティブ機能を実装します。 Capgoの@capgo/capacitor-video-player Capgoの実装詳細については@capgo/capacitor-video-playerを参照してください。