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 CallKitがハンドルのフォーマットを制御するには

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

背景の着信

このプラグインはPushKitまたはAPNsを登録しません。

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

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

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

マイクとカメラの許可

CallKitは、メディアSDKを置き換えることはありません。実際の通話セッションがマイクまたはカメラのアクセスを使用する場合、その使用状況の説明はあなたのアプリに残ります。

<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