無料で始める

iOSの動作方法

iOSでは、プラグインはCallKitに着信を報告します。これにより、システムの着信シートと標準化されたコールアクションが提供されます。独自のネイティブの着信UIを構築する必要はありません。

requestPermissions() iOSでは、CallKit自体が実行時許可ダイアログを必要としないため、すぐに解決されます。

基本的な例

import { IncomingCallKit } from '@capgo/capacitor-incoming-call-kit';

await IncomingCallKit.showIncomingCall({
  callId: 'call-42',
  callerName: 'Ada Lovelace',
  handle: '+1 555 010 020',
  ios: {
    handleType: 'phoneNumber',
    supportsHolding: true,
    supportsDTMF: false,
  },
});

ハンドルタイプ

Use ios.handleType to

• generic アプリ固有の識別子用
• phoneNumber 実際の電話番号用
• emailAddress メールベースのアイデンティティ用

バックグラウンドIncomingコール

このプラグインはPushKitまたはAPNsの登録を行わない。

iOSの真のバックグラウンドまたは終了状態のリング音を実現するには、ホストアプリは、トランスポート戦略に合ったネイティブのAppleプッシュセットアップが必要です。

1. トランスポートがAppleプッシュ配信を使用する場合、Push通知を有効にします。
2. VoIPプッシュフローを使用するアプリでは、VoIPバックグラウンドモードを有効にします。
3. Incomingコールイベントをアプリに送信し、このプラグインをCapacitorブリッジが利用可能になるまで呼び出します。

アプリがすでにフォアグラウンドで実行されている場合、JavaScriptのリングイベントが存在する場合、最良のエクスペリエンスを得ることができます。

マイクとカメラの許可

CallKit does not replace your media SDK. If the real call session uses microphone or camera access, those usage descriptions still belong in your app:

<key>NSMicrophoneUsageDescription</key>
<string>This app uses the microphone for calls.</string>
<key>NSCameraUsageDescription</key>
<string>This app uses the camera for video calls.</string>

必要なキーにのみ追加してください。

アプリ層でこれらの責任を維持してください。

• PushKitとAPNsの登録
• 認証とトークン更新
• 実際のルームまたはVoIPセッションに参加する callAccepted
• プラグインが発行したときに遠隔コールの状態を終了または整理する callDeclined, callEnded, または callTimedOut

iOSから続けてください

Capgoを使用している場合、Incoming Call Kitプラグインを使用できます。 iOS を使用してネイティブ プラグインの作業を計画する場合、以下の手順に従ってください。 Using @capgo/capacitor-incoming-call-kit for the native capability in Using @capgo/capacitor-incoming-call-kit Capgo プラグイン ディレクトリ for the product workflow in Capgo Plugin Directory Capacitor CapgoによってCapgo for the implementation detail in Capacitor Plugins by Capgo プラグインの追加または更新 for the implementation detail in Adding or Updating Plugins, and Ionic Enterprise プラグイン代替 Ionic Enterprise プラグイン代替の製品ワークフロー