MCD4290内存训练

Assignment 1 - Memory Training Game
MCD4290, Trimester 1, 2020
Due: Week 5, 23:55
Worth: 12% of final mark
Aim
For this assignment your team will develop a memory skill game based on the
electronic game Simon, produced by Hasbro. You will create a web app that displays
random sequences of colours which the user must repeat from memory. As the user
continually enters correct sequences the game progressively selects longer
sequences.
Background
Simon is a 40-year-old electronic game, currently produced by Hasbro
(https://en.wikipedia.org/wiki...(game)). The game has four coloured buttons
that light up and play a sound in sequence. The user then has to replicate the
sequence by pressing those buttons in the same order. The sequences become
progressively longer and more difficult until the user is unable to repeat the
sequence and the game ends.
While such games are entertaining, the complexity and randomness of the
sequences also allows the game to be used as a means of practicing memory
storage techniques. There is some evidence that individuals with mild cognitive
impairment can benefit from memory enhancement training1
from games such as
Simon.
Your team has been hired by Thoughtress, a small firm that develops memory skill
games for researchers and individuals to evaluate improvement in memory ability.
Normally they develop these games as physical electronic devices, however they
wish to make their services more accessible to those in rural areas. To this end your
team has decided to develop the game as a mobile web app.
Background: Example sequences
Below are some example sequences that might be shown when playing the game:
Background: Game progression
The difficulty level (sequence length) increases after the user gets a certain number
of sequences of that length correct. The number of correct sequences needed to
advance is shown in the table below. (The number is always two less than the
sequence length.)
For example, at the start of the game, the player is given sequences of length 4. The
player receives RRGB followed by GGBY and they get both correct. Since they have
entered two sequences correctly, the game now increases to sequences of length 5.
The player then receives YYGBR (a sequence of length 5) and needs to enter 3 of
further correct sequences to advance to sequences of length 6.
Any time the player makes a mistake, they start again at the previous level (or reset
to level 4 if they make two consecutive errors). The player cannot be given
sequences shorter than 4 (as this is the starting level).
3
Angles obtained from the phone using device orientation
There are some situations where it may be too difficult for the user to interact with
the app using the buttons on the screen (for example while wearing gloves). As
such, we want to allow users to control the app using the phone’s orientation.
When using device orientation there are three angles that you have access to: alpha,
beta and gamma; where beta represents the forwards-backwards tilt of the phone. It
can visualised as below:
Figure 1 side view of phone at different beta angles
As in the figure above, where we are looking at the phone from the side, this means
that when the device is flat on a surface, screen facing up it will have a beta of 0
degrees, tilting the top of the phone down gives a beta of -45 and tilting the top of the
phone up gives a beta of +45
4
As in the figure above, where we are looking at the bottom of the phone, being flat
on a surface gives a gamma of 0 degrees, tilting the phone to the left gives it a
gamma of -45 whereas tilting to the right gives it +45 degrees
You can observe these Beta and Gamma values on the team phone using the
Sensor Test app available on Moodle under “Assignment 1 Resources”.
5
What you are provided with
We have provided a skeleton version of the app, which displays the basic interface
of the app and includes:
● Code that triggers the userChoiceTimeout function in gameLogic.js
⎯ This function is called when the user fails to make a decision after 2
seconds.
● Code to trigger the giveNextSequence function in gameLogic.js
⎯ The giveNextSequence function will be called automatically every time
the user clicks on the play button.
⎯ This function should return a list of strings which can include the
following:
▪ “blue”
▪ “green”
▪ “yellow”
▪ “red”
⎯ For example [“blue”,”blue”,”green”] which would correspond to a
sequence of BlueBlueGreen
● Code to trigger the sequenceHasDisplayed function in gameLogic.js
⎯ This function is called when the sequence that has been returned by
the giveNextSequence function has finished being shown to the user.
⎯ This is an opportunity to display information to the user prior to them
entering a sequence.
● Code to trigger the changeMode function in gameLogic.js
⎯ This function will be called when the user switches input modes
between touch input and tilt input. The initial input method is touch.
⎯ This function has a parameter mode which will contain TOUCH_MODE
or TILT_MODE depending on the mode the user has just switched to.
● The showSuccess and showFailure functions
⎯ These functions can be called by your code to display an image of a
tick or cross based on whether the user has entered a correct or
incorrect sequence.
⎯ The tick or cross will automatically disappear after one second.
● Four coloured buttons arranged in a circle on the screen
6
⎯ These buttons are designed to be clicked (or tapped on) by the user.
⎯ When clicked, each of these buttons will result in a call to the
buttonSelected function in gameLogic.js
⎯ When the buttonSelected function is called, it will be passed one of the
following strings as an argument representing which of the four buttons
was clicked on:
▪ “blue”
▪ “green”
▪ “yellow”
▪ “red”
● A Play button on the app’s title bar which displays the next sequence for the
user to enter and results in each request to your giveNextSequence function.
● A displayToastMessage function which you can call to have a “toast”
message pop up at the bottom of the screen to notify the user of some
information.
Other than this, you don’t need to know anything else about the skeleton to use it.
You need to implement the functionality described below.
The app skeleton can be found in the MCD4290 “Assignment 1” section on Moodle.
The app skeleton is titled Skeleton.zip and contains a file ‘gameLogic.js’ where you
should write your submission.
You don’t need to understand the other files we provide you with as part of the
project skeleton -- they include some concepts we haven’t yet covered.
7
What you need to do
Getting started

1. As a team you should download a copy of the project skeleton and unzip this.
2. The ‘skeleton’ folder contains the code of the web app.
3. You should open the entire skeleton folder in brackets to understand the
   workings of the files for the assignment.
4. You will implement your solution in the ‘gameLogic.js’ file.
5. You should discuss within your team on the breakdown of coding features and
   responsibilities. It is recommended that you practice pair programming.
6. Plan to have steady progress rather than complete the assignment at one go,
   or to do it at the last minute.
   8
   Programming tasks
   The Programming component of this assignment is worth 9% of your unit mark. For
   the programming tasks, we suggest you complete each part together before moving
   onto the next one.
   Feature 1: Generating random sequences
   The first step to displaying sequences on the screen is to generate those sequences.
   This should be done in the giveNextSequence function and returned as an array of
   strings. You should use the random method of the Math package to produce
   random numbers to represent any given option. Note: Your code will need to save
   the generated sequence for checking against the sequence entered by the user.
   Feature 2: Sequence input
   The buttonSelected function will be called every time the user clicks on one of the
   coloured buttons. You should keep track of which buttons the user presses and the
   order they were pressed in.
   Once the full sequence has been entered, you should compare what the user has
   entered against the original sequence. If the sequences match then you should call
   the showSuccess function, otherwise you should call the showFailure function. (Both
   functions are part of the app skeleton.)
   Feature 3: Increasing difficulty level
   You should keep track of how many consecutive sequences the user has entered
   correctly at the current level. When the user gets enough correct in a row (see
   background, game progression), the game should advance to the next level.
   Feature 4: Resetting difficulty level
   If the user enters an incorrect sequence, they should be taken back to the previous
   level. For example, if they provide an incorrect sequence for a sequence of length 6,
   they need to do sequences of length 5 again (3 of them) before they get a sequence
   of length 6 again.
   If the user makes two mistakes in a row, they are reset to the starting sequence
   length of 4.
   This means that you will need to track the level the player is on and the number of
   successful/unsuccessful sequences entered.
   9
   Feature 5: Displaying status and progress
   You should show on the screen (via the label with the id ‘output’) the current
   progress of the user, including:
   ● Number of items remaining to be entered for the current sequence.
   ● Length of the current sequence
   ● Number of correct sequences entered at the current level
   ● Remaining additional correct sequences until they advance to the next level
   You should also display general status such as whether the user is currently
   expected to enter a sequence or watch a sequence.
   This progress information should be updated anytime any of this information
   changes.
   Feature 6: Tilt-based input method
   You should add an alternative control scheme where the user tilts the phone towards
   the button they wish to light up. In order to do this, the app must be able to respond
   to changes in the orientation of the device using the DeviceOrientation event. See
   the Background “Angles obtained from the phone using device orientation” section.
   The app has a button to switch between input modes which results in a call to your
   changeMode function which has a parameter mode which will either be
   TOUCH_MODE or TILT_MODE depending on the mode. You may need to
   remember this value in your code.
   You should modify your app so that it can track the orientation of the phone. When
   the phone is tilted toward the bottom-left of the phone this should be treated as the
   user attempting to select the bottom-left button (i.e., the yellow button). Likewise, for
   the other three buttons.
   There is already code in the main.js file (supplied with the skeleton) which triggers
   the buttons to light up and runs the buttonSelected function (that you’ve already
   implemented). Each of these functions are named for the corresponding buttons they
   light up: selectYellowButton, selectRedButton, selectBlueButton or
   selectGreenButton (also aliased as selectBottomLeftButton,
   selectBottomRightButton, selectTopLeftButton and selectTopRightButton).
   The DeviceOrientation JavaScript event will notify you (via a callback function)
   whenever the device orientation changes, but this might be many times a
   second. For this reason, we don’t want to select a button as a result of every
   10
   orientation change, but rather just store the button that would be selected, and then
   we can actually register this selection after the standard button press timeout occurs
   (i.e., a call to your userChoiceTimeout function). Hence, if the app is in tilt control
   mode when your userChoiceTimeout function is called you should see if the phone is
   tilted and if so then select the appropriate button.
   Feature 7: show tilt while in tilt mode
   While the app is in tilt mode, you should ensure that you display the current tilt of the
   phone visually. This should be done in such a way that it's clear to the user which
   button will end up being selected on userChoiceTimeout.
   Hint: You can either display the current button selected by tilt in 'tilt mode' on the
   output area or use CSS styling to display a selected border around the item. For
   example, if your reference to the button is BLRef then you can do
   BLRef.style.borderStyle="solid". Don't forget to reset it to "none" when you dont need
   it selected!
   11
   Presentation
   This assignment includes a presentation component worth 3% of your unit mark.
   Thoughtress have had their representatives look over the app your team has
   produced and are pleased with the results however despite initially agreeing with
   your team's suggestion of a mobile web, they now ask your team to get the app in
   the Google PlayTM store and Apple AppStoreTM. In other words, they are asking your
   team to completely redesign the app as a native app for Android and iOS devices.
   Your team has little experience with iOS apps however you have worked closely with
   another organisation (IntellAppt) in the past
   with extensive experience with both Android and iOS development environments.
   After some negotiation, it is agreed that IntellAppt will handle this redevelopment
   while your team takes more of a support role and a handover presentation is
   organised for three weeks’ time.
   In your Week 6 prac class your team will deliver a handover presentation. Your team
   should present an overview of the functionality, design of the app and any specific
   hardware requirements. You should warn the new team about any current issues in
   your app as well as provide any suggestions for improvements. You should not
   present about the code of the app, as IntellAppt is not using Javascript in their
   redevelopment. As with any good presentation, it should be prepared well in
   advance of the due date (including any visual aids) and it should be well rehearsed
   as a group and individually.
   Format
   Each student team will deliver a 10-minute oral presentation (in prac class)
   describing and demonstrating the functionality of their app and detailing any
   limitations of the application. Every member of the team should present for 2-3
   minutes.
   ● The target audience for this presentation is another team who will be
   extending the project further.
   ● This presentation would be delivered in a formal business setting and so all
   team members should be dressed appropriately.
   ● This presentation must discuss the structure and functionality of the
   application as well as any design decisions made.
   12
   Testing the app
7. Connect your Android phone with your laptop, using USB cable.
8. To save your assignment folder on your mobile device select “Transfer files
   (MTP) option" under "Use USB for".
9. A folder will open in your laptop displaying all the storage folders in the phone.
10. On your phones, Open Google Chrome, and type file:///sdcard/ in the address
    bar.
11. Then select your folder and click on the index.html file.
12. Note that if are using MacBook, you have to download and install the Android
    File Transfer to enable file transfer from laptop to the phone.
    Programming resources
    ● Mozilla Developer Network - Math.random documentation
    ● Mozilla Developer Network - Detecting Device Orientation
    13
    Submission
    Your team should submit their final version of the application online via Moodle. You
    must submit the following:
    ● A zip file named based on your team (e.g., \Team014.zip").
    This should contain ONLY one file named gameLogic.js
    This should be a ZIP file and not any other kind of compressed folder
    (e.g. .rar, .7zip, .tar).
    The submission should be uploaded by the team leader and must be finalised by
    Week 5, 23:55. Please note: Your entire team needs to accept the assignment
    submission statement individually on Moodle.
    You also need to individually complete the CATME peer assessment survey as
    described below. You also need to individually complete the following tasks:
    ● CATME peer assessment survey
    ● Assignment code interview
    Your presentation will be given during your practical classes in Week 6.
    14
    Marking criteria
    Programming tasks
    Your assignment will be assessed based on the version of “gameLogic.js” file you
    submit via Moodle. Before submission check your code still works with the original
    app skeleton, in case you have modified your copy of any of the other files. We will
    run it with the original app skeleton and test it on your team smartphone. We will use
    the same phones when marking your assignments.
    Assessment criteria:
    ● Whether the app functionality satisfies the assignment specification
    ● Quality of app source code, including structure and documentation
    You will be marked as a group; however, your individual marks will be subject to
    peer review moderation based on CATME feedback and your assignment interview.
    A detailed marking rubric is available on the unit Moodle page in the “Assignment 1”
    section.
    15
    CATME Peer Assessment
    You are expected to work together as a team on this assignment and contribute
    roughly equal amounts of work. Peer assessment will be conducted via the CATME
    online system. You will receive email reminders at the appropriate time.
    Not completing the CATME peer assessment component may result in a score of
    zero for the assignment.
    Do:
    ● Give your teammates accurate and honest feedback for improvement
    ● Leave a short comment at the end of the survey to justify your rating
    ● If there are issues/problems, raise them with your team early
    ● Contact your demonstrators if the problems cannot be solved amongst
    yourselves
    Do NOT:
    ● Opt out of this process or give each person the same rating
    ● Make an agreement amongst your team to give the same range of mark
    16
    Assignment code interview
    During your week 6 prac class your demonstrator will spend a few minutes
    interviewing each team member to individually gauge the student's personal
    understanding of your Assignment 1 code. The purpose of this is to ensure that each
    member of a team has contributed to the assignment and understands the code
    submitted by the team in their name.
    You will be assigned a score based on your interview, and your code mark will be
    penalised if you are unable to explain your team’s submission:
    Score Description Penalty
    No
    understanding
    The student has not prepared, cannot answer even
    the most basic questions and likely has not even seen
    the code before.
    100%
    Trivial
    understanding
    The student may have seen the code before and can
    answer something partially relevant or correct to a
    question but they clearly can’t engage in a serious
    discussion of the code.
    30%
    Selective
    understanding
    The student gives answers that are partially correct or
    can answer questions about one area correctly but
    another not at all. The student has not prepared
    sufficiently.
    20%
    Good
    understanding
    The student is reasonably well prepared and can
    consistently provide answers that are mostly correct,
    possibly with some prompting. The student may lack
    confidence or speed in answering.
    10%
    Complete
    understanding
    The student has clearly prepared and understands the
    code. They can answer questions correctly and
    concisely with little to no prompting.
    0%
    17
    Presentation
    Students are marked individually for this assignment on their presentation skills
    Assessment criteria:
    ● Voice is of appropriate volume, speed and enthusiasm
    ● Language is appropriate for a formal context and jargon is only used where
    necessary (and explained if used)
    ● Eye contact is consistent and covers most of the audience
    ● Body language complements the presentation
    ● Explanations are clear and visual aids used appropriately
    A detailed marking rubric is available on the unit Moodle page.
    18
    Other information
    Where to get help
    There will be a FAQ are added at the bottom of this document. You can also ask
    questions about the assignment on the General Discussion Forum on the unit's
    Moodle page. This is the preferred venue for assignment clarification-type questions.
    You should check this forum (and the News forum) regularly, as the responses of the
    teaching staff are “official” and can constitute amendments or additions to the
    assignment specification. Before asking for a clarification, please look at the FAQ
    and forum.
    Plagiarism and collusion
    Cheating, Plagiarism and collusion are serious academic offenses at Monash
    University. Students must not share their team's work with any student outside of
    their team. Students should consult the policies linked below for more information.
    https://www.monash.edu/studen...
    https://eng.monash.edu.au/cur...
    See also the video linked on the Moodle page under the Assignment block.
    Students involved in collusion or plagiarism will be subject to disciplinary penalties,
    which can include:
    ● The work not being assessed
    ● A zero grade for the unit
    ● Suspension from the University
    ● Exclusion from the University
    You are required to reference code that has been obtained or provided by other
    sources (i.e. online), including formulas for calculating. This should be done within a
    comment above the code.
    Late submissions
    We do not grant extensions on the assignment unless the majority of a team has
    been affected substantially over the period of the assignment by factors out of your
    control, as outlined in the special consideration form.
    Such special consideration applications should be made to the unit email address
    with a completed form and supporting documentation within two business days of the
    assignment deadline for each affected member.
    http://www.monash.edu/exams/c...
    19
    Without an approved extension, late submissions are not accepted.
    Unavailable team members
    If team members are missing on the day of the presentation, the remaining members
    should proceed without them. Missing team members will receive a mark of zero
    unless they are granted special consideration. Such special consideration
    applications should be made to the unit email address with a completed form and
    supporting documentation within two business days of the presentation date.
    http://www.monash.edu/exams/c...
    You must also inform your team members if you will be absent on the day of the
    presentation.
    20
    Frequently asked questions
13. How do I start this assignment? I'm confused!
    Begin by reading the 'what you are provided with' and 'features' in the
    instructions. The background reading provides some information on how to do
    the different steps themselves.
14. There is something in the instructions I don't understand.
    Read #1, then ask us on the forums or in-person what you don't understand.
    We are happy to assist.
15. Will the assignment app work on an iPhone? Can I use my own Android
    phone?
    No. You're welcome to use your own Android device for testing but there are
    caveats - the device orientation sensor api has to be implemented differently
    depending on the device, platform and browser version you're using.
16. Can we use global variables?
    Yes you can. Remember to declare them using let instead of var. HOWEVER,
    your team should think about the minimum scope required, so don't have
    everything global because you will lose marks. If your variable only needs to
    be accessed by one function, put it in that function instead.
17. How do I debug on the phone?
    Plug in your phone via usb to the PC/Laptop with Google chrome browser
    installed.
    You can go to developer options -> enable usb debugging.
    Then in Chrome, go to F12 (developer tools) -> Sources -> ⋮ -> more
    tools -> Remote devices -> (Accept the debugging notice on your phone) ->
    'inspect' the correct tab open in chrome on the phone. The debugger here
    would basically be the same as the debugger on your regular browser tabs
    while the phone is connected.
18. I need help!
    Come to the regular during-hours help desk sessions, post on the forums for
    help, or ask your friendly teacher
    WX：codehelp