corvengine sdk manual

Adding CorvEngine to your Unity Project

Copy the CorvEngine folder into your project's Assets/ directory:

Compatible with Unity 2021.3 LTS, 2022.3 LTS, and Unity 6+ across Built-in, URP, and HDRP render pipelines.

Configuring Your Game in Unity Editor

You never need to hardcode game keys or URLs in C# scripts. Open the built-in configuration window:

Core In-Game Telemetry Calls

All tracking calls are asynchronous, non-blocking, and thread-safe. App ID and platform metadata are attached automatically:

using System.Collections.Generic;
using UnityEngine;
using CorvEngine.SDK;

public class LevelManager : MonoBehaviour
{
    void Start()
    {
        // 1. Start a Level / Zone / Quest
        CorvEngine.StartLevel("Sunny Meadow 01", new Dictionary<string, object>
        {
            { "difficulty", "cozy" },
            { "target_items", 15 }
        });
    }

    public void OnPlayerCollectedDebris(string itemId, int count)
    {
        // 2. Track Cozy Cleanup / Collectible Progress
        CorvEngine.LogItemCollected(itemId, count, "debris");
    }

    public void OnPlayerStuck(string checkpointId)
    {
        // 3. Track Friction / Bottleneck Point
        CorvEngine.TrackFrictionPoint(
            "Sunny Meadow 01",
            checkpointId,
            FrictionReason.PuzzleTimeout,
            timeSpentSeconds: 120f,
            attemptCount: 3,
            playerPosition: transform.position,
            details: "Player could not locate valve"
        );
    }

    public void OnLevelFinished(float cleanScore)
    {
        // 4. Complete Level with score and duration
        CorvEngine.LogLevelCompleted("Sunny Meadow 01", cleanScore, hintsUsed: 0, durationSeconds: 48);

        // 5. Optional: Immediate buffer flush before scene transition
        CorvEngine.Flush();
    }
}

Zero-Config Crash Logging

CorvEngine automatically subscribes to Application.logMessageReceived. Uncaught fatal exceptions, NullPointerExceptions, out-of-memory errors, and native stack traces are captured with full GPU, OS, and memory metrics, streaming directly to BigQuery's crashes_raw table.