BeNav5RNC API
Android

joinCircuit

Command

Used to join manually when the vehicle is back on the circuit but too far from where he left it.

Send this JSON-RPC message in the BND_MESSAGE extra of an Intent with the action ACTION_RNC_BROADCAST, to BeNav's activity or receiver: see Sending commands.

Used to join manually when the vehicle is back on the circuit but too far from where he left it.
Can only be called when the notification onCanJoinCircuit is received with the percentage.

Command#

json
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "joinCircuit"
}

Responses#

Success#

json
{
    "id": "1",
    "result": {},
    "jsonrpc": "2.0"
}

Error#

Possible error codes:

  • NOT_IN_GUIDANCE: if circuit navigation is not started
  • UNABLE_TO_JOIN_CIRCUIT: if the navigation is not a "Circuit", or not in "Free Drive" or if the driver is not actually on the circuit.
json
{
  "jsonrpc": "2.0",
  "error": {
    "code": 1,
    "message": "UNABLE_TO_JOIN_CIRCUIT"
  },
  "id": "1"
}