Skip to main content

Android 用プッシュ通知

前提条件

Android 通知チャネルの構成

Firebase セットアップ

使用および同期する必要がある Google ウェブサイトが 3 つあります。Google/Firebase には Projects と Apps の両方があります:
  • Project:
    • まだ存在しない場合、プロジェクトを Firebase Console にインポートします。
  • App:

PlayFab はサーバー秘密キー ファイルを必要とします

  • この秘密キー ファイルは Firebase Console から入手できます
  • Firebase Console:
    • Project または App を選択し、Settings オプションを見つけます (これを行う方法は多数あり、すべて同じ場所に移動します)。
    • Service accounts タブで、Generate new private key ボタンを選択して JSON ファイルをダウンロードします。

秘密キー ファイルの使用

  • 次の 2 つの方法のいずれかで秘密キー ファイルを提供します:
    1. 秘密キー ファイルを Game Manager UI に直接アップロード: Settings (Title の) > Push Notifications > Android
    2. または、Server API メソッドを有効にした Postman または Unity プロジェクトを使用して、SetupPushNotification を呼び出します。
    • Name: your_game_name
    • Platform: GCM
    • Credential: (秘密キー ファイルの内容を文字列として): { ... }
    • Overwrite OldARN: true
    • 次のようなデータを含む HTTP 200 OK 応答を受信するはずです。
  • 適切にセットアップされたら (どちらの方法でも)、Game Manager UISettings (タイトルの) > Push Notifications > Android でこれが表示されるはずです。 PlayFab 設定 - プッシュ通知 - Android

使い始め: Android + Unity 用プッシュ通知

Unity プロジェクトをセットアップするには:
  • 新しい Unity プロジェクトを作成します。
  • 任意 PlayFab Unity Editor Extensions パッケージをインポートします。
  • Unity PlayFab SDK パッケージをインポートします。
  • FCM Unity ガイドに従って FCM メッセージングをインストールし、プッシュ通知用にプロジェクトをセットアップします。
    • 完了したら、このガイドを続けて PlayFab からメッセージを受信できます。
    • 次の例では、FCM と PlayFab を組み合わせた完全な FCM 対応 monoBehaviour スクリプトを提供します。
  • FCM ガイドで、Firebase プラグインをセットアップする monobehavior スクリプトを作成しました。
    • その monobehavior スクリプトを使用し続けるか、次の例のものに置き換えることができます。

最初のプッシュ通知のセットアップ

Unity で、FCM チュートリアルで作成したスクリプトを開き、内容を置き換えます。
Unity プロジェクトをビルドしてデバイスで実行します。Push notifications registered successfully というテキストのプッシュ通知を受信できれば、すべてが期待どおりに動作しています。
PlayFabSettings.TitleId = TITLE_ID。ご自分の TitleId を設定する必要があります。この例は、この TitleId を更新しない場合は動作しません。当社のタイトルは当社の Firebase キーと設定で登録されているためであり、お客様の ものではありません。この行のコメントを外して TITLE_ID をご自分の titleId に置き換えるか、前のセクションで言及した任意の Editor Extensions プラグインからタイトルを選択できます。

Android のトラブルシューティング

  • Firebase Console からテスト プッシュ通知を送信できることを確認します。
    • できない場合、Firebase プラグインが正しくセットアップされていないため、Firebase ドキュメントを確認して理由を調べるか、Firebase サポートに問い合わせる必要があります。
  • FCM クライアントの pushToken が適切に設定されていることを確認します。
    • 例の OnTokenReceived 関数が呼び出され、有効なトークンを持っているはずです。
    • 呼び出され ない 場合、Firebase プラグインが 正しく セットアップされていないため、Firebase ドキュメントを確認して理由を調べるか、Firebase サポートに問い合わせる必要があります。
  • titleId が所有するタイトルに設定され、Firebase プロジェクトのサーバー API キーで登録されていることを確認します。

高度な機能

server.SendPushNotification では、request.Package.CustomData を使用して任意のデータをデバイスに配信できます。前の例では、これは次のコメントを持つセクションに配信されます。
そのデータを利用するようにクライアント レシーバーを好みに応じてカスタマイズできます。CustomData はプレイヤーに表示されないため、カスタム ゲーム情報をクライアントに配信したり、FCM プラグインを使用してローカルに将来別の通知をスケジュールしたりするために使用できます。 request.Package.CustomData または AdvancedPlatformDelivery を使用して、多くのサードパーティ プラグインに配信することもできます。
サードパーティ プラグインの配信はサポートされておらず保証されませんが、上級ユーザー向けに利用可能です。

追加のサポート

ヘルプ、バグの例、および関連する質問については、フォーラム までご連絡ください。 現在、当社はこのドキュメントで説明されている標準フローに対してのみサポートしています。他の一般的なプッシュ サービスやプラグインでさらなる機能が必要な場合はお知らせください! 開発者コミュニティからのフィードバックをいただくのが大好きです。 Amazon SNS 経由のプッシュ ペイロードに関するドキュメント:
最終更新日 2026年8月13日