Lifecycle & Recording

SDK instance

A Smartlook SDK instance is instantiated during the application process creation and is available during the entire application run.

let smartlookInstance = Smartlook.instance

The Smartlook instance is used to access all SDK functions and fields.

Project key

Your unique project key is needed for the SDK to upload and process the recordings. You can find your project key in the mobile project settings on the Smartlook Dashboard.

Smartlook.instance.preferences.projectKey = "YOUR PROJECT KEY"

Starting and stopping recordings

Recordings can be started or stopped at any time. Multiple subsequent start() or stop() calls will be ignored.

Smartlook.instance.start()
Smartlook.instance.stop()

When a user closes your app, the user session automatically stops recording. You don't need to use the stopRecording() call when the user stops using your app.

📘

Recording start and project key

User sessions can be recorded even if you haven't set the project key. Recorded data is saved but not sent. Once you set the project key, the data is sent.

Checking if the SDK is recording

To see if the SDK is recording:

Smartlook.instance.state.status == .recording

📘

Why isn't the SDK recording?

You can see why your SDK is not recordings by calling status. For more information on possible reasons the SDK is not recording and status, see Status.

Opening a new session

You can close the current session and start a new session:

Smartlook.instance.user.session.openNew()

Session URL

The URL of the currently recorded session can be obtained with or without timestamp:

let sessionURL = Smartlook.instance.user.session.url
let sessionURLWithTimestamp = Smartlook.instance.user.session.urlWithTimestamp

🚧

Nullability and shareability

URLs are only available when the SDK is able to "communicate" with the Smartlook backend. Otherwise, they are null.

URLs are not publicly sharable and login to the dashboard is mandatory before opening these.

Session Notification

A notification can be observed to listen to the session URL changes.

NotificationCenter.default.addObserver(forName: Session.urlDidChangeNotification, object: nil, queue: nil) { note in
   // Called when session URL changes
 }

When Session.urlDidChangeNotification is posted both session url and urlWithTimestamp are present.