Android

How Android behavior works

On Android, the plugin posts a high-priority incoming-call notification and can raise a full-screen activity when the platform and user settings allow it.

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

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

After installation, cap sync は、ホストアプリにその設定をマージするだけです。

Runtime permissions

onboardingまたはincoming-callの表示に依存する前に、以下のメソッドを呼びます:

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, and end actions are emitted back through Capacitor listeners so your app can join or clean up the real call session.

リスナーよりも戻されますので、実際のコールセッションに参加したり、クリーンアップしたりするためにアプリがこのアクションを使用できます。

Use Android push or your calling SDK for transport, then let this plugin handle the last mile of native ringing UI. Keep these responsibilities outside the plugin:

• Android Pushまたはコールの
• を使用してトランスポートし、最後のマイルのネイティブリングUIをこのプラグインが処理するようにしてください。プラグイン外でこれらの責任を保持してください:「FCM登録とトークン管理」、「メディアセッションライフサイクル」
• バックエンド呼び出し状態
• リトライとミスしたコールのビジネスロジック

Android から続ける

Capacitor を使用している場合 Android ネイティブメディアとインターフェイスの動作を計画するには、 Capacitor の @capgo/capacitor-incoming-call-kit を使用してネイティブ機能と接続する Capacitor の @capgo/capacitor-incoming-call-kit のネイティブ機能を使用する Capacitor の @capgo/capacitor-live-activities を使用してネイティブ機能と接続する Capacitor の @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の実装詳細