myUI Android App Installation

myUI is Allonis's "App".  It is software installed directly on the phone or tablet device.  Within it, runs a controlled, full screen browser that displays webpages served by myServer.
Running myUI app has several advantages over running the myServer HTML user interface in a browser.
  • Runs full screen
  • Enables myServer to monitor and control Android Device hardware (microphone, speaker volume, GPS, etc)
  • Manages Web UI sessions so multiple launches won't create multiple sessions that ultimately hurt performance.

 myUI is essential to enable several myServer features:

  • Voice Recognition
  • Geo Boundry Events
  • Intercom
Download the App from myInstaller.
Install it once downloaded.  This will add the myUI.apk to the myServer PC's desktop (or the PC you launched myInstaller from).
Sideloading an android App (installing an app that isn't downloaded from Google Play Store):
  1. You should see myUI.apk on your myServer PC's desktop.
  2. Plug in your Android Tablet into the USB port of myServer PC.  You may have to select "Connect as Media Device" on your tablet for your tablet to show in your Windows file explorer.
  3. On Tablet (or Phone), click "Settings", the "Security", then ensure "Unknown Sources" is checked.
  4. Your Tablet will show itself in myServer PC as a new storage drive (let's call it drive "M") in File Explorer
  5. Drag the myUI.apk file from the desktop to the "Android" folder in Drive M.  (Note if "Drive M" is on the device storage area or on an SD card that may be plugged in)
  6. You can disconnect the tablet from myServer PC's USB port.
  7. On the Tablet, launch "My Files" app.  Look in the "Device Storage" folder.
  8. Find the "Android" file folder.
  9. You will see the myUI.apk file in there.
  10. Click on myUI.apk and open it.
  11. Accept all installation questions (security, do you want to install, etc).
You should now see the myUI application on the tablet.  Let's configure the App:
  1. Ensure your Tablet is on the WiFi network that has connectivity to the myServer PC.
  2. Launch the myUI App on the Tablet.
  3. On launch, the app should say "GET STARTED".  Click it.
  4. Then click "DISCOVERY"
  5. Wait up to a minute for the myServer PC path to appear.  Under that, click on the Application link.
  6. You should see multiple HTML App names.  These come from /myserver/HTML folder.
  7. Select the App name that is closest to the tablet device ("myUI.Tablets 1024x768 App" as example)
  8. Click "NEXT"
  9. You can change the clientname here.  (Note, this should match your settings for "Web Client" in myAgent radio settings if you have already set this up - optional).  Client names MUST start with a letter. You may use any combination of the letters A..Z and numbers 0.9 to define the client name. You CANNOT include spaces or punctuation marks!
  10. Default is to enable Voice Recognition (requires optional license on myServer) and Enable Geo Location (optional on myServer)
  11. Click "Save and Launch App"
  12. Discovery is responsible for finding the server and defining what app gets associated with the device. Once those settings have been configured then the next time the app is launched the app uses those settings to grab the app and run it. The app then launches in a 4 step process.
    1. Grabs the styles.css from the apps css folder,
    2. Grabs the scripts.js from the apps js folder
    3. Grabs the custom.js from the apps js folder and if all that was successful
    4. Load the index.html file from the apps root folder. all this comes from the local myServer.
  13. You should now see the chosen HTML app running full screen on the Android device.  You may need to provide your login name and password if myServer is setup for signon.
  14. Your Android device should ask permission for the App to use your location.  Approve this and the Android panel should disappear. If you reset config of the app (see below) or upgrade the App, you will need to approve again.
  15. You may notice an Android bar at the top of the screen.  Slide it down, process the request (security or other) and slide it back up.  The myUI app should now be full screen.
  16. To Reconfigure the app, when on the myServer network: Click on the Menu and then click on "Allonis".   At the bottom right, click on "Reset Config".  The app will relaunch and initiate Discovery again.  If you are NOT on the myServer network, then Clear all Data from the myUI.apk app (Settings / Applications / Application Manager / myUI / Storage / Clear Data), and relaunch it (note, the above instructions are for Android 6.0.1 OS.  If your OS is different, you will need to find your devices location for these functions).

NOTE:  Discovery will only work if your myServer network DNS name is set with the server's IP address.  This will be addressed in a myServer update coming soon.

myServer regularily sends a UDP broadcast out on port 1900.  myUI, when on same network hears that request.  This provides the information for myUI to request from myServer the full connection and list of web apps that exist via a TCP request to myServer.  Your network must be configured to allow these communications for Discovery to work.  If UDP is not enabled on the network, you must do a manual configuration to have myUI "find" myServer to complete the rest of installation configuration.


The new client commands (as of 8/21/2017) are:

DimScreen|0..100 or WebCmd|{{clientname}}~DimScreen|0 to 100

ScreenSaver|On,Off or WebCmd|{{clientname}}~ScreenSaver|On or Off

Locking the app in Landscape or Portrait is done during the configuration of the App.


Developer USB Debugging - how to turn on (Android OS only)

Navigate to Settings > About Phone > scroll to the bottom > tap Build number seven (7) times. You'll get a short pop-up in the lower area of your display saying that you're now a developer. 2. Go back and now access the Developer options menu, check 'USB debugging' and click OK on the prompt.

Plug your Android device into your myServer PC's USB connection.  You might get a prompt on both the PC and on the Android device.  You want to allow USB Debugging.

Here is more info and pics: