Skip to content

Host | Mobile Flow and States

Jump to bottom
sincwu edited this page Sep 21, 2022 · 7 revisions

StateFlow The above diagram outlines the proposed backend state names and additions as of 2022-09-19. Further discussion to follow; use with caution.

Available in PDF here: StateFlow.pdf

Basic Mode Game Session States:

  • NOT_STARTED: Teacher has chosen a game to play (from Central)

  • TEAMS_JOINING: Start Game page, students joining. (Note: Basic Mode “teams” can be individual students using their own devices OR teams of students where each team shares one device. Advanced Mode “teams” can play with 1 device per team or multiple devices per team.)

  • PHASE_1_LIVE: The question is now live: students can start answering the question (guessing the correct answer in Phase 1), and teachers see real-time results.

  • PHASE_1_DISCUSS: Move to this state when 1) the timer has ended, 2) all students have answered and the teacher presses "End Answering", or 3) not all students have yet answered and the teacher presses "End Answering". Teachers can optionally discuss the correct answer here (some teachers might prefer to leave discussion of both the correct answer and incorrect answers until after Phase 2).

  • PHASE_1_SCORE: Phase 1 results

  • PHASE_2_START: Transition screen between Phase 1 and 2

  • PHASE_2_LIVE: In Phase 2, students try to choose the most popular wrong answer, and teachers see real-time results.

  • PHASE_2_DISCUSS: Move to this state when 1) the timer has ended, 2) all students have answered and the teacher presses "End Answering", or 3) not all students have yet answered and the teacher presses "End Answering". Teachers can spend time on this screen to discuss both the correct and incorrect answers.

  • PHASE_2_SCORE: Phase 2 results

  • FINAL_RESULTS: Students see 2 screens in this state: 1) their individual performance, 2) class leaderboard. Teachers see a Final Results screen similar to the class leaderboard.

  • FINISHED: Game Finished (to be removed?)

Old Notes

Launch Game from Central - creates a game session

  • Game State = NOT_STARTED - when teacher has chosen a game

Route to Start Game Page

  • Update Game State = TEAMS_JOINING

When Start Game is clicked - Route to game in progress page

  • Update game state = CHOOSE_CORRECT_ANSWER (phase 1 of 2 - students guessing correct answer)

If the timer runs out and/or teacher clicks “Go to Results”

  • Update Game state = PHASE_1_RESULTS

When "Go to next phase" is clicked

  • Game state = CHOOSE_TRICKIEST_ANSWER (Phase 2 guessing most popular wrong answer)

If the timer runs out and/or teacher clicks “Got to Results”

  • Update Game state = PHASE_2_RESULTS:

*Wash, rinse, repeat until all questions in the game have been played

When game is over - Route to Final Results page

  • Game state = FINAL_RESULTS
Clone this wiki locally