startNewSession(...)

By default, a mobile session will end, and new activity will automatically start a new session, after 5 minutes of inactivity. The StartNewSession call may be useful on a shared device with rapid turnover between users. Separating the sessions can make it easier to review individual user's activity, and create metrics based on session activity that assumes a single user journey.

This function will both end the current session, and initialize a new session. The new session will have no connection to the previous one. This is best used for shared devices with multiple users, where you want to understand separate user behavior across different sessions.

A typical use case would involve calling startNewSession after the event that should force end the session, such as logout or the end of a transaction. The next customer to use the device would have a separate session.

// startNewSession(handler: ((Bool) -> Void)? = nil)

SDK.startNewSession()

Changing Settings During StartNewSession Call

By default, the next session will initialize using the same parameters from the most recent init() call. This means configurations such as privacy settings will remain the same.

If you do wish to change the behavior of initialization settings after StartNewSession is called, you can choose to pass in new initialization parameters that will used to initialize the new session (see the init() call for more details). For example:

// startNewSession(configuration: Configuration, handler: ((Bool) -> Void)? = nil)

let configuration = Configuration(
  appID: appID,
  serverURL: serverURL,
  allowTags: ["allowedButton"],
  redactionTags: ["hiddenButton2"],
  inputRedactionTags: ["privateInput"],
  textSanitizer: .none
  //etc...
)

SDK.startNewSession(configuration: configuration)

Completion Handler Closure

startNewSession runs its internal steps asynchronously and optionally allows you to pass in a completion handler closure. This closure will run after the process to shut down the current session and initialize the new one completes. The boolean passed into the closure will be true if the new session was initialized successfully, or false otherwise.

// startNewSession(handler: ((Bool) -> Void)? = nil)

SDK.startNewSession(
  handler: { (success: Bool) in
    if success {
      let recordingID = SDK.getRecordingIDWithSessionID()
      NSLog("LogRocket: SDK re-initialized with new ID " + (recordingID ?? "UNKNOWN"))
    } else {
      NSLog("LogRocket: SDK re-initialization failed")
    }
  }
)

🚧

Avoid waiting in the main UI thread for the startNewSession completion handler closure to complete

Due to the need for the shutdown process to wait on various actions to complete successfully before returning, please ensure that if you wait for the startNewSession completion handler closure to run you are doing so off of the main UI thread so that rendering is not blocked and the user experience is not negatively impacted.