プッシュ通知
アプリがバックグラウンド状態にある場合や強制終了された場合でも、着信を確実に届けるためには、プッシュ通知が必要です。
ステップごとの解説
-
onCallInvite リスナーを登録する — 何よりもまず、アプリは
onCallInviteリスナー。これにより、プッシュ通知が届いた際にコールバックが確実に実行されるようになります。 -
着信 — 発信者が、あなたのユーザーを宛先とする通話を開始します。Vonage APIは宛先を特定し、そのユーザーのデバイスにプッシュ通知が必要かどうかを判断します。
-
招待ペイロードを送信する — Vonage APIは、通話招待のペイロードをプラットフォームのプッシュ通知サービス(iOSの場合はAPNs、Androidの場合はFCM)に送信します。
-
プッシュ配信 — プッシュサービスは、通知をデバイスのOSに配信します。iOSでは、PushKit(VoIPプッシュ)を介して配信されます。Androidでは、FCMのデータメッセージを介して配信されます。
-
プッシュコールバック — OSは、プッシュペイロードをアプリのプッシュハンドラに配信します:
- iOS: 電話
processCallInvitePushDataPushKit デリゲートのコールバック内。 - アンドロイド: 電話
processPushCallInvite内部onMessageReceived.
- iOS: 電話
-
onCallInvite コールバックが実行される — SDKはプッシュペイロードを処理し、
onCallInvite. 着信時のUIに発信者情報を表示し、通話を受ける/拒否する操作を提示する。
導入前に、Applicationsの認証情報について、Vonageダッシュボードでのプッシュ設定を完了してください:
プラットフォームガイド
完全なコードサンプル、フロー図、エラー処理、本番環境チェックリストなどを含む包括的な実装手順については、プラットフォーム別のガイドをご覧ください:
- iOSプッシュ通知ガイド — PushKit、CallKit、オーディオセッションのハンドオフ、およびよくある落とし穴
- Androidプッシュ通知ガイド — FCM、テレコム・フレームワーク、ConnectionService、およびフォアグラウンド・サービスの要件
Web SDKでは、着信する音声招待について、ネイティブなモバイル式のプッシュ通知は使用しません。招待は、WebSocketセッションがアクティブな間に、そのセッションを介して配信されます。