Lifecycle and Recording

SDK setup (on application start)

The best place to setup the SDK is in deviceready callback:

if(document.readyState === "complete") {
  document.addEventListener("deviceready", onDeviceReady, false);

function onDeviceReady() {
    Smartlook.setProjectKey({key: "API_KEY"});

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 in the Smartlook app.

Smartlook.setProjectKey({key: "API_KEY"});

Starting and stopping recordings

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


When a user closes your app, the user session automatically stops recording. You don't need to call the stop() method 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 are 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:


function successCallback(isRecording: boolean) {
	console.log('Smartlook recording:' + isRecording);


Why isn't the SDK recording?

You can see why your SDK is not recording by calling Smartlook.getRecordingStatus(successCallback: (recordingStatus: RecordingStatus) => void). 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:


Session URL

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


function successCallback(sessionUrl: string) {
	console.log('Smartlook recording:' + isRecording);


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 Listener

A listener can be registered to listen to the session URL changes.

// A callback function that gets called when the session URL changes.
function urlChangedCallback(sessionUrl: string) {
  console.log('Emitted session url', sessionUrl);

  sessionUrlChangedCallback: urlChangedCallback