3rd-party UI: User Guide

⚠️ Warning

This feature is currently in an experimental stage. Bear Robotics does not guarantee stability, performance, or long-term support

UI and refresh behavior are subject to minor changes as the feature evolves

Only enable the 3rd-party UI feature. Do NOT use other experimental features, as they may cause unexpected behavior

A stable internet connection and reliable third-party hosting are required. Network or hosting issues may cause UI loading failures or unexpected behavior on the robot

Overview

• What is 3rd Party UI?

  • This feature allows customers to replace the default touchscreen UI on Bear Robotics robots with their own custom web-based UI

• How it works

  • Customer side: Develop and host a web site that serves as the custom UI

  • Robot side: Once this feature is enabled, it loads the website on its touchscreen

• Supported Robot Software Version

  • Servi: servi-24.04.2 or above

  • Carti: amr-24.03.1 or above

• Refer to the BearAPI User Guide for API integration instructions

How to Enable

1. Enter Experimental Settings

⚠️ Access to this setting is restricted to authorized users only. Please consult with Bear Robotics to gain access to the '3rd-party UI' configuration

2. Turn on the 3rd-party UI feature

• 2.1 Search for “3rd Party UI”

• 2.2 Enter the URL under “3rd Party UI URL”

• 2.3 Toggle the feature ON

3. Return to the Home Screen

Controls and Beahvior

• Show and Hide the Status Bar

  • Tap the “arrow icon” at the top-right corner to show the status bar

    • You can access the Settings

  • Tap the “arrow icon” again to hide the status bar and return to full-screen mode

• Auto Refresh Behavior

  • The web page will automatically refresh every time you go to Settings and return to the Home Screen

• System Overlay Screens

  • In certain situations, Bear’s built-in screens will appear over your custom UI:

    • Booting, Mapping, and Setting

    • Notice: I'm Stuck, Narrow Space, Localizaing

    • Mission: Mission Failed, Mission Paused

    • Emergency Stop: E-Stop Button Pushed

    • Battery: Low Battery, Charging

    • Multi-Robot: Waiting

• Pause Screen Behavior

  • If the robot is paused, Bear’s built-in Pause screen will appear over your custom UI

Web UI Requirement

• Server Response Header

  • Avoid using x-frame-options: deny or sameorigin in the server response headers. These settings will block the robot from loading the web app.

• Screen Resolution / Sizing

  • Servi, Carti: 1278 x 798

  • Servi Plus: 1022 x 766

• Fonts

  • Use web fonts to ensure proper rendering across languages; otherwise, text may appear differently on the touchscreen

    • Example: Pretendard, recommended for Korean language support

• Overlay Button Area (“Arrow Icon”)

  • The overlay arrow button occupies the following area on the screen

    • Position: top: 20px, right: 32px

    • Size: 56px x 56px

  • Avoid placing key UI elements underneath this region to prevent interaction issues

• Screen Mirroring in Fleet Control Suite

  • The Fleet Control Suite supports mirroring functionality ("Telemetry") for monitoring purposes only

  • The screen content is displayed remotely, but touch interactions are not supported

Limitations

• Users must enter a valid and accessible URL correctly

• If the network connection is lost (e.g., Wi-Fi disconnects, or the web server is unavailable), the touchscreen may display a blank white screen without any error message

• The UI will not auto-refresh after network recovery. Users must manually reload it by entering Settings and returning to the Home Screen

Troubleshooting

• If the UI displays a white screen or does not refresh properly, follow the steps below:

• Manually refresh it by navigating to Settings and then returning to Home Screen

• Check Wi-Fi connectivity

• Check whether the entered URL is correct

• Check whether the 3rd-party web hosting is accessible via a browser