Unity を使用して Firebase Cloud Messaging クライアントアプリを設定する

クロスプラットフォーム対応の Firebase Cloud Messaging クライアントアプリを Unity で記述するには、Firebase Cloud Messaging API を使用します。Android と iOS それぞれに必要な設定を追加すれば、両方のプラットフォームで Unity SDK を動作させることができます。

始める前に

前提条件

Unity 5.3 以降をインストールします。
（iOS のみ）以下をインストールします。
- Xcode 9.4.1 以降
- CocoaPods 1.4.0 以降
Unity プロジェクトが次の要件を満たしていることを確認します。
- iOS の場合 - ターゲットが iOS 8 以降であること
- Android の場合 - ターゲットが API レベル 16 （Jelly Bean）以降であること
Unity プロジェクトを実行するためのデバイスまたはエミュレータを設定します。
- iOS の場合 - アプリを実行するための物理 iOS デバイスまたは iOS シミュレータを設定します。
  - Cloud Messaging の場合は、次の作業を行います。
    - 物理 iOS デバイスを設定します。
    - Apple Developer アカウントの Apple Push Notification Authentication Key を取得します。
    - プッシュ通知を XCode の [App] > [Capabilities] で有効にします。
  - 他のすべての Firebase プロダクトで、物理 iOS デバイスと iOS シミュレータのいずれかを使用できます。
- Android の場合 - エミュレータでは Google Play のエミュレータイメージを使用する必要があります。
Google アカウントを使用して Firebase にログインします。

Unity プロジェクトがまだない方で Firebase プロダクトを試してみたい場合は、クイックスタートサンプルをダウンロードしてください。

ステップ 1: Firebase プロジェクトを作成する

Unity プロジェクトに Firebase を追加する前に、Unity プロジェクトに接続するための Firebase プロジェクトを作成する必要があります。Firebase プロジェクトの詳細については、Firebase プロジェクトについて理解するをご覧ください。

Firebase プロジェクトを作成

Firebase コンソールで [プロジェクトを追加] をクリックし、プロジェクト名を選択するか、または入力します。

既存の Google Cloud Platform（GCP）プロジェクトがある場合は、プルダウンメニューからプロジェクトを選択して、そのプロジェクトに Firebase リソースを追加できます。
（省略可）新しいプロジェクトを作成した場合は、プロジェクト ID を編集できます。

Firebase プロジェクトには一意の ID が自動的に割り当てられます。Firebase がプロジェクト ID を使用する仕組みについては、Firebase プロジェクトについて理解するをご覧ください。

Firebase プロジェクトのリソースがプロビジョニングされた後にプロジェクト ID を変更することはできません。
特定の識別子を使用するには、この設定手順でプロジェクト ID を編集する必要があります。
[続行] をクリックします。

（省略可）プロジェクトの Google アナリティクスを設定します。これにより、次の Firebase プロダクトを使用して最適なエクスペリエンスを実現できます。

アカウントの選択を求められたら、既存の Google アナリティクスアカウントを使用するか、新しいアカウントを作成します。
新しいアカウントを作成する場合は、アナリティクスレポートのロケーションを選択し、プロジェクトのデータ共有設定と Google アナリティクスの規約に同意します。

[プロジェクトを作成]（既存の GCP プロジェクトを使用する場合は [Firebase を追加]）をクリックします。

Firebase プロジェクトのリソースが自動的にプロビジョニングされます。処理が完了すると、Firebase コンソールに Firebase プロジェクトの概要ページが表示されます。

ステップ 2: Unity プロジェクトを Firebase プロジェクトに登録する

Firebase プロジェクトに接続するアプリやゲームを登録できます。

Firebase コンソールの [Project Overview] ページの中央にある Unity アイコンをクリックして設定ワークフローを起動します。

すでに Firebase プロジェクトにアプリを追加している場合は、[アプリを追加] をクリックするとプラットフォームのオプションが表示されます。
Unity プロジェクトのどのビルドターゲットを登録するかを選択します。両方のターゲットを登録することもできます。

注: iOS と Android の両方のビルドターゲットを同時に登録できるようになりました。また必要に応じて、Unity プロジェクトの一方のビルドターゲットを先に登録してから、後でこの設定ワークフローに戻ってもう一方のビルドターゲットを登録することもできます。
Unity プロジェクトのプラットフォーム固有の ID を入力します。
1. Unity プロジェクトを Unity IDE で開きます。
2. [Build Settings] > [iOS] または[Android] > [Player Settings] > [Other Settings] に移動します。
  
  Unity プロジェクトの ID はバンドル ID の値です。（ID の例: com.yourcompany.unity-project-name）
