Katsuyo Quest — パラメータ設定マニュアル

概要

このマニュアルは、https://katsuyoquest.netlify.app/ に渡すクエリパラメータの設定方法を説明します。教師がクリア結果をGoogleフォームへ自動で入力したい場合に、URL に適切なパラメータを加えて生徒に伝えます。クエリパラメータを加えない場合は、教師に報告するボタンは出ませんが、自由に学ぶことができます。

サポートするクエリパラメータ

• f: Google Form のフォームID（必須ではない）
  • 例: f=1FAIpQLSe... （フォームの /forms/d/e/<フォームID>/viewform の <フォームID> 部分）
  • 指定しない場合、報告ボタンは無効化されます。
• m: "種別" を書き込むフォームの entry id（省略可）
  • 例: m=1234567890
• t: "クリア時間" を書き込むフォームの entry id（省略可）
  • 例: t=2345678901
• h: "残りHP" を書き込むフォームの entry id（省略可）
  • 例: h=3456789012

使い方（手順）

1. Googleフォームの準備

1. Google フォームを作成し、送信先の入力欄（種別・クリア時間・残りHP）を用意します。
2. 各入力欄の「entry id」は Google フォームの「事前入力リンク」を使うと簡単に確認できます。具体的な手順は次の通りです：

1. Google フォームの編集画面を開きます。
2. 右上の︙メニュー（縦の三点）をクリックし、メニューから「フォームに事前入力する）」を選択します。
3. 表示されたフォームのプレビューで、各フィールド（例：「種別」「クリア時間」「残りHP」）に適当なダミー値（例: mode, 123, 5）を入力し、下部の「リンクを取得」ボタンをクリックします。
4. 表示された URL をコピーして、テキストエディタ等に貼り付けます。
5. 貼り付けた URL の中に entry. で始まるパラメータが含まれています（例: entry.1111111111=mode）。その entry.<数字> の数字部分が、そのフィールドの entry id です。
6. ダミー値を使っているので、実際に送信される値はゲーム側で作成される値に置き換えることができます（m, t, h に対応）。

https://docs.google.com/forms/d/e/1FAIpQLSeXAMPLE/viewform?usp=pp_url&entry.1111111111=mode&entry.2222222222=123&entry.3333333333=5

  この場合、種別の entry id は 1111111111、時間の entry id は 2222222222、HP の entry id は 3333333333 です。

2. f の確認

フォームの編集画面の URL が次のような形式であれば、フォームID（/d/e/ のあとに続く長い英数字）を確認して f に設定します。

https://docs.google.com/forms/d/e/1FAIpQLSe.../viewform

3. ゲームにパラメータを渡す URL の作成

基本 URL: https://katsuyoquest.netlify.app/

https://katsuyoquest.netlify.app/?f=<FORM_ID>

すべて指定する例:

https://katsuyoquest.netlify.app/?f=<FORM_ID>&m=<ENTRY_ID_FOR_MODE>&t=<ENTRY_ID_FOR_TIME>&h=<ENTRY_ID_FOR_HP>

4. 動作確認

• ブラウザで作成した URL を開き、ゲームをプレイして最後までクリアします。
• クリア後、画面下の「報告」ボタンが有効であれば、クリックで Google フォームが新しいタブで開きます。
• f を指定していない場合、報告ボタンはでません、メッセージで頑張りを認めます。

注意とトラブルシューティング

• 報告ボタンが無効な場合
  • f パラメータが空または無指定です。URL を確認して ?f=<FORM_ID> を追加してください。
• フォームに値が入らない場合
  • m, t, h の entry id が間違っている可能性があります。Google フォームの送信 URL を生成して entry の数字を再確認してください。
• ブラウザのポップアップブロック
  • 報告ボタンは新しいタブでフォームを開きます。ポップアップブロッカーが働くと開けない場合があるため、必要に応じて許可してください。

生徒に教えるURLのサンプル

- フォームID が 1FAIpQLSeXAMPLE、entry id が 1111111111（種別）、2222222222（時間）、3333333333（HP）の場合:
  https://katsuyoquest.netlify.app/?f=1FAIpQLSeXAMPLE&m=1111111111&t=2222222222&h=3333333333