Remote Control HTTP

Provides a simple HTTP server that exposes REST-style endpoints for remote vehicle control. Registers a virtual input device and emits axis/button events over HTTP.

Public API

HTTP Endpoints

Internals

• HTTP server: Uses utils/simpleHttpServer module for lightweight request handling
• Virtual input device: Registered via getVirtualInputManager() as type httpcontrollerv1 / instance bngremotectrlv1 with 1 axis and 2 buttons
• Axis demo: Continuously emits a sine-wave value (sin(timer) + 1) / 2 on axis 0

How It Works

1. onExtensionLoaded starts the HTTP listener and defines route handlers
2. onUpdate calls ws.update() to process incoming HTTP requests
3. On first update, registers a virtual input device with the engine's VIM
4. Each frame emits a sine-wave axis value (demo behavior)
5. The /api/btn endpoint toggles a button state and emits button events
6. onExtensionUnloaded cleans up the virtual device

Usage Examples

-- Load the remote control extension
extensions.load('remoteControl_remoteControl')

-- From a browser or curl:
-- GET http://localhost:8081/api/ping    → ["pong"]
-- GET http://localhost:8081/api/getInfo/ → {v: "0.32", arch: "x64", ...}
-- GET http://localhost:8081/api/btn      → toggles virtual button

Key Notes

• Server binds to 0.0.0.0:8081 - accessible from any network interface
• The sine-wave axis emission is a demo; real usage would map HTTP inputs to vehicle controls
• Virtual device supports 1 axis (index 0) and 2 buttons (index 0)
• Uses os.clockhp() for high-precision input timestamps

See Also

• Game Engine Overview - Guide