3. プラットフォーム固有の ID をそれぞれ該当する項目に入力します。
  - iOS の場合 - Unity プロジェクトの iOS ID を [iOS バンドル ID] に入力します。
  - Android の場合 - Unity プロジェクトの Android ID を [Android パッケージ名] に入力します。
    - 「パッケージ名」と「アプリケーション ID」は、しばしば同じ意味で使用されます。
（省略可）Unity プロジェクトのプラットフォーム固有のニックネームを入力します。

これらのニックネームは内部用の簡便な ID であり、Firebase コンソールにのみ表示されます。
[アプリの登録] をクリックします。

ステップ 3: Unity プロジェクトに Firebase 構成ファイルを追加する

Firebase コンソールの設定ワークフローでプラットフォーム固有の Firebase 構成ファイルを取得します。

Unity プロジェクトで iOS と Android の両方のビルドターゲットを登録する場合は、両方のプラットフォームの構成ファイルをダウンロードして追加する必要があります。
- iOS の場合 - [GoogleService-Info.plist をダウンロード] をクリックします。
  - Firebase iOS 構成ファイルはいつでも再ダウンロードできます。
- Android の場合 - [google-services.json をダウンロード] をクリックします。
  - Firebase Android 構成ファイルはいつでも再ダウンロードできます。
  注: Firebase 構成ファイルには、プロジェクト用の機密ではない一意の識別子が含まれています。
  構成ファイルの詳細については、Firebase プロジェクトについて理解するをご覧ください。
Unity プロジェクトで [Project] ウィンドウを開き、構成ファイルを Assets フォルダに移動します。
- 構成ファイルを移動する前に、構成ファイルに (2) のような文字が追加されていないことを確認してください。
- Firebase 構成ファイルは Assets フォルダ内の任意の場所に置くことができます。
Firebase コンソールの設定ワークフローに戻り、[次へ] をクリックします。

ステップ 4: Unity プロジェクトに Firebase SDK を追加する

Firebase コンソールで [Firebase Unity SDK をダウンロード] をクリックし、適切な場所で SDK を解凍します。
- Firebase Unity SDK はいつでも再ダウンロードできます。
- Firebase Unity SDK はプラットフォーム固有ではありません。
開いている Unity プロジェクトで、[Assets] > [Import Package] > [Custom Package] を選択します。
解凍した SDK から、アプリで使用するサポートされている Firebase プロダクトを選択します。

Firebase Cloud Messaging のエクスペリエンスを最適化するために、プロジェクトで Google アナリティクスを有効にすることをおすすめします。Google アナリティクスを設定する際に、Google アナリティクス用の Firebase パッケージをアプリに追加する必要があります。
アナリティクスが有効な場合
- Google アナリティクス用の Firebase パッケージを追加: FirebaseAnalytics.unitypackage
- Firebase Cloud Messaging 用のパッケージを追加: FirebaseMessaging.unitypackage
アナリティクスが無効な場合
Firebase Cloud Messaging 用のパッケージを追加: FirebaseMessaging.unitypackage
Unity 5.x 以前 では .NET 3.x フレームワークを使用しているため、dotnet3/ パッケージをインポートします。

Unity 2017.x 以降では、.NET 4.x フレームワークを使用できます。Unity プロジェクトで .NET 4.x を使用している場合は、dotnet4/ パッケージをインポートします。
[Import Unity Package] ウィンドウで [Import] をクリックします。
Firebase コンソールの設定ワークフローに戻り、[次へ] をクリックします。

ステップ 5: Google Play 開発者サービスの要件を確認する

Android 向け Firebase Unity SDK を使用するには、最新の Google Play 開発者サービスが必要です。

アプリケーションの先頭に次のコードを追加します。SDK で他のメソッドを呼び出す前に Google Play 開発者サービスを確認し、必要であれば、Firebase Unity SDK で必要とされるバージョンに更新します。

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(task => {
  var dependencyStatus = task.Result;
  if (dependencyStatus == Firebase.DependencyStatus.Available) {
    // Create and hold a reference to your FirebaseApp,
    // where app is a Firebase.FirebaseApp property of your application class.
    //   app = Firebase.FirebaseApp.DefaultInstance;

    // Set a flag here to indicate whether Firebase is ready to use by your app.
  } else {
    UnityEngine.Debug.LogError(System.String.Format(
      "Could not resolve all Firebase dependencies: {0}", dependencyStatus));
    // Firebase Unity SDK is not safe to use here.
  }
});

