メインコンテンツへスキップ

​
概要

OneSignalは、AndroidとiOSの両方のプラットフォームでVoIP通知の送信をサポートしています。ただし、OneSignal SDKは現在VoIPトークン登録をサポートしていません。このガイドでは、OneSignalのAPIとプラットフォームセットアップを使用してVoIP通知を手動で構成する方法について説明します。

​
Android VoIPセットアップ

iOSとは異なり、Androidは専用の「VoIPプッシュ」タイプを使用しません。データのみのプッシュ通知を使用してActivityを開始したり、カスタムUIを表示したりすることで、VoIPのような動作を実現できます。 ネイティブUI（例：着信画面）を起動する場合は、AndroidのNotificationExtenderServiceを使用して通知の動作をオーバーライドします。 詳細なガイダンス：

​
iOS VoIPセットアップ

1

アプリにPushKitを追加

AppleのPushKit APIを使用して、VoIPトークンを登録して受信します。実装のヒントについては、AppleのVoIPベストプラクティスを参照してください。
2

VoIPユーザー用の新しいOneSignalアプリを作成

2つの別々のOneSignalアプリを維持する必要があります：
  • メインプッシュアプリ：標準プッシュ通知用
  • VoIPアプリ：VoIP固有の通知用
メインアプリと同じバンドルIDを使用して、VoIPアプリ用の**VoIPサービス証明書（.p12）**をアップロードしてください。

Keychain AccessのP12

VoIP証明書のスクリーンショット

3

VoIPトークンでデバイスを登録

Create User APIを使用して、VoIP専用OneSignalアプリにVoIPトークンを登録します。注意： 開発/サンドボックス環境でデバイスを登録する場合は、"test_type": 1プロパティを含めてください。これを省略すると、"Mismatched Subscription Environment"エラーまたは通知の失敗が発生する可能性があります。
curl --request POST \
     --url https://api.onesignal.com/apps/YOUR_VOIP_APP_ID/users \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "subscriptions": [
    {
      "type": "iOSPush",
      "token": "your-voip-token",
      "test_type": 1 // omit in production
    }
  ]
}
'
後でトークンを更新するには、Update Subscription APIを使用します。
4

VoIP通知を送信

Create Notification APIを使用し、次のパラメーターを含めます：
  • "apns_push_type_override": "voip"
  • VoIPアプリのapp_id
curl --include \
     --request POST \
     --header "Content-Type: application/json; charset=utf-8" \
     --header "Authorization: key YOUR_REST_API_KEY" \
     --data-binary '{
  "app_id": "YOUR_VOIP_APP_ID",
  "contents": {"en": "English Message"},
  "apns_push_type_override": "voip",
  "include_subscription_ids": ["YOUR_VOIP_SUBSCRIPTION_ID"]
}' \
https://api.onesignal.com/notifications

​
FAQ

いいえ、確認済み配信はVoIPプッシュでは追跡されません。Notification Service Extensionに依存していますが、これはVoIP通知ではトリガーされません。代わりに、ネイティブiOS PushKitイベントを介して受信を追跡します：
pushRegistry(_:didReceiveIncomingPushWith:for:completion:)
このイベントはメインアプリターゲットの一部であり、個別の拡張機能は必要ありません。詳細については、AppleのVoIPドキュメントを参照してください。