startSession

Start a session in the SDK. Applications which want to record several user's drives as a session may use this call. All drives (automatically detected or manually started) when a session is in progress will be tagged with the session id. If a drive is already on when this call is made, that drive will not belong to this session. This session id will be made available in the reports and API that Fairmatic provides.

The application must call stopSession when it wants to end the session.

Only one session may be active at a time. Calling startSession when a session is already active will terminate the ongoing session and start a new one with the given id.

Return

  • the result of the startSession operation.

Parameters

sessionId
  • an identifier that identifies this session uniquely. It may not be null or an empty string. It may not be longer than 64 characters. Passing invalid sessionId is a no-op.