Skip to content

Releases: AutonomicPerfectionist/MyRobotLab-Android

v0.0.1-alpha

23 Dec 18:29
@AutonomicPerfectionist AutonomicPerfectionist
v0.0.1-alpha
9dadcdd

Choose a tag to compare

View all tags
v0.0.1-alpha Pre-release
Pre-release

This is the first alpha release of MyRobotLab Android. This release depends on the ap-android-alpha-1 branch of MyRobotLab and may not function in the future.

Compatible Devices
This release should be compatible with Android phones and tablets down to Android 5.0 Lollipop. There exists an issue where the WebGui tab does not load the page in older versions, however, services should still function as normal.

How to Run

  1. Download the attached APK on your Android device and open it; you may need to grant permissions to your browser or file manager to install applications.
  2. Clone MyRobotLab
  3. Checkout the ap-android-alpha-1 branch in your newly clone git repo
  4. Build with mvn package -DskipTests
  5. Copy the myrobotlab.jar file from the generated target/ directory and place it in the root of the cloned repo next to myrobotlab.sh.
  6. Run myrobotlab.sh, making sure you have Java 11 installed and it is the default.
  7. Open the app on your phone and click Connect, enter the IP address of the computer where MRL is running in the host field and enter 8888 in the port field.
  8. If the connection is successful, the Connect button will switch to Disconnect. Otherwise, a message will appear telling you an error occurred. Now you may start services and use them as you wish.

Examples
Example scripts to be run from the MRL Python service are available in this repo's examples/ directory.

Known Issues
This release has several known issues that will be fixed in later releases.

  1. The list of running services is not updated immediately. The user must switch to a different tab and then back to update the list.
  2. Two of the implemented services do not implement the full service type interface. AndroidSpeechRecognition only implements {start|stop}Listening and publish{Listening|Recognized}. AndroidTTS only implements speak() and onText().
  3. The services are ran on the app's view model thread and may be put to sleep when the device goes to sleep, or the app is no longer in the foreground.
  4. Starting an Android service will cause the WebGui to no longer render service tabs on a reload. This needs to be investigated on the MRL side.
  5. The AndroidTTS service will not output audio the first time speak() is called. Just call it again, and it should work.
  6. The WebGui tab does not load the webpage on older Android versions

There may be additional issues with this release, check the Issues list on this repo and if you believe you've encountered one not stated here or there feel free to open a new issue.

Loading