Creating an account #
Creating an account for Comprehension Game is possible at https://api.comprehensiongame.com/api/register/. If you can’t find your email confirmation message after creating an account make sure to check your spam folder. If you don’t receive the email confirmation message within 24 hours please contact technical support (see bottom of page for contact details).
- Install Comprehension Game from the Google Play store (https://play.google.com/store/apps/details?id=com.tokapeli).
- Launch the application and sign in to the game using your Comprehension Game account.
- Select your name from the revealed list.
- You can select the learning package you want to play in the learning packages list.
- Install TestFlight
- Join the external testing group by tapping this. The link will add your AppleID (email you use to log in to Apple devices and services) to the tester group that enables Beta-testing via Apple’s TestFlight application. If you open a link without TestFlight on your device it will open a website with more information about testing.
- Open TestFlight from the application library if it didn’t open by the link.
- Press “Install”
- Follow the last steps under the Android section starting from the 2nd point.
The web version can be played on any modern browser, such as Chrome, Edge or Firefox, at https://api.comprehensiongame.com/play/.
Comprehension Game Creator #
Comprehension Game Creator is available at https://api.comprehensiongame/creator/. The same user account as in Comprehension Game is used in Creator.
Gaining permission to create learning packages #
Creating learning packages isn’t permitted by default. To gain permission to create learning packages you need a registration code. Contact us (see contact details at the bottom of the page) if you are interested in creating learning packages but don’t have a registration code.
- Navigate to https://api.comprehensiongame.com/api/activate-code/.
- Enter your registration code to the field reserved for it and press the “Submit” button
Creating a learning package #
- You can start creating a new learning package on Creator’s “Learning packages” page by pressing the “Add new” button. If you don’t see the button you don’t have the required permission to create learning packages.
- Please note while creating a learning package:
- For now claims should be written independently of each other, i.e. one shouldn’t have to read one claim to understand another. This is required because the order of claims is randomized in the game on repeat attempts. Randomization aims to prevent associating the truth value of a specific claim with the order of claims.
- Required fields are marked with an asterisk (*).
- Some fields show a tooltip with a more detailed description of the field if you hover your mouse over them.
- Claims are grouped according to their section value. In game the player has to correctly determine the truth value of each claim in the first section before moving to the second section and so on.
- The learning package can be saved by pressing the “Save” button.
Editing a learning package #
A learning package can be edited by choosing it in the learning packages list, making changes to it and then saving it. The edit view’s dropdown menu, which is accessible by pressing the down-arrow next to the “Cancel”-button, has the following actions available:
- Save a copy: Saves a copy of the learning package and switches to it. User permissions aren’t copied.
- Replace package: Replaces all the content (across all translations) of the learning package with the content of another learning package.
- Replace translation: Replaces the current translation with a translation from another learning package.
- Import translation: Adds a translation from another learning package to the current learning package. A learning package can’t have multiple translations of the same language, so if e.g. a learning package already has a translation for English another English translation can’t be imported to it.
Multiple claims can be selected by pressing the circle at the upper left corner of each claim. When multiple claims are chosen the following actions become available in the aforementioned dropdown menu:
- Copy selected to new: Copies the selected claims to a new learning package and switches the edit view to it.
- Copy selected to…: Copies the selected claims to the chosen learning package and switches the edit view to it.
If you want to save changes to a learning package so that they don’t yet become available to the users of the learning package do the following:
- Save a copy of the learning package.
- Do your changes in the copy.
- When you are ready to publish the changes open the original learning package and choose “Replace package”, “Replace translation” or “Import translation” depending on your needs.
- Save the original learning package. After saving you may delete the copy if you have no further need for it.
Learning package settings #
The learning package’s settings can be opened by pressing the cog icon in the edit view.
- Prune condition: Defines after how many consecutive correct answers for a specific claim the claim isn’t displayed anymore during reattempts. Value 0 means that the claim is never removed from the rotation. Some removed claims are randomly returned to the rotation, so even if the prune condition is filled the claim may show up again. If an incorrect answer is given to a claim that was removed from the rotation it will be returned to the rotation.
- Easy-mode condition: Defines after how many consecutive incorrect answers the player will be displayed X, or as many as there is available, claims that the player has already given an correct answer for. The “Easy-mode length” setting defines X. A value of 0 will disable this feature.
- Easy-mode length: See “Easy-mode condition” above.
- Explanation condition for incorrect: Defines how many times an incorrect answer has to be given for a specific claim before it’s explanation will be displayed. A value 0 means that the explanation is never displayed.
- Explanation condition for correct: Defines how many times a correct answer has to be given for a specific claim before it’s explanation will be displayed. A value 0 means that the explanation is never displayed.
- Give immediate feedback: Defines if the player will be given immediate feedback, i.e. will the player be told after each answer if the answer was correct or not.
Printing a learning package #
A learning package can be printed by downloading it in a text format and using a fitting program for printing the text.
- Choose from edit view’s dropdown menu “Export as” -> “Text”.
- Open the downloaded text file in a program, such as Word or Notepad, that allows you to print it.
Sharing learning packages #
Other users can be given permission to view (play), edit and/or share a learning package. By default a new learning package is only visible to it’s creator.
Learning package specific share #
In a learning package’s edit view, in the permissions section, other users may be given permissions for the learning package. The receivers have to confirm the permissions they are given by following a link sent to their email.
- Press the add “Add user” button in the permissions section.
- Enter the username or email of user you want give permissions to to the text field that was created. (NOTE: You have to enter a username or an email of an existing user.)
- Choose which permissions to give to the user.
- Press the “Save” button.
Sharing learning packages with groups #
The groups functionality makes it easier to share multiple packages to multiple users. Groups can be edited in Creator’s “Groups” section, which is accessible through the menu on the left side of the page. Any users invited to a group have to confirm the invite by following a link sent to their email.
- Add a new group by pressing the “Add new” button or edit an existing one.
- Add a user to the group by pressing the “Add member” button.
- Enter the user’s username or email to the created input.
- Add a permission by pressing the “Add permission” button.
- Choose the learning package, which permissions you want to share, using the created select menu.
- Choose the permissions to share for the learning package.
- Press the group’s “Save” button.
A persistent share link, which anybody can use to join the group as a member, may be created for the group by pressing the “Share” button. Group managers can edit the group, i.e. add and remove members, managers and permissions. Adding managers works like adding members.
On Creator’s “Statistics” page you may inspect your own and others’ game data in a visualized format. Start by choosing a learning package, which data you want to inspect. By default the data of all users, whose data you have permission to view, is displayed. By using the filters you can view the data of e.g. only one user.
The data can be downloaded in a CSV format, which allows it to be viewed e.g. in a spreadsheet program. The download provides the filtered portion of the data.
You may instruct your students to play a certain package e.g. verbally and later check through the “Statistics” page have they actually played the game. For this to be possible do the following:
- Choose an existing or create a new learning package.
- Share the chosen learning package to your students using the groups functionality. Using groups to share the learning package automatically also enables you to view your students play data.
Sharing play data #
Other users won’t be able to view your play data unless you permit them.
Play data sharing with groups #
A groups owner and managers are permitted to view all the play data of the group’s members for those packages that they themselves are permitted to play.