> ## Documentation Index
> Fetch the complete documentation index at: https://docs.learningwith.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# クイズ機能

> AIクイズ生成と回答の詳細

## クイズの始め方

ルーム詳細画面から「クイズを始める」をクリックし、以下を設定します:

| 設定項目    | 説明            | 例           |
| ------- | ------------- | ----------- |
| 教科      | 学習したい教科       | 英語、数学、理科、社会 |
| 科目      | 教科内の科目（教科による） | 英文法、微分積分、力学 |
| 範囲・トピック | 具体的な出題範囲      | 関係代名詞、二次関数  |
| 問題数     | 出題数（3〜10問）    | 5問          |
| 難易度     | 中学〜大学院の5段階    | 高校          |

<Info>
  トピックは具体的に指定するほど、的確な問題が生成されます。
  例: 「英文法」より「仮定法過去完了」の方がピンポイントな問題になります。
</Info>

### 詳細オプション

「詳細オプション」を開くと、追加の設定が可能です:

* **カスタム指示**: AIへの追加指示（例:「計算過程も問う問題にして」）
* **時間の柔軟性**: 回答制限時間の調整（きっちり / ゆったり / のんびり / 制限なし）

## 問題形式

AIが生成する問題は4択形式です:

```
次の英文の空欄に入る適切な語を選びなさい。

"If I ___ known, I would have told you."

A. have
B. had
C. has
D. having
```

### 試験形式テンプレート

英検などの試験に対応したテンプレートが用意されています。対応する教科・科目・トピックを指定すると、その試験形式に合わせた問題が自動的に生成されます。

テンプレートが適用される場合、クイズ開始画面に「テンプレート適用中」と表示されます。

## 問題プール

同じ教科・トピック・難易度で過去に生成された問題がある場合、問題プールから再利用されます。

* 過去の承認済み問題が優先的に使われるため、クイズ生成が高速になります
* プールに十分な問題がない場合は、AIが新しい問題を追加生成します
* 問題の品質は自動レビューで管理されています

## 回答の流れ

<Steps>
  <Step title="選択肢をタップ">
    4つの選択肢から1つを選択
  </Step>

  <Step title="回答を送信">
    「回答する」ボタンをタップ
  </Step>

  <Step title="正誤確認">
    即座に正解/不正解が表示されます
  </Step>

  <Step title="解説を読む">
    AIによる詳細な解説を確認
  </Step>

  <Step title="次の問題へ">
    全問回答するまで繰り返し
  </Step>
</Steps>

### 回答時間の計測

各問題には回答時間が計測されます。制限時間が設定されている場合:

* 画面上部にカウントダウンタイマーが表示されます
* 残り30秒で黄色、残り10秒で赤色の警告表示に変わります
* 残り10秒で警告音が鳴ります
* 制限時間を超えると自動的に時間切れとなります

<Tip>
  クイズ開始時の「時間の柔軟性」設定で、制限時間の倍率を変更できます。「制限なし」を選ぶとタイマーなしで解答できます。
</Tip>

## 対戦モード（Battle Mode）

ルームメンバーとリアルタイムで対戦できます。

### 対戦の始め方

<Steps>
  <Step title="対戦相手を選ぶ">
    ルーム画面でメンバーの横にある対戦ボタンをタップ
  </Step>

  <Step title="対戦条件を設定">
    教科・科目・範囲・問題数・難易度を指定してリクエストを送信
  </Step>

  <Step title="相手が承諾">
    相手に通知が届き、承諾すると対戦が開始されます
  </Step>

  <Step title="同じ問題を解く">
    両者とも同じ問題セットに取り組みます
  </Step>

  <Step title="結果比較">
    正答率と回答時間で勝敗が決まります
  </Step>
</Steps>

<Info>
  対戦リクエストを受け取ると、画面にポップアップ通知が表示されます。「受ける」をタップすると対戦が始まります。
</Info>

## 結果画面

クイズ終了後に表示される情報:

<CardGroup cols={2}>
  <Card title="スコア" icon="percent">
    正答数と正答率（例: 4/5問 80%）
  </Card>

  <Card title="ランキング" icon="ranking-star">
    ルームメンバー内での順位
  </Card>

  <Card title="問題別結果" icon="list-check">
    各問題の正誤と解説
  </Card>

  <Card title="学習アドバイス" icon="lightbulb">
    弱点に基づくアドバイス
  </Card>
</CardGroup>

### リアクション

結果画面では、他のメンバーの結果にリアクション（スタンプ）を送れます:

| リアクション   | 意味        |
| -------- | --------- |
| すごい!     | 好成績を称える   |
| 惜しい!     | あと少しだった時に |
| 次は勝つ!    | 次回への意気込み  |
| ナイスファイト! | 健闘を称える    |

リアクションはタップで送信、もう一度タップで取り消しできます。自分が受け取ったリアクションは自分のカードに表示されます。

### 結果をシェア

結果画面の「結果をシェア」ボタンから、以下の方法でシェアできます:

* **X（Twitter）でシェア**: スコアとハッシュタグ付きのポストを作成
* **リンクをコピー**: 結果ページのURLをクリップボードにコピー

シェアされた結果ページはOGP画像付きで表示されるため、SNS上でスコアがプレビューされます。

### コーチに相談

ルームにAIコーチが設定されている場合、結果画面やルームのチャットセクションからコーチに学習相談ができます。

* 間違えた問題について質問する
* 学習方法のアドバイスをもらう
* 次に取り組むべきトピックを相談する

コーチの性格やスタイルはルーム設定から変更できます（プリセットから選択、またはカスタム作成）。

### 問題の報告

問題に誤りがあった場合、「この問題を報告」ボタンから報告できます:

| 報告理由      | 説明              |
| --------- | --------------- |
| 正解が間違っている | 正解とされている選択肢が不正確 |
| 問題文が不明瞭   | 問題の意味が分かりにくい    |
| 解説が間違っている | 解説の内容に誤りがある     |
| 重複した問題    | 同じ問題が複数回出題された   |
| その他       | 上記以外の問題点        |

報告時に詳細な説明を追加することもできます。

## クイックスタート

ダッシュボードの「Quick Start」カードから、ワンクリックで復習を開始できます。

* 過去に間違えた問題を優先的に出題します
* ルームを選択して「開始」をタップするだけで始められます
* 既存の問題がない場合は、AIが新しい問題を自動生成します

<Tip>
  毎日の復習にクイックスタートを活用すると、苦手分野を効率的に克服できます。
</Tip>

## 解説の見方

各問題の解説には以下が含まれます:

* **正解**: 正しい選択肢
* **なぜその答えか**: 正解の理由
* **間違いやすいポイント**: よくある誤答パターン
* **関連知識**: さらに学習するためのヒント

## 過去のクイズを見る

ダッシュボードの「回答履歴」から、過去に解いたクイズを確認できます。

* セッションごとの結果
* 科目別の正答率
* 間違えた問題の復習