BØ-based remote API

The BØ-based remote API should not be mixed-up with the legacy remote API (or simply remote API) which is an older version of the remote API that is less flexible, and more difficult to extend.

The B0-based remote API is part of the V-REP API framework.

The B0-based remote API allows to control a simulation (or the simulator itself) from an external application or a remote hardware (e.g. real robot, remote computer, etc.). The V-REP B0-based remote API is composed by approximately one hundred specific functions and one generic function, that can be called from a C++ application, a Python script, a Java application, a Matlab program, or a Lua script. The B0-based remote API functions are interacting with V-REP via the BlueZero middleware and its interface plugin to V-REP. All this happens in a hidden fashion to the user. The remote API can let one or several external applications interact with V-REP in a synchronous* or asynchronous* way (asynchronous by default), and even remote control of the simulator is supported (e.g. remotely loading a scene, starting, pausing or stopping a simulation for instance).

The word Synchronous is used in the sense that each simulation pass runs synchronously with the remote API application (i.e. the simulator will wait for a trigger signal from a client to start next simulation pass at a time t+dt). This is different from synchronous/asynchronous in the sense of blocking/non-blocking operation. The remote API also supports blocking and non-blocking operations.

Make sure you understand how the B0-based remote API is operating by reading this section. Also have a look at the external controller tutorial.

The B0-based remote API functionality comes in 2 separate entities, that are interacting via the BlueZero framework:

  • the client side (i.e. your application): the B0-based remote API on the client side is available for many different programming languages. Currently following languages are supported: C++, Python, Java, Matlab and Lua. Bindings for other languages can easily be created by yourself. Instructions on how to enable the B0-based remote API on the client side are given here.
  • the server side (i.e. V-REP): the B0-based remote API on the server side is implemented via a V-REP plugin and a Lua script (lua/b0RemoteApiServer.lua). The plugin should be loaded by V-REP at start-up: v_repExtBlueZero.dll, libv_repExtBlueZero.dylib or libv_repExtBlueZero.so. The plugin project files are located here. Instructions on how to enabled the remote API on the server side are given here.

  • Recommended topics

  • Enabling the B0-based remote API - client side
  • Enabling the B0-based remote API - server side
  • B0-based remote API modus operandi
  • B0-based remote API function list