iOS

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

ハンドルタイプ

使用 ios.handleType 呼び出しキットがハンドルをフォーマットする方法を制御するために使用します。

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

バックグラウンドの着信

このプラグインは、PushKitまたはAPNsを登録することはありません。

iOSのバックグラウンドまたは終了状態のRINGINGを実現するには、iOSアプリのホストアプリでは、Apple Pushのネイティブ設定が必要です。

1. Apple Pushのデリバリを使用する場合に、Push通知を有効にします。
2. VoIP Pushフローの場合に、VoIPバックグラウンドモードを有効にします。
3. Capacitor ブリッジが利用可能になったら、このプラグインを呼び出して、着信イベントをアプリに通知します。

アプリがすでにフォアグラウンドで実行されている場合、JavaScript上のRINGイベントが存在する場合、最適なエクスペリエンスが得られます。

マイクとカメラの許可

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