Usage

From RidgeRun Developer Wiki

Follow Us On Twitter LinkedIn Email Share this page








Usage

This section describes how to operate RidgeRun Immersive Teleoperation using the available operator interfaces. The platform supports both a browser-based Web Interface and an immersive VR interface, allowing operators to control the robot and view live video depending on the desired interaction mode.

Web Interface

The Web Interface allows operators to view live video and control the robot directly from a web browser. The source code for the application is available in the web directory at the root of the project.

1. Build and serve the web application locally:

cd web
nom install
npm run build
npm run preview -- --host 0.0.0.0

2. Open the URL displayed in the terminal (typically http://localhost:4173):

3. Enter the robot URL and configured port (8081 by default), then click Connect. For example: `http://10.42.0.184:8081`

4. Once the connection is established, operate the robot using the keyboard controls (WASD / QE and arrow keys) or the on-screen controls with the mouse.

5. The currently displayed camera stream can be selected using the Front, Rear, and 360 buttons located below the video area.

VR Interface (Meta Quest Application)

The VR interface provides an immersive teleoperation experience using a Meta Quest 2 headset and a 360-degree video stream.

1. Install the VR application APK on the headset using ADB:

adb install <path-to-apk>

2. Launch the application on the headset. Upon startup, the application automatically requests the 360-degree video stream and control authority, and begins rendering the video.

3. Once the panoramic video is visible in the headset, use the joystick on the right controller to control robot movement. The operator can naturally look around to explore the robot’s surroundings, providing an immersive, in-person–like experience.