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)
- Download Smartlook Android Unity SDK v1.8.7.
- Put
AAR
file toAssets/Plugins/Android
in your Unity project. - 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.
- Add Smartlook in your app’s
build.gradle
:
implementation 'com.smartlook.recording:app:1.8.7-unity-lite-support'
- Add Smartlook Maven repository in your projects
build.gradle
:
allprojects {
repositories {
maven {
url "https://sdk.smartlook.com/android/release"
}
}
}
- In case you are missing some of the dependencies, feel free to add:
implementation 'org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.3.61'
- Get a Unity bridge from our Github repository.
iOS
- Download Smartlook iOS Unity SDK v1.5.0.
- Unzip the archive and put
SmartlookUnity.framework
toAssets/Plugins/iOS
in your Unity project. - 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