Unity プロジェクトは Firebase を使用するように登録、構成されました。

ステップ 7: ユーザー通知フレームワークを追加する

Xcode でプロジェクトをクリックし、編集領域で [全般] タブを選択します。
[Linked Frameworks and Libraries] が表示されるまで下にスクロールし、[+] ボタンをクリックしてフレームワークを追加します。
表示されたウィンドウで UserNotifications.framework までスクロールし、そのエントリをクリックしてから [追加] をクリックします。

ステップ 8: プッシュ通知を有効にする

Xcode でプロジェクトをクリックし、編集領域で [Capabilities] タブを選択します。
[Push Notifications] を [On] に切り替えます。
[Background Modes] までスクロールして、[On] に切り替えます。
[Background Modes] の下の [Remote notifications] チェックボックスをオンにします。

Firebase Cloud Messaging を初期化する

Firebase Cloud Message ライブラリは、TokenReceived または MessageReceived イベントのハンドラが追加されるときに初期化されます。

初期化時に、クライアントアプリインスタンス用の登録トークンが要求されます。アプリは OnTokenReceived イベントでトークンを受け取ります。後で使用するためにこれをキャッシュに保存しておく必要があります。このトークンは、この特定のデバイスをメッセージの対象にする場合に必要になります。

さらに、受信メッセージを受信できるようにするには OnMessageReceived イベントに登録する必要があります。

セットアップ全体は次のようになります。

public void Start() {
  Firebase.Messaging.FirebaseMessaging.TokenReceived += OnTokenReceived;
  Firebase.Messaging.FirebaseMessaging.MessageReceived += OnMessageReceived;
}

public void OnTokenReceived(object sender, Firebase.Messaging.TokenReceivedEventArgs token) {
  UnityEngine.Debug.Log("Received Registration Token: " + token.Token);
}

public void OnMessageReceived(object sender, Firebase.Messaging.MessageReceivedEventArgs e) {
  UnityEngine.Debug.Log("Received a new message from: " + e.Message.From);
}

Android エントリポイントアクティビティを構成する

Android では、デフォルトの UnityPlayerActivity に代わるカスタムエントリポイントアクティビティが Firebase Cloud Messaging にバンドルされています。カスタムエントリポイントを使用していない場合、この置換は自動的に行われ、追加の操作を行う必要はありません。デフォルトのエントリポイントアクティビティを使用しないアプリや、独自の Assets/Plugins/AndroidManifest.xml を提供するアプリは、追加の構成が必要になります。

Android 上の Firebase Cloud Messaging Unity プラグインには、次の 2 つの追加のファイルがバンドルされています。

Assets/Plugins/Android/libmessaging_unity_player_activity.jar には、標準の UnityPlayerActivity を置き換える MessagingUnityPlayerActivity という名前のアクティビティが含まれています。
Assets/Plugins/Android/AndroidManifest.xml は、MessagingUnityPlayerActivity をアプリへのエントリポイントとして使用するようアプリに指示します。

これらのファイルは、デフォルトの UnityPlayerActivity により onStop、onRestart のアクティビティのライフサイクルの遷移が処理されていないか、または Firebase Cloud Messaging で受信メッセージを正しく処理するために必要な onNewIntent が実装されていない場合に提供されます。

カスタムエントリポイントアクティビティを構成する

アプリでデフォルトの UnityPlayerActivity を使用しない場合は、提供されている AndroidManifest.xml を削除して、カスタムアクティビティが Android のアクティビティのライフサイクルのすべての遷移を正しく処理できるようにする必要があります（方法については、以下の例をご覧ください）。カスタムアクティビティが UnityPlayerActivity を拡張する場合は、代わりに、必要なすべてのメソッドを実装する com.google.firebase.MessagingUnityPlayerActivity を拡張できます。

カスタムアクティビティを使用していて com.google.firebase.MessagingUnityPlayerActivity を拡張していない場合は、次のスニペットをアクティビティに入れる必要があります。

/**
 * Workaround for when a message is sent containing both a Data and Notification payload.
 *
 * When the app is in the background, if a message with both a data and notification payload is
 * received the data payload is stored on the Intent passed to onNewIntent. By default, that
 * intent does not get set as the Intent that started the app, so when the app comes back online
 * it doesn't see a new FCM message to respond to. As a workaround, we override onNewIntent so
 * that it sends the intent to the MessageForwardingService which forwards the message to the
 * FirebaseMessagingService which in turn sends the message to the application.
 */
