Introduction

This article explains how the "Mobile-Driven Data Entry" sample experience was built and how you can reuse it for your own needs. To access this sample, download it using the Examples tab of the Experiences panel in Composer. You can also download it directly from the Intuiface Examples catalog. 

This sample contains three examples of how to enable audiences to use their mobile phone to provide inputs - such as answers to a multiple-choice question or free-form text - to a running experience. This experience could be running in a physical location such as a large meeting room or public area, but could even be displayed via a screen-sharing session.

 

Video

 

How it works

General principles

Each of the three examples in this experience follows the same workflow

• An Intuiface experience runs in Player and an audience can see it, either in-person or via a web-hosted screen-sharing session.
• People in the audience use their smartphone to scan a QR code displayed by the experience
• The QR Code leads to a simple webpage opened in the smartphone's web browser. The audience member can enter information via the device's virtual keyboard.
• The entered information is sent from this webpage to the Intuiface experience.  

The diagram below summarizes the workflow for each sample. You'll note that two scenarios use the Web Triggers API to send the information back to the experience, while the third accesses a third-party API (Airtable) with the help of API Explorer. 

Important security note

In the two cases using the Web Triggers API, the generated QR Code contains confidential information: your Intuiface account's credential key (entered when starting the experience). This is not a safe approach for passing private information between the experience and the webpage, but it is the only approach that makes this sample experience easily testable by all Intuiface users.

When using the webpage-based method for a real-world project, we strongly recommend that you store your credential key either on the webpage itself or, even better, somewhere on the server side of your code.

Intuiface is not responsible for creating webpages nor ensuring web-hosted information is secure. The "Mobile-Driven Data Entry" experience uses a simple webpage as an example but you are responsible for creating your own webpages for actual deployments.

Multiple Choice Poll

This example illustrates how you can ask your audience a question and provide multiple choices as possible answers. This technique is similar to the one discussed in this Live Poll community thread. 

When scanning the QR Code, people in the audience will see this webpage on their mobile device:

This webpage is composed of the following three files that you can download:

• index.html
• script.js
• style.css

As noted above, this HTML is only provided as a simple, easy-to-understand, and reusable approach to working with the Web Triggers AI. It is not secure and should not be used as-is. Be sure to consider information security when creating your own webpages.

Analytics

Below is an example of a chart you can create based on the information logged by this experience. 

Free Form Text Entry

When scanning the QR Code, people in the audience will see this web page

This webpage is composed of the following 3 files

• index.html
• script.js
• style.css

As noted above, this HTML is only provided as a simple, easy-to-understand, and reusable approach to working with the Web Triggers AI. It is not secure and should not be used as-is. Be sure to consider information security when creating your own webpages.

Analytics

Below is an example of a chart you can create based on the information logged by this experience. 

Multiple Field Form 

When scanning the QR Code, people in the audience will see this webpage:

Unlike the previous two examples, this webpage is directly generated by a third-party service used in this example: Airtable. When clicking the Submit button at the bottom of the form, the entered information will be added to an Airtable base you preconfigured.

A notification is not sent to the experience; such a notification could be set using a custom script in a paid Airtable account. In this example, only features available with a free Airtable account were used. As a result, the presenter will have to hit the onscreen Refresh button in the experience to pull newly submitted information from the Airtable base. 

How to reuse in your own Intuiface experience

As opposed to most of the samples published in the Intuiface Examples catalog, the intent of this experience is not to be reused as-is, but to present concepts you can integrate into your own experiences. 

The easiest way to do this is to open two instances of Composer and copy the scene you're interested in from this sample experience and into your experience. You can find more details about this procedure in the article Copying content between multiple instances of Composer.