Installation & Setup
How to import the Nx10 SDK into your Unity project and manage your environments.
1. Import via Unity Package Manager
The SDK is distributed as a standard Unity Package. To install it:
- Open your Unity project.
- Go to Window > Package Manager.
- Click the + icon in the top left corner.
- Select Add package from git URL...
- Enter the repository URL provided by the Nx10 team (e.g.,
https://github.com/affectstack/Nx10-unity-sdk.git) and click Add.
2. Environment Management (API Keys)
When you sign up for Nx10, your Organisation is equipped with Deployments in the Control Plane. It is highly recommended to create at least two Deployments: one for Staging (testing/development) and one for Production.
The Nx10 Unity SDK provides a dedicated configuration window to safely manage these API keys without hardcoding them into your scripts. This ensures your development builds automatically send telemetry to your staging environment, keeping your production data clean.

- Navigate to Window > Nx10 > Configuration in the top menu bar.
- Paste your Staging Key and Production Key into the respective fields.
- Under Environment Routing, set the dropdowns to automatically route data based on the build type. For example, set
Unity EditorandDevelopment Buildsto route to Staging, andRelease Buildsto route to Production. - Click Apply Changes. The SDK will securely store these preferences and inject the correct key at runtime.
3. Scene Setup
The Nx10 Manager acts as a singleton. You do not need to attach it to a prefab or add it manually to any scenes. Calling Nx10Manager.Instance.StartSession() will automatically read your configured API keys, bootstrap the necessary hidden GameObjects to capture touch and sensor data, and mark them as DontDestroyOnLoad.
