SDK Installation

Currently the minimal supported Android version is Jelly Bean (API 18), however video is recorded only for API 24+, analytics events and functionalities are not limited.

Minimal supported Unity version is 2019.1.

Installation

Android (AAR)

1. Download Smartlook Android Unity SDK v1.8.7.
2. Put AAR file to Assets/Plugins/Android in your Unity project.
3. Get a Unity bridge from our Github repository.

Android (Gradle)

In case there is a conflict with other libraries, we also released a lite version of the SDK. This solution however needs to be implemented via gradle of the app itself. Steps are described below. Flow is similar to integration of our native SDK.

1. Add Smartlook in your app’s build.gradle:

implementation 'com.smartlook.recording:app:1.8.7-unity-lite-support'

2. Add Smartlook Maven repository in your projects build.gradle:

allprojects {
  repositories {
    maven {
      url "https://sdk.smartlook.com/android/release"
    }
  }
}

3. In case you are missing some of the dependencies, feel free to add:

implementation 'org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.3.61'

4. Get a Unity bridge from our Github repository.

iOS

1. Download Smartlook iOS Unity SDK v1.5.0.
2. Unzip the archive and put SmartlookUnity.framework to Assets/Plugins/iOS in your Unity project.
3. Get a Unity bridge from our Github repository.

Setup and Start Recording

To start recording (or just to setup the SDK), you can use i.e.:

public class NewBehaviourScript : MonoBehaviour
{
    // Start is called before the first frame update
    void Start()
    {
        SmartlookUnity.SetupOptionsBuilder builder = new SmartlookUnity.SetupOptionsBuilder("API_KEY");
        SmartlookUnity.Smartlook.SetupAndStartRecording(builder.Build());
    }

    // Update is called once per frame
    void Update()
    {
        ...
    }
}

📘

API Key

To setup Smartlook, the unique project API Key is needed. It can be found in the mobile project settings in the Smartlook Dashboard.

📘

Recording when on mobile network

SDK will upload sessions only on WiFi. When uploading on mobile connections is requested, too, it must be enabled in the project settings in the dashboard. More details about the recording process can be found in the Conceptual documentation