Questions, polls and quizzes
Ask the room, show the answers on the big screen, and write a quiz or a poll as a file you can keep and share.
Questions
Guests send questions from their browser. You see them on your phone and choose which one to show over the slides. Guests can send a question without their name and vote for the questions they want answered; you can sort the list to find the ones that matter, and a guest can send a question that only you see.
Polls
A poll is a question with two to ten options. Choose one answer or many, named or anonymous, with a time limit or without, and whether the room sees live results or only at the end. Results show on the big screen and on guests' phones. Polls live in your library, in folders. The folder with the same name as your presentation can open first. Open the saved results of a poll afterwards and export them as a CSV file.
Open answers
Ask for a written answer. Show the answers as a wall, one by one, or as a word cloud. You can review each answer before it is shown, and allow one answer or many for each guest.
Quizzes
A quiz is a list of questions with correct answers. Guests answer on their phones and the big screen shows the question, the count of answers and, at the end, the winners.
A guest sends a one-answer question by tapping its answer; tapping another answer changes it until time is up. A question with several answers has a Submit button, and the guest's phone warns in the last 5 seconds when a picked answer is not sent yet. The host refuses answers after the lock.
- Points for each question, with partial credit for a question with several correct answers, speed scoring, and a penalty for a wrong answer.
- A read time and a time limit for each question, or one for the whole quiz.
- Options in the order you wrote them, shuffled the same for everyone, or shuffled for each phone.
- A note under each answer, written in simple Markdown (bold, italic, code, lists, links), shown at the reveal on the big screen and on the guests' phones. Questions and answers can hold math.
- A leaderboard always, at the end, or never.
- A review of the answers on the screen or as a download.
While you run a quiz, one main button always says what the room sees next: Show the answer, then Show the leaderboard or Next question, then Finish. After the last question it steps through 3rd place, 2nd place and the winner, then Back to the slides. Skip a question, add 10 seconds, or take back the points of a question that went wrong.
Write a quiz or a poll as a file
The phone has an editor for polls and quizzes. You can also write them in a text editor and import them: a library is one JSON file, saved with the extension .laser. The same file shares polls between phones.
A library holds folders and items. An item is a poll, a quiz or an open answers question. This example has one of each:
{
"format": "laser-pointer-library",
"version": 1,
"folders": ["Talk"],
"items": [
{
"question": "Lunch?",
"options": ["Soup", "Salad"],
"multiple": false,
"named": false,
"folder": "Talk"
},
{
"kind": "quiz",
"question": "Science",
"folder": "Talk",
"questions": [
{
"question": "Which is a star?",
"options": [
{"id": "sun", "text": "Sun", "correct": true, "note": "The **Sun** is our nearest star."},
{"id": "moon", "text": "Moon", "correct": false}
],
"timeLimit": 20
}
],
"settings": {"basePoints": 100, "leaderboard": "always"}
},
{
"kind": "open_answers",
"question": "What should we discuss?",
"display": "cloud",
"folder": "Talk"
}
]
}The rules
- The file is UTF-8 JSON, up to 1 MiB, with at most 200 items and 50 folders.
formatis"laser-pointer-library"andversionis1. A folder name is up to 60 characters. - Polls leave out
kindor use"poll"; quizzes use"quiz"; open answers use"open_answers". - A question or title is 1 to 280 characters, an option up to 100, a note up to 1000. A question or an option may hold up to four line breaks, written
\n. - A poll has 2 to 10 options.
multipleandnamedare required;live(defaulttrue),reveal(defaultfalse) andseconds(0 to 3600, default0) are optional. - A quiz has up to 50 questions, each with 2 to 10 options, and at least one correct option, and exactly one unless
"multiple": true. Each option has anidof 1 to 32 letters, digits, underscores or dashes, unique in its question. - Quiz
settings(all optional):basePoints(1 to 10000, default 100),partialCredit(defaulttrue),speedScoring(defaultfalse),timeLimit(5 to 240 seconds ornull, default 10),readTime(0 to 30, default 5),autoLock,optionOrder(written,sharedShuffle,perPhoneShuffle),showCount,leaderboard(always,end,never),afterQuestion(nothing,top3,full),review(off,screen,download) andscreenNotes. A question can give its owntimeLimit,readTime,keepOrder,showCount, amultiplier(1 to 10) and apenalty(0 to 1000).timeLimit: nullmeans no limit, which speed scoring does not allow. - Open answers:
displayiswall,oneByOneorcloud;answersPerGuestis 1 to 1000 ornullfor any number;lengthisshortorlong;anonymousandautoApprovalare booleans.
When the file is wrong
The app reads the whole file before it changes anything. It refuses a file that is not valid JSON, has the wrong format or version, or is too big. An item that is wrong is skipped, and the app names its place, such as items[1].questions[0].options[1].id, and asks before it keeps the rest. Numbers are never clamped: a number out of range makes the item wrong.
Check the file as you type
A JSON Schema describes the file. In VS Code, treat .laser files as JSON with this setting, and point $schema at the downloaded schema to get completion and warnings:
{
"files.associations": {
"*.laser": "json"
}
}