startAppHidden

Command

Starts the application in the background

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.

Puts a running BeNav in the background, or keeps it there. Useful when the client application wants navigation prepared and running (route computed, guidance active, notifications flowing) while the driver keeps looking at the client application's own screen.

Worth knowing

Like showApp, it cannot start a stopped application; a command that arrives while BeNav is down is refused with -7 application.not.started.
On a cold start the application appears briefly before hiding itself.

Command#

text

{
  "jsonrpc": "2.0",
  "method": "startAppHidden",
  "id": "1"
}

Response#

Success#

text

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

Error#

Generic errors.

Note: you'll still see the application pop briefly before hiding itself immediately.