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は着信通知を表示します。
タイムアウトのハンドリングはベストエフォートです。プラグインは 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.

受付、断り、終了のアクションは__CAPGO_KEEP_0__リスナーよりも戻されます。アプリが実際のコールセッションに参加したり、クリーンアップしたりすることができます。

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または呼び出し__CAPGO_KEEP_0__を使用してトランスポートし、最後のマイルのネイティブリングUIをこのプラグインが処理するようにしてください。プラグイン外でこれらの責任を保持してください:
FCM登録とトークン管理
バックエンドの呼び出し状態
リトライとミスしたコールのビジネスロジック

Androidから続ける

Capacitorを使用している場合 Android ネイティブメディアとインターフェイスの動作を計画するには、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-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 Capacitorライブアクティビティの実装詳細については、@capgo/capacitor-live-activitiesを参照してください。 Using @capgo/capacitor-video-player for the native capability in Using @capgo/capacitor-video-player, and @capgo/capacitor-video-player Capacitorビデオプレーヤーの実装詳細については、@capgo/capacitor-video-playerを参照してください。