Pokročilé API
Kdy jej použít
Pro běžnou hru použijte managed API: jolt_start(), managed objekty, jolt_update() a jolt_stop(). Raw vrstvu volte při záměrné potřebě izolovaného explicitního světa nebo přímého řízení bridge. Automaticky nedodává managed registry, propojení instancí ani životní cyklus helperů.
| API | Chování |
|---|---|
| Managed constructor | Vrací wrapper nebo undefined; výchozí svět je implicitní. |
| Raw constructor | Obvykle vrací číselný handle > 0 nebo nulu při chybě; svět zadáváte explicitně. |
| Private __jolt_* helpers | Implementační detaily, nikoliv podporované herní rozhraní. |
Ověřené kontrakty operací#
Následující kontrakty rozlišují jednotky, návratové hodnoty, chyby a životnost podle aktuální implementace. Nevynechávej kontrolu výsledku: false, 0 a undefined mohou mít u různých metod odlišný význam.
| Symbol / vlastník | Signatura | Kontrakt operace |
|---|---|---|
| jolt_api_version | jolt_api_version() | Číselná verze transportního API DLL, nikoliv verze asset JSON. Nízkoúrovňová cesta používá číselné handles; scalar při chybě vrací 0 a nastaví jolt_get_last_error_code/message. Nula může být i platná hodnota, chybový stav čti ihned. |
| jolt_default_world | jolt_default_world() | Čte managed stav bez kroku fyziky: Boolean started / handle světa / fixed_dt s / kumulativní počet kroků / počet valid wrapperů těles. Počet wrapperů není kontrola všech native handles. |