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.
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.
Auto Upgrade – This option (“off” by default), allows you to set the app for auto update, to be upgraded every time there is a new version of the app (for that, just set it to “latest”). This feature will work only if the device is rooted. If you like to check if your device is rooted, you can use any root/super user testing app to see (some thing like “Root Checker” app).
Bug Report – This button sends the log files of the app to the cloud, in case there is a suspected bug to report. You can press the combination of Ctrl + Alt + D, instead of clicking this button. Before sending us log files of a suspected bug, better set the “Debug Log” setting (under the following “Logging Settings” block) to “on”.
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).
SSL Connection – This enables SSL secured traffic (HTTPS) on the app. The default is set to off.
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.
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.
Resume Playlist – This will start the player from the last played slide, in case it stops from any reason (the default is on).
Resume Slideshow – 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.
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.
Launch on Touch Application – Once you turn on the “Launch on Touch”, here is where you have to type the Android package name of the 3rd party app.
Launch on Touch Extra – Parameters to be sent to a triggered APK by touch (example: key1=value1;key2=value2).
Once you turn on the “Launch on Touch”, here is where you have to type the Android package name of the 3rd party app.
Launch on Swipe – Turning this on will allow launching a 3rd party app by swiping a finger over the screen, when running playlist.
Launch on Swipe Application – Once you turn on the “Launch on Swipe”, here is where you have to type the Android package name of the 3rd party app.
Launch on Swipe Extra – Parameters to be sent to a triggered APK by swipe (example: key1=value1;key2=value2).
Disable WebPage Widget Interaction – 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.
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.
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.
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).
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 Location – The location of the cache (your media items). There are 3 options:
* External storage (this is the default)
* Internal storage
* Custom path (for disk-on-key USB stick, SD card or anywhere else)
* 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).
Video Transitions Tune – This section performs fine tuning for the video transitions. Only in some cases, it is required to alter this setting.
* Manual Init Compensation – Toggles this whole section, in case you want to alter the default settings. The default is off.
* Buffer Delay – The buffer duration threshold (in milliseconds). When the Manual Init Compensation is turned off, the default is 30ms, while when the Manual Init Compensation is on, the default is 300ms. For MXQ Pro player, use 300 and “Performance” video transition; for X96 player, use 220 or 260 or 300 (depends in the firmware) and “Performance” video transition. For other devices, which have transition issues, it’s a trial and error.
* Buffer Count – Minimal buffer update count threshold. The default is 1. No need to change it.
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.
* IoT Remote Events – Submenu for the remote events feature (by getting them from a cloud web server, instead of getting the keyboard events directly from a connected USB IoT device).
* Enable Remote Events – Toggles using the remote events feature. The default is off.
* Event Name Prefix – Filters the product code (i.e. RFID tag code) to be sent to the web server. The default is ALL.
* Custom Remote Events API URL – URL of your web server for responding to the app (the cloud that should respond with events). The default is empty.
* Integration API Key – If the cloud’s API requires a key (will be sent in the header as api-key), this is where you should type it. The default is empty.
Force Notifications – This setting makes all notification settings behave as turned on. The default is off.
Event Transitions – This section controls the touch and event transitions.
* Touch Transitions – Overrides the default transition settings for touch events only. The default is off.
* Touch Transition Duration – The touch transition duration in milliseconds. The default is 2000. Setting it to 1 millisecond will be the fastest possible transition.
* Touch Skip Video Ready – Ability to start the transition without waiting for the video readiness (in Android it’s instantly). The default is off.
* Event Transitions – Overrides the default transition settings for all other events (mainly keyboard events. The default is off.
* Event Transition Duration – The event transition duration in milliseconds. The default is -1. Setting it to 1 millisecond will be the fastest possible transition.
* Event Skip Video Ready – Ability to start the transition without waiting for the video readiness (in Android it’s instantly). The default is off.
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).
Use HTTP Basic Authentication – Allows using basic HTTP authentication in the webpage widget. The default is set to off.
* HTTP Basic Authentication Login – When the HTTP authentication is used, in this setting you need to type the username.
* HTTP Basic Authentication Password – When the HTTP authentication is used, in this setting you need to type the password.
Auto Scroll – Allow automatic scrolling (down and up) in webpage widgets. The default is set to off.
* Auto Scroll – Enable auto scrolling. The default is set to off. This feature works only on Android Lollipop (v5.1.1) and above.
* URL Match – If this is set, it will enable scrolling only for pages which match the text.
* Scroll Up Speed – Scroll speed in pixels per second, when scrolling up. The default is 15.
* Scroll Up Delay – Seconds to wait before scrolling up. The default is 10 seconds.
* Scroll Down Speed – Scroll speed in pixels per second, when scrolling down. The default is 15.
* Scroll Down Delay – Seconds to wait before scrolling down. The default is 10 seconds.
* Rendering Mode – Rendering method when scroll animation is active (text quality vs. animation quality). The default is software.
Debug Log – Turning this on will apply debug information to the log files, which are being recorded. Use it only when you suspect a bug and about to send us log files. Otherwise, turning it on, permanently, will decrease the performance of the player app.
Log Files Count – The maximum number of log files to be stored. The default is 5.
Log Files Total Size – The maximum size of all log files to be recorded, in MB. The default is 100 MB.