Quick Reference for Android Player Settings

This page will allow you to understand each line in the settings of your Android player application.
To access the settings, just start your player application and in the entrance screen, click the cog icon in top right corner of the screen.

Digital Signage Android Player Quick Reference
Player
———
Name – Displays a name for the reporting module. You can either type a name or empty this setting so the name will be generated automatically.
ID – The player device ID. You cannot change this.
Parameters Name – A name of a parameters group to personalize this player content.
Parameters Key – The unique key of this player to be sent to the parameters group.
Show Parameter – This will show the 2 parameters above in the entrance screen, along with the screen key. The default is set to off.

Display
———-
Hide Action Bar – This will hide the Android action bar in order to have the playlist running full screen. The default is set to on. In Kiosk mode, you should set it to off.
Display Notifications – This will display connectivity/loading notifications, warnings and errors on screen. The default is set to on, but after setting up an Android machine with a specific playlist, you’re supposed to turn it off.
Player Orientation – This controls the player orientation which can be fixed (landscape or portrait) or by the sensor (default). This setting won’t help you if the Android operating system of the machine doesn’t support portrait. In that case, you’ll have to flash a different ROM to the machine in order to support portrait orientation.
Video To Video Transition – This is the mode of transition into a slide or into a widget which contains a video. There are 6 options:
  * Auto (this is the default) – estimates what best fits for the device
  * Performance – fastest, not all devices, limited video count
  * Medium Compatibility – fixes black flashes on some devices
  * High Compatibility – wide range of devices, may introduce slight delay
  * Background – fade out/in with background color, all devices
  * Disable – no transitions between slides or widgets with video
Video Loop – This is the loop mode of a video widget playback. There are 6 options:
  * Auto (this is the default) – estimates what best fits for the device
  * Device – lets the device loop
  * Rewind – rewinds on finish, wide range of Android devices
  * Reload – new instance before finish, not all devices
  * Reload/Compatible – new instance after finish, wide range of Chrome OS devices
  * Disable – no video loops
Slideshow Transitions – This can disable all the transition effects (images + videos) of slides within a slideshow widget. The default is set to on.
Screen Color – The screen background color which is behind slides and transition effects.
Accelerate Text Animations – This provides better performance for rolling text as RSS feed, ticker and Twitter widgets. The default is set to on. In some dual core devices (such as smartphones), you might need to turn it off, to prevent screen blinking.
Disable WebView Overlay – This Allows the webpage widget to be covered with other widgets. By default it is set to off (means that the webpage widget is always in the foreground and cannot be behind other elements).

Connectivity
——————
Sync Frequency – This sets the frequency of inquiring the server for changes in the playlist. The default is every 2 minutes.
Randomize Sync Time – This shifts the updates (calls to the server) after the start by randomizing the start sync interval. It is meant to reduce the network load. The default is set to on.
Connectivity Timespan – This enables the playlist updates only in the defined timespan. It is meant to reduce the network load. The default is set to off.
Work Offline – This allows working offline, so the that the playlist will be played from cache only. The default is set to off. Please notice that online widgets such as YouTube, web page, polls and FTP won’t work while in offline mode.
Retry Failed Downloads – This will try to resume downloading failed media periodically, according the defined sync frequency (the default is on). To learn more click here.

Reliability
————–
Daily Restart – This allows a daily restart for the application. It is recommended and usually unnoticed. The default is set to on.
Restart Schedule – If the daily restart is on, this setting will determine when will the restart take place. The default is 00:30. There are several options for multiple restart times. the intervals are not less than every round half an hour.
Restart Timing – Determines if the restart will take place just after a playlist round or before the next slide. The default is after playlist round (so the playlist won’t be cut while running).
Force Delay – Determines within how many minutes will the restart take place, in case the playlist or slide are too long and the time for the restart has arrived.
Keep Alive – This allows restarting the player application in case it gets stuck. It works as a system service in the background. The default is set to on.

Start Mode
—————-
Start Playlist From Recent Slide – This will start the player from the last played slide, in case it stops from any reason (the default is on).
Start Slideshow From Recent Widget – This will resume to a slideshow widget to the last played widget. It is useful in case of a slideshow which is longer than the creative assigned duration or in case you think that the slideshow might be cut in the middle (for example, when using the advertising system and setting a short break point interval).
Start From Cache – The player Will start playing from the cache. For this, the content must be played once before turning this on (the default is off). To learn more click here.
Start On Slide Ready – When the first slide is ready, it will start playing without waiting for the other slides to complete being downloaded (the default is off).
Dismiss Key Screen – This will omit the entrance screen when the player application starts running. It is useful in showcase mode. The default is set to off. When it is set to on, in order to make the entrance screen to appear, you need to touch the player application’s top left corner and hold it for 4 seconds and then release it.

