Skip to content

README.md

Latest commit

 

History

History
86 lines (66 loc) · 5.79 KB

README.md

File metadata and controls

86 lines (66 loc) · 5.79 KB
Raw

SGG PerfMeter

Diagnostica runtime leggera e profiling leggibile dagli agenti per Unity 6 URP+HDRP (FPS meter).

English | Русский | Deutsch | Español | Français | Italiano | 日本語 | 한국어 | Português (Brasil) | 简体中文

Installazione | Avvio Rapido | Workflow | API | MCP | Confronto | Limitazioni | Risoluzione Problemi

SGG PerfMeter landing screenshot

SGG PerfMeter identifica i colli di bottiglia dei frame, confronta le variazioni di prestazioni, registra sessioni riproducibili e fornisce dati di profiling strutturati a strumenti e AI agent.

Perche Aiuta

  • Mostra il contesto dei colli di bottiglia direttamente durante il gioco.
  • Permette di passare tra preset, grafici, barre metriche, layout compatti e righe di metriche personalizzate.
  • Registra sessioni di profiling riproducibili con warm-up, ambito scena, riepilogo dei frame peggiori ed esportazione JSON/CSV.
  • Coordina RenderDoc/PIX tramite il percorso generico Unity oppure usa facoltativamente il bridge RenderDoc distribuito separatamente e verificato con SHA-256 per artefatti .rdc autenticati nell'Editor Windows x64 con D3D11, D3D12 o Vulkan. Il pacchetto UPM resta senza binari e non installa RenderDoc.
  • Usa alert, log strutturati, callback e cooldown degli avvisi Editor senza dover osservare sempre l'overlay.
  • Fornisce a strumenti e agent dati strutturati per confronti, test A/B e ricerca degli hotspot.

Cosa Viene Misurato

  • Stato runtime di Unity 6000.4+ / URP 17.4+ Render Graph e HDRP 17.4+ Custom Pass.
  • Timing CPU/GPU di FrameTimingManager: CPU frame, main thread, render thread, present wait e GPU frame time quando disponibile.
  • Contatori di rendering ProfilerRecorder: draw calls, SetPass, batches, vertices, SRP Batcher, BRG/GRD, uploads, memory e GPU memory quando disponibile.
  • Classificazione del collo di bottiglia per GPU, CPU main, CPU render, present/VSync, balanced o unknown.
  • Opt-in overdraw measurement e overdraw heatmap visiva tramite URP Render Graph; in HDRP overdraw/heatmap non sono supportati, mentre i core diagnostics restano disponibili.
  • Snapshot di device, URP/HDRP camera, render integration, status, metrics, alerts, sessions e custom metrics per codice e automazione MCP.

Telemetria di piattaforma opzionale

PerfMeter puo raccogliere segnali opzionali di thermal e Adaptive Performance tramite un provider. La core assembly non ha una hard dependency su com.unity.adaptiveperformance; l'assembly opzionale SGG.PerfMeter.AdaptivePerformance si attiva per Unity 6000.4+ quando com.unity.adaptiveperformance e alla versione 5.1.0+.

  • API del provider: PerformanceMeter.RegisterPlatformTelemetryProvider(...), UnregisterPlatformTelemetryProvider(...) e GetPlatformTelemetry() consentono al massimo un provider attivo e restituiscono l'immutabile PerfMeterPlatformTelemetrySnapshot con ID/versione del provider, tempi di sample/cambiamento, thermal warning, temperature level/trend, CPU/GPU performance levels, adaptive bottleneck e disponibilita per campo. Un secondo provider diverso viene rifiutato.
  • Raccolta ed export: il core usa una cadenza limitata di 0,25 secondi e uno snapshot in cache con metadati last attempt/result, eta del last success e freshness. Una capture boundary forza un tentativo senza nascondere Unavailable. JSON/CSV della sessione e capture samples conservano lo snapshot e la provenienza del provider. Il comando MCP perfmeter.platform.telemetry espone lo snapshot strutturato corrente.
  • Profiler e alert: SGG.PerfMeter.Thermal.Sample e SGG.PerfMeter.Thermal.Available espongono il marker di raccolta termica e il counter di disponibilita. L'alert predefinito thermal.throttling usa la metrica ThermalWarningLevel quando e disponibile un livello di throttling imminente o attivo.
  • L'indisponibilita e esplicita: provider e campi non supportati restano unavailable; JSON serializza i valori numerici non disponibili come null e CSV usa campi vuoti, con flag di disponibilita invece di zeri fittizi. La validazione del package Adaptive Performance reale e dei dispositivi target resta un gate della release matrix/release candidate; questo README non dichiara alcun risultato su dispositivo.

Avvio Rapido

  1. Installa il pacchetto Unity da npm registry o Git UPM.
  2. Apri SGG/Perfmeter/Setup in Unity.
  3. Esegui il setup consigliato, avvia Play Mode e verifica che l'overlay appaia.
{
  "scopedRegistries": [
    {
      "name": "npmjs",
      "url": "https://registry.npmjs.org",
      "scopes": [
        "com.sungeargames"
      ]
    }
  ],
  "dependencies": {
    "com.sungeargames.perfmeter": "2026.8.13-2"
  }
}

Documentazione

Licenza

Il pacchetto e concesso in licenza con Stinger Royalty-Free EULA 1.0.