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 ringtone リソースまたは URI をポイントします。

挙動の注記

フルスクリーン表示はベストエフォートです。デバイスまたはユーザー設定がブロックした場合、Android は着信通知を表示します。
タイムアウトのハンドリングはベストエフォートです。プラグインは timeoutMs と発行します。 callTimedOut,
受信コールキットのアクションは、Capacitor リスナーの通じて発行されます。アプリは実際のコールセッションに参加したり、クリーンアップしたりできます。

ですが、バックエンド側で未接続の電話を再調整する必要があります。

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:

Section titled “Recommended production model”
メディアセッションライフサイクル
バックエンドコール状態
再接続と未接続電話のビジネスロジック

Androidから続ける

あなたが使用している Android を使用して、ネイティブのメディアとインターフェイスの動作を計画する場合、以下のコードを使用してそれを接続してください。 Using @capgo/capacitor-incoming-call-kit Using @capgo/capacitor-incoming-call-kit @capgo/capacitorライブアクティビティを使用 Using @capgo/capacitor-live-activities @capgo/capacitor-ライブアクティビティ @capgo/capacitor-live-activities Capgo @capgo/capacitor-video-player Capgo @capgo/capacitor-video-player @capgo/capacitor-video-player @capgo/capacitor-video-playerの実装詳細のために。