Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Difficulty: expert

Content

Table of Contents
minLevel1
maxLevel1

Learning Objectives

After reading this article, you’ll be able to:

  • Perform initial configuration on Android kiosksELO devices

  • Install the Kiosk App to run on Android kiosksELO devices


After installing the Kiosk Hardware according to Kiosk Hardware Installation, start the device.

Booting the Kiosk for the first time

When launching the device, you are presented with 3 options in the boot menu: choose ANDROID HOME

  1. You will go through a standard Android setup wizard, (similar to a first-time setup of a new smartphone)

  2. Connect to the network during the wizard in order to get an internet connection

  3. You’ll need a Google-account in order to access the Android Playstore and install the kiosk app.

Info

If you skip this step and don’t provide a google account, you can’t use the Playstore. You can still install the Kiosk app through the Spacewell website. However you won’t get automatic updates.

Android settings before installing the app

Configure below settings to keep the Kiosk App alive at all times, ready for end-users to use. It will also remove the possibility of them easily breaking out of the app.

1. Change the Android Display setting

Change the DPI settings of the device before using the Kiosk app. This will improve the scalability of the app

‪Go to Settings > Display Settings > Advanced > DPI settings > set to the lowest value (often 160)

Image RemovedImage Added

2. Disable Sleep Mode

Android sleep/idle mode will kick you out of the app, so it’s better to disable these features.

  1. ‪Go to Settings > Display > Automatic idle mode: set to “Backlight off during a specific time period”

  2. Go to Settings > Display > Screen timeout: set to “never”

3. Remove 3-Button Navigation

To set up tablet-mode with gesture navigation, remove 3-button navigation. This will also limit the break-out possibilities for end-users out of the Kiosk app.

‪Go to Settings > System > Gestures> System Navigation > set to “Gesture Navigation”

4. Define Landscape or Portrait mode

In Settings > Display, select “Auto-rotate screen”. Depending on the installation angle of the screen, the Kiosk App will launch in landscape or portrait mode.

5. Enable Screen Pinning

Once you’ve downloaded the Kiosk app (see below), you can lock the Kiosk app to prevent going outside the app.

  1. ‪Go to Settings > Biometrics and security > Other security settings > Advanced > Pin windows

  2. Open the Kiosk app > open recent apps > Click on the Kiosk app Icon > Select pin this app

Info

Every time you exit the app after this (for example after device restart or after an administrator has exited the app), you’ll have to repeat step 2 (pin the app).

Download the Kiosk app

Using the Google Playstore

Go to the Android Playstore and search for Spacewell Kiosk

Info

Downloading from official app stores allows for automatic updates.

Using the Spacewell app store

Use the Chrome browser installed on the device to visit the Spacewell Appstore (spacewell.com)

  1. On the Kiosk page, select the Android button (image below) to download the Kiosk app on the device.

  2. Then install the app manually.

  3. When prompted, approve “unverified .apk installation”.

Info

Downloading a specific Kiosk app version from the Spacewell Appstore, a version upgrade requires a manual action.

Install the Kiosk app

You’ll need a device account and an admin account in order to log in and install the Kiosk app.

Expand
titleOpen the app on your device

The boot screen of the app has 1 big button “let’s get started”

Press it (smile)

Expand
titleLog in with the device account

You will have to provide the device account that has been configured in Users & Groups (warning)

Note

If your device account is already in use by another Kiosk app, you will receive an error message. You’ll have to go to https://devicecontrol.cobundu.com/ and unlink the account used by the other kiosk.

Expand
titleWait for the app to ask for a configuration

If this is the first time you use the device account, the app will launch and give an error. Don’t panic, this is completely normal (wink) The app is asking which locations and profile to load.

You’ll need your laptop for the next few steps.

Expand
titleOpen device control to set up the new app

Go to https://devicecontrol.cobundu.com/ and log in with an admin account.

You should see you new device in the list with a label “not configured” on the right.

Expand
titleSelect the device and press START CONFIGURATION

When you select the device, a panel will appear from the bottom. Click on Start configuration.

Expand
titleSelect Floor Display

Select FLOOR DISPLAY in the pop-up window that appears

Expand
titleSelect locations + a profile & theme to be applied

Select one or more locations, a Profile and a Theme using the drop down menus.

These settings will be pushed to the Kiosk app after you pressed SAVE.

You can customize this later at any point.

Expand
titleGo back to the device and tap 'retry'

Once you pressed RETRY the app will continue it’s configuration

Expand
titleCongratulations, you're ready

Now you’re good to go

Troubleshooting

Expand
titleIs it possible to turn Kiosk App 90° to see it in portrait/vertical mode?

For Android, Kiosk App in kiosk mode is available in landscape and portrait mode. Change the system direction of your device as per the instructions in https://spacewell.atlassian.net/wiki/spaces/KB/pages/edit-v2/492558#4.-Define-Landscape-or-Portrait-mode

For IOS and Windows, Kiosk App in kiosk mode is only available in landscape / horizontal mode.

Expand
titleIs it possible to break out of the Kiosk app?

This Spacewell-Internal-Only page describes how to break out of the Kiosk app: /wiki/spaces/KB/pages/202014930


Search

Live Search