Install Appspace App and Configure Android Devices

The Android OS is a versatile operating system that can be found in a multitude of devices and brands. The Appspace App for Android is available for mobile devices/smartphones, tablets, Android TVs, and Android-based smart TVs and set-top boxes.

On Android, you have the option to use the Appspace App as a display device for signage, workplace displays, or room bookings, with the device registered and configured in device mode, or as a device ideal for workforce communications enabling users to browse content published to them via the user mode.

Configuring the Appspace App in device mode consumes one Device ID during registration, while the user mode consumes one User ID and is tailored for organizations to directly engage its employees, and is accessed using the employee’s user credentials for Appspace.

When installed, the Appspace App can automatically recognize the device; ensuring mobile devices will launch with the user mode, while TVs and set-top boxes launch in device mode. However, on a mobile device or a tablet, once in user mode, you have the option to switch to device mode and back.

This article provides the instructions to configure and register Android devices with Appspace App for TVs and set-top boxes, and for smartphones and tablets.

Prerequisites

  • The device must meet the manufacturer’s minimum hardware and technical specifications. Please refer to Supported Devices & Operating Systems.
    Warning
    It is highly advisable for you to ensure any chosen device will fit seamlessly into your environment, and meet the needs of your specific use case. Please test your Android devices with the Appspace App before you choose to deploy to your production environment. Do contact us for any questions and we’ll be happy to make some introductions.
  • An active Appspace account, with sufficient User IDs for user mode, or Device IDs for device mode.
  • Account Owner or Network Administrator role to register the devices in the Appspace console for device mode.
  • Account Owner, Network Administrator, or Publisher role to assign a channel to a device.
  • An active Internet connection.
  • It is recommended that the device clock is set to automatically retrieve time from a Network Time Protocol (NTP) server, with the correct time zone, in order for it to sync correctly with the Appspace server.

    Note
    • Appspace cloud servers by default retrieve time from an NTP server. If an Appspace on-prem server is used, ensure the server time is automatically retrieved by an NTP server.
    • Appspace has updated the timezone configurations, which now includes timezones other than GMT. This enables users with daylight savings to adjust the time accordingly. For more information, refer to the Appspace 7.1-ac.8 Release Notes

  • Please ensure your network is configured to allow Appspace whitelist URLs and the relevant network ports.
  • If using a proxy server, whitelist the hostnames listed in the ‘How to set up networks with SSL content filters’ section in the following article: https://support.google.com/chrome/a/answer/3504942#sslinspection

Install Appspace App on Android TV/Set-Top Boxes/Tablets

Follow the instruction below to download and install Appspace App on the Android TV or smart TVs and set-top boxes running the Android OS:

  1. Launch the Google Play Store app from your device, and search for Appspace.
  2. Select Appspace, and click the Install button.
  3. Once installed, click the Open button to launch the Appspace App. You may also find the installed app under the TV’s Home or Apps shortcut.
  4. Proceed to register your device using the 6-digit code or the QR code.
  5. Once complete, you may choose to manually assign a channel (if you didn’t during the registration process).
  6. Once the device sync is complete, the assigned channel will display on the TV. For instructions on navigating the App, please see Browse and Navigate Appspace App 2.0.

Install Appspace App on Android Smartphones/Tablets

Follow the instruction below to download and install Appspace App on Android devices such as smartphones or tablets. 

  1. Launch the Google Play Store app from your device, and search for Appspace.
  2. Select the Appspace app, and click the Install button.
  3. Once installed, you may launch the Appspace App by clicking the Open button in the Play Store, or from the Home screen on your device.
  4. Launch the Appspace App, and select the desired Appspace instance to log in:

    • CLOUD LOGIN
      1. Enter in your Appspace Cloud user credentials.
      2. Click the LOGIN button.
    • On-Premise Login
      1. Enter the URL to your company Appspace on-prem server.
      2. Enter in your Appspace on-prem user credentials.
      3. Click the LOGIN button.
  5. Once logged in, the Recent Updates page is displayed with channels assigned to you or your user group.
  6. Swipe right, or click the menu icon to bring up the side panel menu, which contains the available channel groups that you have been granted access to, and settings. Select your desired channel group to view your channels.
  7. If you would like this tablet to display signage or as a room booking solution,  you need to switch to device mode. Select Settings in the side panel menu, and click Switch to TV mode.

    However, this option is only available to users with the Network Administrators role.

  8. Once you switch to TV mode, you must register the device using the 6-digit code or the QR code, and assign a channel to the device. The device will then function like a media player. To move back to user mode before you register, click Switch to user mode on the device registration window.

  9. Once complete, you may choose to manually assign a channel (if you didn’t during the registration process).

  10. Once the device sync is complete, the assigned channel will display on the TV. For instructions on navigating the App, please see Browse and Navigate Appspace App 2.0

Important
    • If you have registered the device, and you wish to switch back to user mode, you must first unregister the device, and click Switch to user mode on the device registration window again.
    • We recommend a daily reboot of your device when using device mode (TV mode). The Android device management policy does not allow the Appspace App to automatically restart the device. You are recommended to use a Mobile Device Management (MDM) app such as AirWatch, to set the device in kiosk mode and schedule a daily reboot, especially when you have multiple Android devices in your network.

Enable In-App Browser

When displaying any website containing a Content Security Policy (CSP) in an iframe on the Appspace App via the new Web View card, the website is blocked from loading on Android-based devices. A workaround was released in Appspace App 2.19.2.

Important
This feature is not applicable to Android TVs.

To fix this issue, the Appspace App will now load the website onto an in-app-browser layer, which is sandboxed, simulating the website launch in a new browser window or tab.

To enable the in-app-browser feature on Android devices, follow the instructions below:

  1. Install the Appspace App (version 2.19.2 and later) on your device.
  2. Proceed to register the device, and select one of the following channel selection mode:
    • Autoplay published channels
    • Administrators can select a single channel
      Important
      The “Users browse published channels” channel selection mode is not supported.
  3. Once registered, add the following device property and value (which are case sensitive), by following the instructions in the Add Device Property article.
    • Device property: player.media.webEngine
    • Device property value: inappbrowser
  4. Create a legacy Web content, and enter the desired website URL. 
  5. Add the legacy web content to a playlist channel, and publish the playlist channel to the Android device to be displayed.

The limitations to this feature are:

  • If using a browser with CSP, you can no longer use the new Web View card because Appspace Cards is unable to talk to the browser layer. You must use the Web (Legacy) content instead (available in the Library under the Legacy category).
  • The in-app-browser feature cannot be enabled on devices that have been assigned with Channel Browsing mode with user interaction (“Users browse published channels” channel selection mode), due to layering limitations.
  • The device must be configured to display a single channel only or autoplay multiple channels (“Autoplay published channels” or “Administrators can select a single channel“ channel selection mode).
  • The in-app-browser is rendered above the Appspace App in full screen, thus the website displayed will be the top-most layer.
  • For customers using the advanced channel with a Media Zone layer that is not in full screen, the website will automatically be rendered in full screen, ignoring the widget layering.

Update Appspace App

The Appspace App is automatically updated by default on Android devices. However, if the app does not update, please follow the instructions to enable automatic updates in the following Update your Android apps article: https://support.google.com/googleplay/answer/113412?hl=en

Uninstall Appspace App

To uninstall the Appspace App, just select Appspace from the Google Play Store and click Uninstall, or simply follow the instructions in the following Delete or disable apps on Android article:
https://support.google.com/googleplay/answer/2521768?hl=en.

 

Related Articles