@Override
protected void onNewIntent(Intent intent) {
  Intent message = new Intent(this, MessageForwardingService.class);
  message.setAction(MessageForwardingService.ACTION_REMOTE_INTENT);
  message.putExtras(intent);
  message.setData(intent.getData());
  startService(message);
}

/**
 * Dispose of the mUnityPlayer when restarting the app.
 *
 * This ensures that when the app starts up again it does not start with stale data.
 */
@Override
protected void onCreate(Bundle savedInstanceState) {
  if (mUnityPlayer != null) {
    mUnityPlayer.quit();
    mUnityPlayer = null;
  }
  super.onCreate(savedInstanceState);
}

Android でのメッセージ配信に関する注意点

アプリがまったく実行されていないときにユーザーが通知をタップすると、デフォルトでは、メッセージが FCM の組み込みコールバックでルーティングされません。この場合、メッセージペイロードは、アプリの起動に使用される Intent を通じて受信されます。

アプリがバックグラウンドで動作しているときに受信したメッセージでは、通知項目の内容がシステムトレイ通知の入力に使用されますが、その通知内容は FCM に通知されません。つまり、FirebaseMessage.Notification が null になります。

要約:

アプリの状態	通知	データ	両方
フォアグラウンド	`Firebase.Messaging.FirebaseMessaging.MessageReceived`	`Firebase.Messaging.FirebaseMessaging.MessageReceived`	`Firebase.Messaging.FirebaseMessaging.MessageReceived`
バックグラウンド	システムトレイ	`Firebase.Messaging.FirebaseMessaging.MessageReceived`	通知: システムトレイデータ: インテントの追加部分内

自動初期化を禁止する

FCM では FCM 内で登録トークンとして使用されるインスタンス ID が生成されます。インスタンス ID が生成されると、ライブラリによりその ID と構成データが Firebase にアップロードされます。インスタンス ID を使用する前に明示的にオプトインする場合は、構成時に FCM（Android ではアナリティクス）を無効にして生成を禁止できます。この操作を iOS で行うには、メタデータ値を Info.plist に追加します（GoogleService-Info.plist ではありません）。Android で行う場合は、メタデータ値を AndroidManifest.xml に追加します。

Android

<?xml version="1.0" encoding="utf-8"?>
<application>
  <meta-data android:name="firebase_messaging_auto_init_enabled"
             android:value="false" />
  <meta-data android:name="firebase_analytics_collection_enabled"
             android:value="false" />
</application>

iOS

FirebaseMessagingAutoInitEnabled = NO

FCM をもう一度有効にするには、ランタイムコールを実行します。

Firebase.Messaging.FirebaseMessaging.TokenRegistrationOnInitEnabled = true;

この値をいったん設定すると、アプリを再起動しても維持されます。

Android でディープリンクを含むメッセージを処理する

FCM では、ディープリンクを含むメッセージをアプリに送信できます。ディープリンクを含むメッセージを受信するには、アプリのディープリンクを処理するアクティビティに新しいインテントフィルタを追加する必要があります。インテントフィルタは、ドメインのディープリンクをキャッチする必要があります。メッセージにディープリンクが含まれていない場合は、この構成を行う必要ありません。AndroidManifest.xml では次のように追加します。

<intent-filter>
  <action android:name="android.intent.action.VIEW"/>
  <category android:name="android.intent.category.DEFAULT"/>
  <category android:name="android.intent.category.BROWSABLE"/>
  <data android:host="CHANGE_THIS_DOMAIN.example.com" android:scheme="http"/>
  <data android:host="CHANGE_THIS_DOMAIN.example.com" android:scheme="https"/>
</intent-filter>

ワイルドカードを指定すると、インテントフィルタをより柔軟に設定できます。次に例を示します。

<intent-filter>
  <action android:name="android.intent.action.VIEW"/>
  <category android:name="android.intent.category.DEFAULT"/>
  <category android:name="android.intent.category.BROWSABLE"/>
  <data android:host="*.example.com" android:scheme="http"/>
  <data android:host="*.example.com" android:scheme="https"/>
</intent-filter>

指定したスキームとホストへのリンクを含む通知がタップされると、アプリがこのインテントフィルタを含むアクティビティを開始し、リンクを処理します。

次のステップ

クライアントアプリを設定したら、Firebase でダウンストリームメッセージやトピックメッセージを送信できる状態になります。詳細については、この機能のクイックスタートサンプルをご覧ください。

その他のより高度な動作をアプリに追加するには、アプリサーバーからのメッセージ送信に関する次のガイドをご覧ください。

これらの機能を利用するには、サーバーの実装が必要です。