Android

Androidの動作のしくみ

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

__CAPGO_KEEP_3__

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

インストール後、 cap sync __CAPGO_KEEP_4__

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

初回起動時またはIncomingCallPresentationを使用する前に、次のメソッドを呼びます。

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',
  },
});

通知チャンネルの識別子

• channelIdruntime permissions
• channelNameAndroid 13以降
• showFullScreen: incoming call をフルスクリーンで表示
• isHighPriority: 通知を鳴動する流れに十分に妨げる
• accentColor: 通知の色合いを互換性のある表現に合わせる
• ringtoneUri: カスタム Android リングトーンのリソースまたは URI を指定

行動に関する注意点

• フルスクリーン表示はベストエフォートです。デバイスまたはユーザー設定がブロックした場合、Android は着信通知を表示します。
• タイムアウトの扱いはベストエフォートです。プラグインはタイムアウトを追跡し、 timeoutMs ですが、バックエンドではまだミスしたコールを調整する必要があります。 callTimedOut受付、断り、終了のアクションは __CAPGO_KEEP_0__ リスナーの通じて戻されます。アプリは実際のコールセッションに参加したり、クリーンアップしたりできます。
• Accept, decline, and end actions are emitted back through Capacitor listeners so your app can join or clean up the real call session.

recommendedProductionModel

Androidのプッシュ通知または、SDKで呼び出しを実行し、最後のマイルのネイティブリングUIをこのプラグインが処理するようにしてください。これらの責任をプラグイン外に保つようにしてください:

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

Androidから続ける

あなたが使用している場合 Android ネイティブメディアとインターフェイスの動作を計画する場合に接続する Using @capgo/capacitor-incoming-call-kit native機能の使用に@capgo/capacitor-incoming-call-kitを使用します。 @capgo/capacitor-live-activitiesを使用します。 native機能の使用に@capgo/capacitor-live-activitiesを使用します。 @capgo/capacitor-live-activities @capgo/capacitor-live-activitiesの実装詳細 @capgo/capacitor-video-playerを使用します。 native機能の使用に@capgo/capacitor-video-playerを使用します。 @capgo/capacitor-video-player @capgo/capacitor-video-playerの実装詳細