FCM の使用を開始するには、最も単純なユース ケースを作成します。アプリがデバイスのバックグラウンドにあるときに、通知コンポーザーから開発デバイスにテスト通知メッセージを送信します。このページには、セットアップから検証まで、これを実現するためのすべての手順が記載されています。FCM 用の Flutter アプリをセットアップしている場合は、既に完了している手順が含まれている場合があります。
FCM プラグインをインストールする
Flutter プロジェクトのルートから、次のコマンドを実行してプラグインをインストールします。
flutter pub add firebase_messaging
完了したら、Flutter アプリケーションを再構築します。
flutter run
登録トークンにアクセスする
特定のデバイスにメッセージを送信するには、そのデバイスの登録トークンを知る必要があります。このチュートリアルを完了するには、通知コンソールのフィールドにトークンを入力する必要があるため、トークンをコピーするか、トークンを取得した後に安全に保管してください。
アプリ インスタンスの現在の登録トークンを取得するには、 getToken()
を呼び出します。通知許可が付与されていない場合、このメソッドはユーザーに通知許可を求めます。それ以外の場合は、トークンを返すか、エラーのためにフューチャーを拒否します。
final fcmToken = await FirebaseMessaging.instance.getToken();
テスト通知メッセージを送信する
ターゲット デバイスにアプリをインストールして実行します。 Apple デバイスでは、リモート通知を受信する許可の要求を受け入れる必要があります。
アプリがデバイスのバックグラウンドにあることを確認します。
Firebase コンソールで、[メッセージング] ページを開きます。
これが最初のメッセージである場合は、[最初のキャンペーンを作成する]を選択します。
- [ Firebase 通知メッセージ]を選択し、 [作成] を選択します。
それ以外の場合は、[キャンペーン] タブで、[新しいキャンペーン]、[通知] の順に選択します。
メッセージ本文を入力します。他のすべてのフィールドはオプションです。
右側のペインから [テスト メッセージの送信] を選択します。
Add an FCM registration token というフィールドに、このガイドの前のセクションで取得した登録トークンを入力します。
[テスト]を選択します。
[テスト] を選択すると、対象のクライアント デバイス (アプリがバックグラウンドにある) が通知を受け取るはずです。
アプリへのメッセージ配信について詳しくは、 FCM レポート ダッシュボードを参照してください。このダッシュボードには、Apple および Android デバイスで送信および開封されたメッセージの数と、Android アプリの「インプレッション」(ユーザーが表示した通知) のデータが記録されています。
次のステップ
フォアグラウンド アプリにメッセージを送信する
アプリがバックグラウンドにあるときに通知メッセージを正常に送信したら、「 Flutter アプリでメッセージを受信する」を参照して、フォアグラウンド アプリへの送信を開始してください。
通知メッセージを超えて
他のより高度な動作をアプリに追加するには、サーバーの実装が必要です。
次に、アプリ クライアントで次のようにします。