Play Mode
—————-
Skip Incomplete Slides – Will skip playlist slides which were not fully loaded or have failed during downloading (the default is on). To learn more click here.
Notify On Slide Skip – If the display notifications is on, it will show a notification when a slide is skipped (the default is off). To learn more click here.
Skip Slideshow Incomplete Slides – Will skip slides of a slideshow widget, within a blended creative, which were not fully loaded or have failed during downloading (the default is on). To learn more click here.
Restart on Inactivity – This can start the player application when there is no activity in the Android device. The default is set to off. It is for allowing showcase mode, usually in smartphones (so, when the buyer in the store leaves or doesn’t touch the smartphone, immediately it starts playing a playlist, just like a “screen saver”).
Start Inactivity Interval – In case of showcase mode, this will set how many seconds will the device stay inactive before it starts playing the playlist.
Dismiss on Touch – Turning this on will allow stopping the player application when the user touches the screen. It is meant for showcase mode. The default is set to off.
Launch on Touch – Turning this on will allow launching a 3rd party app by touching the screen of a running playlist.
Application to Launch – Once you turn on the “Launch on Touch”, here is where you have to type the Android package name of the 3rd party app.
Disabling Interaction in WebPage Widget – Turning this on will disable the interaction with the webpage widget in a running playlist, means that touching the screen or clicking it where the webpage widget is located, will not make you surf into that website.
Navigate on Touch – Turning this on will allow the user (in case of touch screen as in a tablet) to touch the right or left edges of the screen in order to jump to the next slide or previous slide in the playlist.
Keep Screen on – Turning this on will prevent from the screen to turn off when the user presses the power button (to go to sleep mode) or when it happens by timeout. It is useful for showcase mode. The default is set to off.

Play Sync
————–
Playback Clock – Turning this on will turn on the sync feature of using the clock (in front of an NTP server) for exact slide timing. To learn more about the sync feature, please read this technical post.
Reference Time – Starting point for sync calculation. The default 6:00. You should change it maybe to one hour before the beginning the playlist.
Clock Server – The permanent IP address of the NTP server (on standard port 123, or IP adderss:port if a custom port was set).
Clock Update – Clock refresh interval. The default is 1 minute, should be good for LAN. No need to change anything here.
Wait for clock – When set to on (default), the player will not start the playback until an initial sync was performed. When the server is online, usually the sync is performed far before playback start.
Video Accommodation – The delay before starting the video playback. Various devices have different delays on preparing video before playing, some like Minix also have bugs hanging UI for random 1 – 2 sec while probing MP4 format. This delay can vary significantly even across same device types and will result in loss of synchronization even when having perfect pulses. More delay gives more room to amortize these differences between devices on the expense of a black screen between videos. The default is 2 seconds but can be reduced for fast devices (it should be maximum of possible video load delay among all synchronized devices).
Timing Debug – Turning this on will show a blinking sync indicator and sync traces on top of content. If there is a problem, but the indicators on the different players are blinking seemingly simultaneously, it means that the players are in sync and the problem is not with pulse synchronization. When the clock server cannot be reached, the indicator becomes red (players still can be in sync for a while if initial update was successful, until clocks diverge too much, on good devices it can be days).

Advanced
————–
Cache Control – This section controls the storage and cache limits.
  Clear Cache – Clicking this will clear all the downloaded contents in order to free space.
  Cache Cleanup – Toggles the conditioned cleanup rules (the default is off).
  Min Free Cache – This is the minimum free memory allowed (in MB). Crossing it will trigger the cleanup of unused media files.
  Max Free Cache – This is the maximum memory (in MB) that will be free after cleanup. That means that if the cleanup process was triggered and
  started cleaning, it will stop once it reaches this amount of free storage (or when it has nothing else to clean from the cache folder).
  Max Allowed File Age – This is the number of days of old unused files to be cleaned. The default is 60 days. Every day at midnight, all media files which
  are unused for 60 days or more will be deleted from the cache.
Disable HTML5 YouTube – The default is on, to be compliant with older versions of the app, that used to use the YouTube 3rd party app in order to play YouTube videos. From version 4.3.13 and higher, you should turn it to off, in order not to use the YouTube app anymore (no need as the app knows how to play YouTube with no need for 3rd party app).
External Interfaces – This section controls interfaces with the hardware.
  Camera – Toggles using an external camera (usually for integrating with face recognition 3rd party software). The default is off.
  RF ID Reader – Toggles using an RFID or barcode reader. The default is off.
  Custom Event Transmitter – Toggles using any external device that can trigger events by transmitting HTTP responses to this device in a certain XML format. The default is off.

Web Browser
——————-
Request Desktop Site – Turning this on will apply a “desktop mode” on the player (where the website is adjusted to the widget size), in the webpage widget.
Overview Mode – Hint for the browser to fit the page to the frame width. To be used only in rare cases, for scale adjustment. The default is set to off.
Wide Viewpoint – Respect meta viewport tags. To be used only in rare cases, for scale adjustment. The default is set to off.
Scale Percentage – Allows further adjustment to the desktop mode. It is the page initial scale in percents (like zoom-in / zoom-out).